Skip to main content
GET /v1/deployments
Returns the deployments owned by your API key, newest first.

​
Request

curl "https://api.prismagents.com/v1/deployments?customer_id=cus_123&limit=20" \
  -H "Authorization: Bearer $PRISM_API_KEY"

​
Query parameters

ParameterTypeRequiredDescription
customer_idstringNoFilter to a single customer’s deployments
statusstringNoFilter by status: provisioning, ready, or error
limitintegerNoPage size, from 1 to 100. Defaults to 20
cursorstringNoPagination cursor from a previous response

​
Response

{
  "data": [
    {
      "deployment_id": "dep_7xK9s2",
      "customer_id": "cus_123",
      "name": "Acme Creative Agent",
      "runtime": "hermes",
      "status": "ready",
      "model": "anthropic/claude-sonnet-4.5",
      "created_at": "2026-06-11T18:21:09Z"
    }
  ],
  "next_cursor": null
}

​
Response fields

FieldTypeDescription
data[]object[]Deployment summaries — see Get Deployment
next_cursorstring or nullPass as cursor to fetch the next page; null when done

​
Errors

StatusErrorWhen
400validation_errorInvalid query parameters
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks deployments:read scope
See Errors for the full error reference.