AgentexCloudDeploy

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/scale-ai/json-schema/scale-ai-agentex-cloud-deploy-schema.json",
  "title": "AgentexCloudDeploy",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/scale-ai-agentex-cloud-deploy-api-openapi.yml#/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": "#/$defs/Identity",
      "description": "The identity that created the entity."
    },
    "deploy_events": {
      "items": {
        "$ref": "#/$defs/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"
  ],
  "$defs": {
    "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."
    },
    "Identity": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id"
        },
        "object": {
          "type": "string",
          "const": "identity",
          "title": "Object",
          "default": "identity"
        },
        "type": {
          "$ref": "#/$defs/IdentityType"
        }
      },
      "type": "object",
      "required": [
        "id",
        "type"
      ],
      "title": "Identity"
    },
    "IdentityType": {
      "type": "string",
      "enum": [
        "user",
        "service_account"
      ],
      "title": "IdentityType"
    }
  }
}