API Reference

Spice.ai Cloud Platform API Reference

The Spice.ai 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.

API	Endpoint	Documentation
SQL Query (HTTP)	POST /v1/sql	HTTP API
SQL Query (Arrow Flight)	grpc+tls://flight.spiceai.io	Arrow Flight API
LLM Chat Completions	POST /v1/chat/completions	LLM API
Text-to-SQL	POST /v1/nsql	Text-to-SQL API
Text-to-SQL context	GET /v1/nsql/context	Text-to-SQL API
Search	POST /v1/search	Search API
MCP	POST /v1/mcp	MCP API
Health	GET /health	Health API
Metrics	GET /v1/metrics	Metrics API

Management API

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

Endpoint	Documentation
Projects	Projects API
Deployments	Deployments API
Secrets	Secrets API
API Keys	API Keys API
Members	Members API
Regions	Regions API
Container Images	Container Images API
Health	Health 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