Skip to main content
GET /v1/deployments/:deployment_id
Returns the current state of a deployment. Poll this endpoint after Create Deployment until status is ready.

​
Request

curl "https://api.prismagents.com/v1/deployments/dep_7xK9s2" \
  -H "Authorization: Bearer $PRISM_API_KEY"

​
Path parameters

ParameterTypeRequiredDescription
deployment_idstringYesDeployment ID

​
Response

{
  "deployment_id": "dep_7xK9s2",
  "customer_id": "cus_123",
  "name": "Acme Creative Agent",
  "runtime": "hermes",
  "status": "ready",
  "model": "anthropic/claude-sonnet-4.5",
  "thread_id": "thr_default_8a1",
  "filesystem": {
    "workspace_path": "/workspace",
    "persistent": true
  },
  "events": {
    "transport": "sse",
    "url": "https://api.prismagents.com/v1/deployments/dep_7xK9s2/events"
  },
  "created_at": "2026-06-11T18:21:09Z"
}

​
Response fields

FieldTypeDescription
statusstringOne of provisioning, ready, error
thread_idstringDefault thread for Send Message
events.urlstringSSE endpoint for this deployment
created_atstringISO 8601 creation timestamp
Other fields match the Create Deployment response.

​
Errors

StatusErrorWhen
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks deployments:read scope
404not_foundDeployment does not exist
See Errors for the full error reference.