Upload an agent deployment version bundle
import requests
url = "https://api.13-215-85-171.sslip.io/v1/agent-deployments/{deployment_id}/versions/{version_id}/bundle"
payload = "<string>"
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-Nullspace-Bundle-Digest": "<x-nullspace-bundle-digest>",
"Authorization": "Bearer <token>",
"Content-Type": "application/x-tar"
}
response = requests.put(url, data=payload, headers=headers)
print(response.text)curl --request PUT \
--url https://api.13-215-85-171.sslip.io/v1/agent-deployments/{deployment_id}/versions/{version_id}/bundle \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/x-tar' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Nullspace-Bundle-Digest: <x-nullspace-bundle-digest>' \
--data '<string>'{
"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>",
"kind": "file",
"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>",
"mode": "job",
"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": {
"type": "http",
"kind": "http",
"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
},
"status": "created",
"cache_policy": "auto",
"created_at": "2023-11-07T05:31:56Z",
"install_command": "<string>",
"service_port": 32768,
"readiness_config": {
"type": "http",
"kind": "http",
"path": "<string>",
"timeout_seconds": 1
},
"cache_summary": {
"enabled": true,
"policy": "auto",
"status": "disabled",
"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",
"status": "queued",
"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"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "Missing or invalid bearer credential",
"code": "unauthorized",
"request_id": "req_123"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}Agent Deployments
Upload an agent deployment version bundle
Upload the tar bundle bytes for a created deployment version. A successful upload marks the version ready and activates it for the deployment.
PUT
/
v1
/
agent-deployments
/
{deployment_id}
/
versions
/
{version_id}
/
bundle
Upload an agent deployment version bundle
import requests
url = "https://api.13-215-85-171.sslip.io/v1/agent-deployments/{deployment_id}/versions/{version_id}/bundle"
payload = "<string>"
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-Nullspace-Bundle-Digest": "<x-nullspace-bundle-digest>",
"Authorization": "Bearer <token>",
"Content-Type": "application/x-tar"
}
response = requests.put(url, data=payload, headers=headers)
print(response.text)curl --request PUT \
--url https://api.13-215-85-171.sslip.io/v1/agent-deployments/{deployment_id}/versions/{version_id}/bundle \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/x-tar' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Nullspace-Bundle-Digest: <x-nullspace-bundle-digest>' \
--data '<string>'{
"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>",
"kind": "file",
"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>",
"mode": "job",
"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": {
"type": "http",
"kind": "http",
"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
},
"status": "created",
"cache_policy": "auto",
"created_at": "2023-11-07T05:31:56Z",
"install_command": "<string>",
"service_port": 32768,
"readiness_config": {
"type": "http",
"kind": "http",
"path": "<string>",
"timeout_seconds": 1
},
"cache_summary": {
"enabled": true,
"policy": "auto",
"status": "disabled",
"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",
"status": "queued",
"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"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "Missing or invalid bearer credential",
"code": "unauthorized",
"request_id": "req_123"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}Authorizations
API key passed as Bearer token
Headers
Reuse the same key to safely retry the same create, reusable snapshot create, fork, upload create/complete, or agent deployment create operation without duplicating work.
Content-addressed bundle digest from the version manifest.
Path Parameters
Agent deployment ID
Agent deployment version ID
Body
application/x-tar
The body is of type file.
Response
Agent deployment version is ready
Example:
"adpv_1234abcd"
Required range:
x >= 1Show child attributes
Show child attributes
Show child attributes
Show child attributes
Environment variable names only. Secret values must not be stored in deployment config rows.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Debug retention config for agent deployments. The server validates that only retain_on_failure and retain_seconds are accepted when a deployment version is created.
Show child attributes
Show child attributes
Available options:
created, building, ready, failed, superseded Available options:
auto, no_cache, rebuild Required range:
1 <= x <= 65535Service readiness probe config, validated on write (type one of http, tcp, timeout; path must start with /). Unknown keys are preserved verbatim, so the object is deliberately open beyond the known fields.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes