Deployments

List deployments

get

Returns a list of deployments for the specified app, ordered by most recent first.

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth 2.0 access token obtained from the Spice.ai authentication service

Path parameters

appIdintegerRequired

The ID of the app

Query parameters

limitintegerOptional

Maximum number of deployments to return

Default: 20

statusstring · enumOptional

Filter by deployment status

Possible values:

Responses

200

List of deployments

application/json

401

Unauthorized

403

Insufficient scope

404

App not found

get

/v1/apps/{appId}/deployments

HTTPcURLJavaScriptPython

GET /v1/apps/{appId}/deployments HTTP/1.1
Host: api.spice.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "deployments": [
    {
      "id": 1,
      "status": "queued",
      "created_at": "2026-05-07T21:50:41.900Z",
      "started_at": "2026-05-07T21:50:41.900Z",
      "updated_at": "2026-05-07T21:50:41.900Z",
      "image_tag": "text",
      "replicas": 1,
      "branch": "text",
      "commit_sha": "text",
      "commit_message": "text",
      "error_message": "text",
      "creation_source": "text",
      "created_by": "text"
    }
  ]
}

Create a deployment

post

Creates a new deployment for the specified app using its current spicepod configuration. The runtime image is selected based on the app's update channel.

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth 2.0 access token obtained from the Spice.ai authentication service

Path parameters

appIdintegerRequired

The ID of the app

Body

application/json

image_tagstringOptional

Override the runtime image tag for this deployment

channelstring · enumOptional

Update channel that determines the runtime image

Possible values:

replicasinteger · min: 1 · max: 10Optional

Override the number of replicas for this deployment

branchstringOptional

Git branch name

commit_shastringOptional

Git commit SHA

commit_messagestringOptional

Git commit message

debugbooleanOptional

Enable debug mode for this deployment

Responses

202

Deployment created and queued for processing

application/json

400

Invalid request body or app has no spicepod configuration

401

Unauthorized

403

Insufficient scope

404

App not found

409

A deployment is already in progress for this app

422

Organization is not fully configured

500

Internal server error

502

Upstream service failure while provisioning the deployment

post

/v1/apps/{appId}/deployments

HTTPcURLJavaScriptPython

POST /v1/apps/{appId}/deployments HTTP/1.1
Host: api.spice.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "image_tag": "text",
  "channel": "stable",
  "replicas": 1,
  "branch": "text",
  "commit_sha": "text",
  "commit_message": "text",
  "debug": true
}

{
  "id": 1,
  "status": "queued",
  "created_at": "2026-05-07T21:50:41.900Z",
  "started_at": "2026-05-07T21:50:41.900Z",
  "updated_at": "2026-05-07T21:50:41.900Z",
  "image_tag": "text",
  "replicas": 1,
  "branch": "text",
  "commit_sha": "text",
  "commit_message": "text",
  "error_message": "text",
  "creation_source": "text",
  "created_by": "text"
}