> ## Documentation Index > Fetch the complete documentation index at: https://docs.trajectory.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Agent Deployments ## OpenAPI ````yaml /openapi.json get /api/v1/agents/{agent_id}/deployments openapi: 3.1.0 info: title: Trajectory API version: 0.1.0 x-trajectory-api-version: '2026-10-14' description: >- This contract is API version 2026-10-14. The optional Trajectory-API-Version header pins it, and tmp-contract is accepted as an alias. Requests without the header get this version. Version 2026-10-07 and the pre-launch legacy response formats are retired. servers: - url: https://api.trajectory.ai security: [] tags: - name: agents x-group: Agents - name: benchmarks x-group: Specs (benchmarks) - name: diagnostics x-group: Diagnostics - name: benchmark-ingestion x-group: Spec (benchmark) submissions - name: eval x-group: Evaluations - name: training x-group: Training - name: deployments x-group: Deployments - name: model-endpoints x-group: Model endpoints - name: inference x-group: Inference - name: trajectories x-group: Trajectories - name: artifacts x-group: Artifacts - name: telemetry x-group: Telemetry - name: supported-models x-group: Supported models - name: organizations x-group: Organizations - name: secrets x-group: Secrets paths: /api/v1/agents/{agent_id}/deployments: get: tags: - agents summary: List Agent Deployments operationId: listAgentDeployments parameters: - name: agent_id in: path required: true schema: type: string title: Agent Id - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 25 title: Limit - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' title: Cursor - name: status in: query required: false schema: anyOf: - type: string - type: 'null' title: Status responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_Deployment_' '404': description: >- The requested resource does not exist or is not visible to the caller. headers: X-Request-ID: $ref: '#/components/headers/RequestId' Trajectory-Should-Retry: $ref: '#/components/headers/TrajectoryShouldRetry' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundErrorResponse' default: $ref: '#/components/responses/ApiErrorResponse' security: - ApiKeyAuth: [] components: schemas: PaginatedResponse_Deployment_: properties: items: items: $ref: '#/components/schemas/Deployment' type: array title: Items next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor has_more: type: boolean title: Has More type: object required: - items - has_more title: PaginatedResponse[Deployment] ResourceNotFoundErrorResponse: properties: error: $ref: '#/components/schemas/ResourceNotFoundErrorBody' type: object required: - error title: ResourceNotFoundErrorResponse Deployment: properties: deployment_id: type: string title: Deployment Id description: Unique identifier of the deployment. agent_id: anyOf: - type: string - type: 'null' title: Agent Id description: Owning agent; null for unassigned legacy deployments. production_model_slug: anyOf: - type: string - type: 'null' title: Production Model Slug description: The owning agent production model slug; null until configured. agent_name: anyOf: - type: string - type: 'null' title: Agent Name description: Owning agent display name; null for a deleted agent. test_model_slug: type: string title: Test Model Slug description: Exact test model slug owned by this deployment. model_slug_id: type: string title: Model Slug Id description: ID of this deployment test model slug row. status: $ref: '#/components/schemas/DeploymentLifecycleStatus' description: Deployment lifecycle state. role: $ref: '#/components/schemas/DeploymentRole' description: Whether this is the production or a test deployment. is_active: type: boolean title: Is Active description: True when this deployment currently answers for the slug. checkpoint_id: type: string title: Checkpoint Id description: Trajectory checkpoint selected when the deployment was created. model_endpoint_id: anyOf: - type: string - type: 'null' title: Model Endpoint Id description: Model Endpoint serving this deployment. base_model_slug: type: string title: Base Model Slug description: Base model used for the checkpoint, when available. checkpoint_step: type: integer title: Checkpoint Step description: Training step of the source checkpoint. created_by: anyOf: - type: string - type: 'null' title: Created By description: Email of the user who requested this deployment. completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At description: >- When the deployment first became DEPLOYED; unlike updated_at, later promote/demote transitions never overwrite this. created_at: type: string format: date-time title: Created At description: When the deployment was requested. updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At description: Last lifecycle transition; null until the row first moves. failure: anyOf: - $ref: '#/components/schemas/AsyncFailure' - type: 'null' description: Structured failure when status is FAILED. type: object required: - deployment_id - test_model_slug - model_slug_id - status - role - is_active - checkpoint_id - base_model_slug - checkpoint_step - created_at title: Deployment description: >- A model deployment’s lifecycle, serving configuration, and endpoint details. ResourceNotFoundErrorBody: properties: type: type: string const: invalid_request_error title: Type code: type: string const: resource_not_found title: Code message: type: string title: Message param: anyOf: - type: string - type: 'null' title: Param doc_url: type: string title: Doc Url context: $ref: '#/components/schemas/EmptyErrorContext' type: object required: - type - code - message - doc_url - context title: ResourceNotFoundErrorBody ApiErrorEnvelope: properties: error: $ref: '#/components/schemas/ApiErrorBody' required: - error title: ApiErrorEnvelope type: object DeploymentLifecycleStatus: type: string enum: - PENDING - DEPLOYING - DEPLOYED - FAILED - CANCELLING - CANCELLED title: DeploymentLifecycleStatus description: The deployment’s preparation or serving state. DeploymentRole: type: string enum: - production - test title: DeploymentRole AsyncFailure: properties: type: type: string title: Type description: Stable category used for exception mapping. code: type: string title: Code description: Stable programmatic reason for the asynchronous failure. message: type: string title: Message description: Human-readable explanation for this failure occurrence. context: additionalProperties: true type: object title: Context description: Machine-readable values specific to this failure code. type: object required: - type - code - message title: AsyncFailure EmptyErrorContext: properties: {} additionalProperties: false type: object title: EmptyErrorContext ApiErrorBody: properties: type: $ref: '#/components/schemas/ErrorType' code: type: string title: Code message: type: string title: Message param: anyOf: - type: string - type: 'null' default: null title: Param doc_url: type: string title: Doc Url context: additionalProperties: true title: Context type: object required: - type - code - message - doc_url - context title: ApiErrorBody type: object ErrorType: enum: - invalid_request_error - authentication_error - permission_error - conflict_error - billing_error - rate_limit_error - dependency_error - api_error title: ErrorType type: string headers: RequestId: schema: type: string TrajectoryShouldRetry: schema: type: boolean RetryAfter: schema: type: string responses: ApiErrorResponse: description: >- Common API error. Possible codes: `authentication_required`, `permission_denied`, `validation_error`, `rate_limited`, `internal_error`, `service_unavailable`. headers: X-Request-ID: $ref: '#/components/headers/RequestId' Trajectory-Should-Retry: $ref: '#/components/headers/TrajectoryShouldRetry' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: Organization API key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.