Skip to main content
DELETE
Delete and tear down a deployment

Authorizations

x-api-key
string
header
required

Headers

x-selected-account-id
string | null

Path Parameters

deployment_id
string
required

Response

Successful Response

id
string
required

The unique identifier of the deployment.

namespace
string
required

Kubernetes namespace where the deployment is deployed.

manifest_file
string
required

YAML content of manifest configuration.

environment_config
string
required

YAML content of environment configuration from the environment config file.

status
string
required

Deployment status: pending, running, completed, failed, or cancelled.

account_id
string
required

The ID of the account that owns the given entity.

created_at
string<date-time>
required

The date and time when the entity was created in ISO format.

created_by
Identity · object
required

The identity that created the entity.

object
string
default:agentex_cloud_deploy
Allowed value: "agentex_cloud_deploy"
build_id
string

The build_id of the cloud build that produced the deployed image.

helm_release_name
string

Helm release name after successful deployment.

expires_at
string<date-time>

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.

preview_label
string

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.

deploy_events
AgentexCloudDeployEvent · object[]

Kubernetes events for this deployment.