API Reference

Find the Spice Cloud Runtime APIs for SQL, search, and AI, and the Management API that manages projects and infrastructure.

The Spice Cloud Platform exposes two sets of APIs: Runtime APIs for querying data and AI, and the Management API for managing projects and infrastructure.

Runtime APIs

Runtime APIs are served at https://data.spiceai.io and authenticated with Project API keys.

APIEndpointDocumentation
SQL Query (HTTP)POST /v1/sqlHTTP API
SQL Query (Arrow Flight)grpc+tls://flight.spiceai.ioArrow Flight API
ModelsGET /v1/modelsModels
Chat completionsPOST /v1/chat/completionsChat Completions
ResponsesPOST /v1/responsesResponses
DecisionsPOST /v1/decisionsDecisions
Text-to-SQLPOST /v1/nsqlText-to-SQL API
Text-to-SQL contextGET /v1/nsql/contextText-to-SQL API
SearchPOST /v1/searchSearch API
MCPPOST /v1/mcpMCP API
HealthGET /healthHealth API
MetricsGET /v1/metricsMetrics API

Management API

The Management API is served at https://api.spice.ai and authenticated with Personal Access Tokens or OAuth client credentials.

EndpointDocumentation
ProjectsProjects API
DeploymentsDeployments API
SecretsSecrets API
API KeysAPI Keys API
MembersMembers API
RegionsRegions API
Container ImagesContainer Images API
HealthHealth API

See the full Management API reference for authentication, scopes, rate limits, and examples.

OpenAPI Specification

The Spice.ai Platform API spec is available at:

https://api.spice.ai/v1/docs/openapi.json