SPspice
Deployments

Get a deployment

The org is orgId in the path. Returns a single deployment for the specified project. The body matches one item from GET /v1/projects/{projectId}/deployments. Not cacheable. Poll this path for stored status after POST create.

get/v1/orgs/{orgId}/projects/{projectId}/deployments/{deploymentId}

Request

  • Base URL
    https://api.spice.ai
  • Auth
    HTTP bearer

Path parameters

orgIdinteger required

The org id from GET /v1/orgs

projectIdinteger required

The ID of the project

deploymentIdinteger required

The ID of the deployment

Headers

X-Org-Namestring

When present, X-Org-Name must name the same org as orgId. Otherwise the request returns org_path_mismatch (400).

Response

Deployment

idinteger

Unique identifier for the deployment

status'queued' | 'in_progress' | 'succeeded' | 'failed' | 'created'

Current status of the deployment

created_atstring date-time

Timestamp when the deployment was created

updated_atstring date-time nullable

Timestamp when the deployment was last updated

image_tagstring nullable

Runtime image tag used for this deployment

replicasinteger

Number of replicas

branchstring nullable

Git branch name

commit_shastring nullable

Git commit SHA

commit_messagestring nullable

Git commit message

error_codestring nullable

Set with error_message on failed and on in_progress while Cloud is retrying a scheduling block. Null on succeeded, on ordinary waiting in_progress, and on writers that predated this column. Older failed rows may still have a message with a null code.

error_messagestring nullable

Catalog copy for the current error_code. Older failed rows may still have a message with a null error_code.

creation_sourcestring nullable

Source that triggered the deployment

created_byinteger nullable

User ID who created the deployment

Changes

No recorded changes to this operation across all 1 revision of this API.