Deployments.ai Docs
Agents

List agent deployments

GET /v1/agent-deployments · SDK listAgentDeployments · CLI deployments deployment list

GET
/v1/agent-deployments

Authorization

platformBearer
headerAuthorizationBearer <token>

Platform bearer credential accepted as an opaque API key or JWT.

Query Parameters

cursor?string
Length1 <= length <= 4096
limit?integer
Range1 <= value <= 100

Header Parameters

x-deployments-environment*string
Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Response Body

ListAgentDeploymentsResponse

application/json
  1. response
items*array<>
nextCursor?|null|null
curl -X GET "https://example.com/v1/agent-deployments" \  -H "x-deployments-environment: string"
{  "items": [    {      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "version": 0,      "environmentId": "string",      "organizationId": "string",      "projectId": "string",      "agentDefinitionId": "string",      "agentReleaseId": "string",      "candidateAgentReleaseId": "string",      "candidateStartedAt": "2019-08-24T14:15:22Z",      "candidateWeight": 1,      "currentState": "deploying",      "desiredState": "paused",      "id": "string",      "lastTransitionAt": "2019-08-24T14:15:22Z",      "runtimeConfig": {        "agentBindings": {},        "apiVersion": "agents.deployments.ai/v1",        "brainRetrievalMode": "brain-first",        "kind": "AgentDeploymentConfig",        "toolAuthorizations": {}      }    }  ],  "nextCursor": "string"}