Skip to main content
GET
/
v1
/
agent-deployments
/
{deployment_id}
/
versions
List agent deployment versions
import requests

url = "https://api.13-215-85-171.sslip.io/v1/agent-deployments/{deployment_id}/versions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
{
  "items": [
    {
      "id": "adpv_1234abcd",
      "deployment_id": "<string>",
      "version_number": 2,
      "bundle_digest": "<string>",
      "bundle_manifest": {
        "bundle_digest": "<string>",
        "config_digest": "<string>",
        "archive_format": "tar",
        "total_size": 1,
        "file_count": 1,
        "generated_at": "2023-11-07T05:31:56Z",
        "materialization_path": "/workspace/project",
        "entries": [
          {
            "path": "<string>",
            "included": true,
            "reason": "<string>",
            "size": 1,
            "mode": 123,
            "digest": "<string>",
            "symlink_target": "<string>"
          }
        ],
        "include_patterns": [
          "<string>"
        ],
        "exclude_patterns": [
          "<string>"
        ],
        "default_exclude_patterns": [
          "<string>"
        ]
      },
      "config": {
        "name": "<string>",
        "template": "<string>",
        "workdir": "<string>",
        "entrypoint": "<string>",
        "env": {
          "required": [
            "<string>"
          ],
          "optional": [
            "<string>"
          ]
        },
        "resources": {
          "vcpus": 2,
          "memory_mb": 2,
          "disk_mb": 2,
          "timeout_seconds": 2
        },
        "service": {
          "port": 32768,
          "readiness": {
            "path": "<string>",
            "timeout_seconds": 1
          }
        },
        "debug": {
          "retain_on_failure": true,
          "retain_seconds": 2
        },
        "install": "<string>",
        "permissions": {
          "internet_access": true,
          "allow_out": [
            "<string>"
          ],
          "deny_out": [
            "<string>"
          ],
          "public_url": true,
          "allow_public_traffic": true,
          "volumes": true,
          "desktop": true,
          "pty": true,
          "debug": true,
          "retain_on_failure": true,
          "max_vcpus": 2,
          "max_memory_mb": 2,
          "max_disk_mb": 2,
          "max_timeout_seconds": 2
        },
        "outputs": {
          "paths": [
            "<string>"
          ]
        }
      },
      "template": "<string>",
      "workdir": "<string>",
      "entrypoint_command": "<string>",
      "env_spec": {
        "required": [
          "<string>"
        ],
        "optional": [
          "<string>"
        ]
      },
      "resource_config": {
        "vcpus": 2,
        "memory_mb": 2,
        "disk_mb": 2,
        "timeout_seconds": 2
      },
      "debug_config": {
        "retain_on_failure": true,
        "retain_seconds": 2
      },
      "created_at": "2023-11-07T05:31:56Z",
      "install_command": "<string>",
      "service_port": 32768,
      "readiness_config": {
        "path": "<string>",
        "timeout_seconds": 1
      },
      "cache_summary": {
        "enabled": true,
        "artifact_ready": true,
        "reason": "<string>",
        "build_id": "<string>",
        "cache_key_digest": "sha256:abc123",
        "artifact_id": "<string>",
        "updated_at": "2023-11-07T05:31:56Z"
      },
      "build_summary": {
        "build_id": "adpb_1234abcd",
        "artifact_ready": true,
        "artifact_id": "<string>",
        "size_bytes": 1,
        "failure_reason": "<string>",
        "started_at": "2023-11-07T05:31:56Z",
        "completed_at": "2023-11-07T05:31:56Z"
      },
      "failure_reason": "<string>",
      "ready_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Path Parameters

deployment_id
string
required

Agent deployment ID

Query Parameters

status
enum<string>
Available options:
created,
building,
ready,
failed,
superseded
limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string

Response

Agent deployment versions

items
object[]
required
next_cursor
string | null