How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Snowflake

Snowflake cortex-analyst API

The cortex-analyst API from Snowflake — 4 operation(s) for cortex-analyst.

Documentation Provider Profile APIs.io OpenAPI GitHub

Snowflake cortex-analyst API is one of 49 APIs that Snowflake publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include cortex-analyst. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 2 JSON Schemas.

This API exposes 9 operations across 9 paths, and defines 42 schemas. It is described by OpenAPI 3.2.0, at version 0.0.1.

Requests are made against a single base URL, https://org-account.snowflakecomputing.com.

9 operations 9 paths 42 schemas 2 GET7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.0.1
Base URL
https://org-account.snowflakecomputing.com
Authentication
custom, custom, custom, custom
Contact
Snowflake, Inc.
Resource Areas
1

Authentication & Security 4

Snowflake cortex-analyst API declares 4 security schemes for authenticating requests. It defines a custom scheme (KeyPair). It defines a custom scheme (ExternalOAuth). It defines a custom scheme (SnowflakeOAuth). It defines a custom scheme (ProgrammaticAccessToken).

Paths & Operations 9

Across 9 paths, the API surfaces 9 operations — 2 GET, 7 POST. Each is listed below with its method, path, parameters, and response codes.

cortex-analyst 9
POST
/api/v2/cortex/analyst/feedback
Send a user feedback of Cortex Analyst response
sendFeedback body → 200400401403404405429500
POST
/api/v2/cortex/analyst/message
Send a Data Question to the Cortex Analyst
sendMessage body → 200400401403404405429500
POST
/api/v2/cortex/analyst/verified-query-suggestions
Generate Vq Suggestions for a Semantic Model
generateVerifiedQuerySuggestions body → 200400401403404405429500
GET
/api/v2/cortex/analyst/token
Internal Endpoint to Exchange a Cortex Analyst Oauth Token
getScopedToken → 200400401403404405429500
POST
/api/v2/cortex/analyst/fast-generation
Rapidly generate a semantic model given source material
fastGeneration body → 200400401403404405429500
POST
/api/v2/cortex/analyst/pre-selection
Retrieve relevant table information from input data for semantic model generation
preSelection body → 200400401403404405429500
POST
/api/v2/cortex/analyst/filters-and-metrics-suggestions
Generate filters, facts, and metrics suggestions for a semantic model
generateFiltersAndMetricsSuggestions body → 200400401403404405429500
POST
/api/v2/cortex/analyst/agentic-optimizations
List all agentic optimization runs for a given base model
listAgenticOptimizations body → 200400401403404405429500
GET
/api/v2/cortex/analyst/agentic-optimization
Get the status and state of a specified agentic optimization run
getAgenticOptimization 1 param → 200400401403404405429500

Schemas 42

The contract defines 42 schemas that model the data the API accepts and returns. The most detailed are SendMessageRequest (10 properties), GenerateFiltersAndMetricsSuggestionsRequest (10 properties), GenerateVerifiedQuerySuggestionsRequest_2 (9 properties), GetAgenticOptimizationResponse (5 properties). Each schema is shown below with its type and property counts.

