> ## 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. # Delete and tear down a deployment > Delete an agent deployment and tear down its Kubernetes resources. Deletes the deployment's Kubernetes resources first, then marks the record as `DELETED`; the underlying Helm release is subsequently uninstalled asynchronously by FluxCD once the resource is removed. If the Kubernetes teardown fails, the record is left unchanged and the call errors, so the delete can be safely retried. Rejects the call with a client error if the deployment is already in a terminal state (`DELETED`, `CANCELLED`, or `SUPERSEDED`) — a `SUPERSEDED` record shares its Helm release with the deployment that replaced it, so deleting it would tear down the live release. Returns 404 if no deployment with this ID exists for the caller's account. This removes a running deployment, not the image build behind it, which is managed separately through the agentex builds API. ## OpenAPI ````yaml https://api.sgp.scale.com/openapi-versions/v5/openapi.json delete /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}: delete: tags: - Agentex Cloud Deploy summary: Delete and tear down a deployment description: >- Delete an agent deployment and tear down its Kubernetes resources. Deletes the deployment's Kubernetes resources first, then marks the record as `DELETED`; the underlying Helm release is subsequently uninstalled asynchronously by FluxCD once the resource is removed. If the Kubernetes teardown fails, the record is left unchanged and the call errors, so the delete can be safely retried. Rejects the call with a client error if the deployment is already in a terminal state (`DELETED`, `CANCELLED`, or `SUPERSEDED`) — a `SUPERSEDED` record shares its Helm release with the deployment that replaced it, so deleting it would tear down the live release. Returns 404 if no deployment with this ID exists for the caller's account. This removes a running deployment, not the image build behind it, which is managed separately through the agentex builds API. operationId: DELETE-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 ````