> ## Documentation Index > Fetch the complete documentation index at: https://docs.gp.scale.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an agent deployment > Get a single agent deployment by ID, including its current status and Kubernetes events. Returns the deployment record with its latest status and the associated Kubernetes events (`deploy_events`) observed for the release, which are useful for diagnosing why a deployment is still pending or unhealthy. Poll this after `POST /v5/agentex/deployments` to track the asynchronous deploy to completion. For the incremental log output rather than status and events, use `GET /v5/agentex/deployments/{deployment_id}/logs`. Returns 404 if no deployment with this ID exists for the caller's account. ## OpenAPI ````yaml https://api.sgp.scale.com/openapi-versions/v5/openapi.json get /v5/agentex/deployments/{deployment_id} openapi: 3.1.0 info: title: EGP API V5 description: >- This is the parent API for all EGP APIs. If you are looking for the EGP API, please go to https://api.egp.scale.com/docs. contact: name: Scale Generative AI Platform url: https://scale.com/genai-platform version: 0.1.0 servers: - url: https://api.egp.scale.com security: [] paths: /v5/agentex/deployments/{deployment_id}: get: tags: - Agentex Cloud Deploy summary: Get an agent deployment description: >- Get a single agent deployment by ID, including its current status and Kubernetes events. Returns the deployment record with its latest status and the associated Kubernetes events (`deploy_events`) observed for the release, which are useful for diagnosing why a deployment is still pending or unhealthy. Poll this after `POST /v5/agentex/deployments` to track the asynchronous deploy to completion. For the incremental log output rather than status and events, use `GET /v5/agentex/deployments/{deployment_id}/logs`. Returns 404 if no deployment with this ID exists for the caller's account. operationId: GET-V5-/agentex/deployments/deployment_id parameters: - name: deployment_id in: path required: true schema: type: string title: Deployment Id - name: x-selected-account-id in: header required: false schema: anyOf: - type: string - type: 'null' title: Account ID Header responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AgentexCloudDeploy' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: AgentexCloudDeploy: properties: id: type: string title: Id description: The unique identifier of the deployment. object: type: string const: agentex_cloud_deploy title: Object default: agentex_cloud_deploy build_id: title: Build Id description: The build_id of the cloud build that produced the deployed image. type: string namespace: type: string title: Namespace description: Kubernetes namespace where the deployment is deployed. helm_release_name: title: Helm Release Name description: Helm release name after successful deployment. type: string manifest_file: type: string title: Manifest File description: YAML content of manifest configuration. environment_config: type: string title: Environment Config description: >- YAML content of environment configuration from the environment config file. status: type: string title: Status description: >- Deployment status: pending, running, completed, failed, or cancelled. account_id: type: string title: Account Id description: The ID of the account that owns the given entity. expires_at: title: Expires At description: >- When this deployment will be cleaned up. Always set on preview deployments (defaults to 8 hours from creation if the request omits it). Null on non-preview deployments — they have no TTL. type: string format: date-time preview_label: title: Preview Label description: >- Non-unique grouping label for preview deployments. Filter `?preview_label=X&limit=1` returns the latest deploy for the label. Sanitized (lowercase alphanumeric + hyphens) and capped at 30 characters. type: string created_at: type: string format: date-time title: Created At description: The date and time when the entity was created in ISO format. created_by: $ref: '#/components/schemas/Identity' description: The identity that created the entity. deploy_events: items: $ref: '#/components/schemas/AgentexCloudDeployEvent' type: array title: Deploy Events description: Kubernetes events for this deployment. type: object required: - id - namespace - manifest_file - environment_config - status - account_id - created_at - created_by HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Identity: properties: id: type: string title: Id object: type: string const: identity title: Object default: identity type: $ref: '#/components/schemas/IdentityType' type: object required: - id - type title: Identity AgentexCloudDeployEvent: properties: type: title: Type description: Event type, e.g. 'Normal' or 'Warning'. type: string reason: title: Reason description: Short reason, e.g. 'Pulling', 'Scheduled'. type: string message: title: Message description: Full event message. type: string timestamp: title: Timestamp description: When the event was observed. type: string format: date-time type: object title: AgentexCloudDeployEvent description: Slim event representation for the API response. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: title: Error Type type: string input: title: Input ctx: type: object title: Context additionalProperties: true type: object required: - loc - msg - type title: ValidationError IdentityType: type: string enum: - user - service_account title: IdentityType securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````