SemanticModelObject
object
Represents a semantic model object
3 properties
TokenInfo
object
2 properties
Warning
object
Represents a warning within a chat.
1 property
VerifiedQuery
object
VerifiedQuery represents a (question, sql) pair that has been manually verified (e.g. by an analyst) to be correct.
5 properties
GenerateVerifiedQuerySuggestionsRequest
object
The request object for getting VQ suggestions
3 properties 1 required
GenerateVerifiedQuerySuggestionsResponse
object
The non-streaming response object for the VQ Suggestions request
3 properties
SemanticModelSelection
object
2 properties
SendFeedbackRequest
object
The request object for sending user feedback on Cortex Analyst responses
3 properties 2 required
MessageContent
object
1 property
SendMessageRequest
object
The request object for sendMessage requests
10 properties 1 required
VerifiedQuerySuggestion
object
A suggestion to add or remove or replace a Verified Query to a semantic model.
3 properties
MessageObject
object
Represents a message within a chat.
2 properties 1 required
SendMessageResponse
object
The non-streaming response object for the sendMessage
5 properties 1 required
TokenInfo_2
object
2 properties
SemanticModelChangeOperation
string
Operation applied to a semantic object at a given path
AgenticOptimizationStatus
string
The status of an agentic optimization run.
GenerateFiltersAndMetricsSuggestionsRequest
object
The request object for generating filters, facts, and metrics suggestions
10 properties
TableauInput
object
Input required to extract data from Tableau. Tableau Cloud users can optionally provide integration data if files are not already uploaded
2 properties
TdsInput
object
Tableau data source file stage paths
2 properties 1 required
FastGenerationRequest
object
The request for the FastGeneration rpc
1 property
ListAgenticOptimizationsResponse
object
The response from listing agentic optimization runs.
2 properties
StagingData
object
Contains information indicating where to stage data
2 properties 2 required
AnnotatedSqlQuery
object
Contains a SQL query with optional context and natural language annotation
5 properties 1 required
TableauIntegration
object
Contains data on how to connect to Tableau and process data
2 properties 2 required
AgenticOptimizationSummary
object
A summary of an agentic optimization run.
2 properties
GetAgenticOptimizationResponse
object
The status, state, and outcome of a specified agentic optimization run.
5 properties
TableauAuth
object
Authentication required to connect to Tableau
2 properties 2 required
SemanticModelChange
object
A single change to apply to the semantic object
3 properties 2 required
SemanticModelChangeValue
object
One-of value. A map with exactly one key set corresponding to the semantic model object or primitive.
TableauServerFiles
object
Contains Tableau URLs to retrieve files from Tableau server and information around Tableau integration
2 properties
SemanticModelUpdateSuggestion
object
A suggestion consisting of ordered semantic object changes with optional setup SQL and score.
3 properties
TableauStageFiles
object
Specifies stage paths of the Tableau files
1 property
PreSelectionRequest
object
The request for the PreSelection rpc
5 properties 2 required
ListAgenticOptimizationsRequest
object
A request to list all agentic optimization runs for a given base model. Note that only semantic views and semantic model files are supported. Inline semantic m…
2 properties 1 required
GenerateVerifiedQuerySuggestionsRequest_2
object
The request object for getting VQ suggestions
9 properties 1 required
GenerateVerifiedQuerySuggestionsResponse_2
object
The non-streaming response object for the VQ Suggestions request
3 properties
SendFeedbackRequest_2
object
The request object for sending user feedback on Cortex Analyst responses
3 properties 2 required
TableColumns
object
Contains information about table and column names
4 properties 4 required
VerifiedQuerySuggestion_2
object
A suggestion to add or remove or replace a Verified Query to a semantic model.
4 properties
PreSelectionResponse
object
The response for the PreSelection rpc
4 properties
GenerateFiltersAndMetricsSuggestionsResponse
object
The response object for filters, facts, and metrics suggestions
4 properties
SqlInputs
object
Contains SQL queries which may be annotated with natural language
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

snowflake-cortex-analyst-api-openapi.yml Raw ↑

Other APIs Snowflake publishes across the network.

Snowflake Artifact Repository API
AE Profile APIs.io
Cortex Embed API
AE Profile APIs.io
Snowflake Network Rule API
AE Profile APIs.io
Snowflake Password Policy API
AE Profile APIs.io
Snowflake Secret API
AE Profile APIs.io
Snowflake Sequence API
AE Profile APIs.io
Snowflake Spark Connect API
AE Profile APIs.io
Snowflake Streamlit API
AE Profile APIs.io
Snowflake Tag API
AE Profile APIs.io
Cortex Agents API
AE Profile APIs.io
Snowpipe REST API
AE Profile APIs.io
Snowflake account API
AE Profile APIs.io
#cortex-analyst
← Back to S APIs
API Details
ID
snowflake:snowflake-cortex-analyst-api
Base URL
https://org-account.snowflakecomputing.com
Docs
https://docs.snowflake.com/en/developer-guide/snowflake-rest-api/reference/account
Provider
Snowflake
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=snowflake-cortex-analyst-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/snowflake-cortex-analyst-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Snowflake cortex-analyst API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.