Haijun Platform Docs
ID

List Deployment Runs

GET /v1/deployment_runs

List Deployment Runs

Query parameters

  • "created_at[gt]": optional string

Return runs created strictly after this time (exclusive).

format: date-time

  • "created_at[gte]": optional string

Return runs created at or after this time (inclusive).

format: date-time

  • "created_at[lt]": optional string

Return runs created strictly before this time (exclusive).

format: date-time

  • "created_at[lte]": optional string

Return runs created at or before this time (inclusive).

format: date-time

  • deployment_id: optional string

Filter to a specific deployment. Omit to list across all deployments in the workspace. Filtering by a non-existent deployment_id returns 200 with empty data.

  • has_error: optional boolean

Filter: true for runs with non-null error, false for runs with non-null session_id. Omit for all.

  • limit: optional number

Maximum results per page. Default 20, maximum 1000.

format: int32

  • page: optional string

Opaque pagination cursor. Pass next_page from the previous response. Invalid or expired cursors return 400.

  • trigger_type: optional BetaManagedAgentsTriggerType

Filter runs by what triggered them. Omit to return all runs.

  • "schedule"

The run was fired by the deployment's cron schedule.

  • "manual"

The run was started manually by creating a session directly against the deployment.

Headers

  • "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

  • string
  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
  • "message-batches-2024-09-24"
  • "prompt-caching-2024-07-31"
  • "computer-use-2024-10-22"
  • "computer-use-2025-01-24"
  • "pdfs-2024-09-25"
  • "token-counting-2024-11-01"
  • "token-efficient-tools-2025-02-19"
  • "output-128k-2025-02-19"
  • "files-api-2025-04-14"
  • "mcp-client-2025-04-04"
  • "mcp-client-2025-11-20"
  • "dev-full-thinking-2025-05-14"
  • "interleaved-thinking-2025-05-14"
  • "code-execution-2025-05-22"
  • "extended-cache-ttl-2025-04-11"
  • "context-1m-2025-08-07"
  • "context-management-2025-06-27"
  • "model-context-window-exceeded-2025-08-26"
  • "tracks-2025-10-02"
  • "fast-mode-2026-02-01"
  • "output-300k-2026-03-24"
  • "user-profiles-2026-03-24"
  • "user-profiles-2026-08-18"
  • "user-profiles-2026-09-04"
  • "advisor-tool-2026-03-01"
  • "managed-agents-2026-04-01"
  • "cache-diagnosis-2026-04-07"
  • "dreaming-2026-04-21"
  • "thinking-token-count-2026-05-13"
  • "server-side-fallback-2026-06-01"
  • "server-side-fallback-2026-07-01"
  • "fallback-credit-2026-06-01"
  • "fallback-credit-2026-07-01"
  • "agent-memory-2026-07-22"
  • "mid-conversation-tool-changes-2026-07-01"
  • "compact-2026-01-12"
  • "computer-use-2025-11-24"
  • "mcp-tunnels-2026-06-22"
  • "structured-outputs-2025-11-13"
  • "task-budgets-2026-03-13"
  • "thinking-display-updates-2026-08-18"
  • "ce-user-management-2026-07-13"
  • "mid-conversation-output-config-2026-07-01"
  • "thinking-binding-controls-2026-08-01"
  • "mid-conversation-system-clear-at-2026-08-21"
  • "compact-2026-09-04"
  • "inline-tools-2026-09-15"
  • "mcp-client-2026-09-15"
  • "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

  • data: array of BetaManagedAgentsDeploymentRun

List of deployment runs.

  • type: "deployment_run"
  • id: string

Unique identifier for this run (drun_...).

  • agent: BetaManagedAgentsAgentReference

Snapshot of the agent at fire time. Always fully resolved — deployments pin agent + version.

  • type: "agent"
  • id: string
  • version: number

format: int32

  • created_at: string

Time this run record was persisted.

format: date-time

  • deployment_id: string

ID of the deployment that produced this run.

  • error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 more or null

Populated on creation failure. Null on success. Exactly one of session_id or error is non-null.

  • BetaManagedAgentsEnvironmentArchivedRunError object

The deployment's environment was archived.

  • type: "environment_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsAgentArchivedRunError object

The deployment's agent was archived.

  • type: "agent_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsEnvironmentNotFoundRunError object

The deployment's environment no longer exists.

  • type: "environment_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsVaultNotFoundRunError object

A vault referenced by the deployment no longer exists.

  • type: "vault_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsVaultArchivedRunError object

A vault referenced by the deployment is archived.

  • type: "vault_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsFileNotFoundRunError object

A file resource referenced by the deployment no longer exists.

  • type: "file_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsMemoryStoreArchivedRunError object

A memory store referenced by the deployment is archived.

  • type: "memory_store_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSkillNotFoundRunError object

A track referenced by the deployment's agent no longer exists.

  • type: "skill_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionResourceNotFoundRunError object

A referenced resource no longer exists and its kind was not reported.

  • type: "session_resource_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsWorkspaceArchivedRunError object

The deployment's workspace was archived.

  • type: "workspace_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsOrganizationDisabledRunError object

The deployment's organization is disabled.

  • type: "organization_disabled_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionRateLimitedRunError object

Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.

  • type: "session_rate_limited_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionCreationRejectedRunError object

The session create request was rejected with a non-retryable validation error.

  • type: "session_creation_rejected_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsUnknownRunError object

An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.

  • type: "unknown_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object

The deployment configures resources, but its environment is self-hosted and cannot mount them.

  • type: "self_hosted_resources_unsupported_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsMCPEgressBlockedRunError object

An MCP server host used by the deployment's agent is blocked by the environment's network policy.

  • type: "mcp_egress_blocked_error"
  • message: string

Human-readable error description.

  • session_id: string or null

Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.

  • trigger_context: BetaManagedAgentsTriggerContext

What triggered this run and trigger-specific metadata.

  • BetaManagedAgentsScheduleTriggerContext object

The run was fired by the deployment's cron schedule.

  • type: "schedule"
  • scheduled_at: string

The UTC instant at which the cron expression matched in the configured timezone, before jitter is applied. At most one run is recorded per (deployment_id, scheduled_at) pair.

format: date-time

  • BetaManagedAgentsManualTriggerContext object

The run was started manually by creating a session directly against the deployment.

  • type: "manual"
  • next_page: optional string or null

Opaque cursor for the next page. Null when no more results.

Example

bash
curl https://haijun.my.id/v1/deployment_runs \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

Response (200)

json
{
  "data": [
    {
      "id": "id",
      "agent": {
        "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
        "type": "agent",
        "version": 1
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "deployment_id": "deployment_id",
      "error": {
        "message": "message",
        "type": "environment_archived_error"
      },
      "session_id": "session_id",
      "trigger_context": {
        "scheduled_at": "2019-12-27T18:11:19.117Z",
        "type": "schedule"
      },
      "type": "deployment_run"
    }
  ],
  "next_page": "next_page"
}

Get Deployment Run

GET /v1/deployment_runs/{deployment_run_id}

Get Deployment Run

Path parameters

  • deployment_run_id: string

Unique identifier of the deployment run.

Headers

  • "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

  • string
  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
  • "message-batches-2024-09-24"
  • "prompt-caching-2024-07-31"
  • "computer-use-2024-10-22"
  • "computer-use-2025-01-24"
  • "pdfs-2024-09-25"
  • "token-counting-2024-11-01"
  • "token-efficient-tools-2025-02-19"
  • "output-128k-2025-02-19"
  • "files-api-2025-04-14"
  • "mcp-client-2025-04-04"
  • "mcp-client-2025-11-20"
  • "dev-full-thinking-2025-05-14"
  • "interleaved-thinking-2025-05-14"
  • "code-execution-2025-05-22"
  • "extended-cache-ttl-2025-04-11"
  • "context-1m-2025-08-07"
  • "context-management-2025-06-27"
  • "model-context-window-exceeded-2025-08-26"
  • "tracks-2025-10-02"
  • "fast-mode-2026-02-01"
  • "output-300k-2026-03-24"
  • "user-profiles-2026-03-24"
  • "user-profiles-2026-08-18"
  • "user-profiles-2026-09-04"
  • "advisor-tool-2026-03-01"
  • "managed-agents-2026-04-01"
  • "cache-diagnosis-2026-04-07"
  • "dreaming-2026-04-21"
  • "thinking-token-count-2026-05-13"
  • "server-side-fallback-2026-06-01"
  • "server-side-fallback-2026-07-01"
  • "fallback-credit-2026-06-01"
  • "fallback-credit-2026-07-01"
  • "agent-memory-2026-07-22"
  • "mid-conversation-tool-changes-2026-07-01"
  • "compact-2026-01-12"
  • "computer-use-2025-11-24"
  • "mcp-tunnels-2026-06-22"
  • "structured-outputs-2025-11-13"
  • "task-budgets-2026-03-13"
  • "thinking-display-updates-2026-08-18"
  • "ce-user-management-2026-07-13"
  • "mid-conversation-output-config-2026-07-01"
  • "thinking-binding-controls-2026-08-01"
  • "mid-conversation-system-clear-at-2026-08-21"
  • "compact-2026-09-04"
  • "inline-tools-2026-09-15"
  • "mcp-client-2026-09-15"
  • "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

  • BetaManagedAgentsDeploymentRun object

A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.

  • type: "deployment_run"
  • id: string

Unique identifier for this run (drun_...).

  • agent: BetaManagedAgentsAgentReference

Snapshot of the agent at fire time. Always fully resolved — deployments pin agent + version.

  • type: "agent"
  • id: string
  • version: number

format: int32

  • created_at: string

Time this run record was persisted.

format: date-time

  • deployment_id: string

ID of the deployment that produced this run.

  • error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 more or null

Populated on creation failure. Null on success. Exactly one of session_id or error is non-null.

  • BetaManagedAgentsEnvironmentArchivedRunError object

The deployment's environment was archived.

  • type: "environment_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsAgentArchivedRunError object

The deployment's agent was archived.

  • type: "agent_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsEnvironmentNotFoundRunError object

The deployment's environment no longer exists.

  • type: "environment_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsVaultNotFoundRunError object

A vault referenced by the deployment no longer exists.

  • type: "vault_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsVaultArchivedRunError object

A vault referenced by the deployment is archived.

  • type: "vault_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsFileNotFoundRunError object

A file resource referenced by the deployment no longer exists.

  • type: "file_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsMemoryStoreArchivedRunError object

A memory store referenced by the deployment is archived.

  • type: "memory_store_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSkillNotFoundRunError object

A track referenced by the deployment's agent no longer exists.

  • type: "skill_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionResourceNotFoundRunError object

A referenced resource no longer exists and its kind was not reported.

  • type: "session_resource_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsWorkspaceArchivedRunError object

The deployment's workspace was archived.

  • type: "workspace_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsOrganizationDisabledRunError object

The deployment's organization is disabled.

  • type: "organization_disabled_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionRateLimitedRunError object

Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.

  • type: "session_rate_limited_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionCreationRejectedRunError object

The session create request was rejected with a non-retryable validation error.

  • type: "session_creation_rejected_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsUnknownRunError object

An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.

  • type: "unknown_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object

The deployment configures resources, but its environment is self-hosted and cannot mount them.

  • type: "self_hosted_resources_unsupported_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsMCPEgressBlockedRunError object

An MCP server host used by the deployment's agent is blocked by the environment's network policy.

  • type: "mcp_egress_blocked_error"
  • message: string

Human-readable error description.

  • session_id: string or null

Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.

  • trigger_context: BetaManagedAgentsTriggerContext

What triggered this run and trigger-specific metadata.

  • BetaManagedAgentsScheduleTriggerContext object

The run was fired by the deployment's cron schedule.

  • type: "schedule"
  • scheduled_at: string

The UTC instant at which the cron expression matched in the configured timezone, before jitter is applied. At most one run is recorded per (deployment_id, scheduled_at) pair.

format: date-time

  • BetaManagedAgentsManualTriggerContext object

The run was started manually by creating a session directly against the deployment.

  • type: "manual"

Example

bash
curl https://haijun.my.id/v1/deployment_runs/$DEPLOYMENT_RUN_ID \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

Response (200)

json
{
  "id": "id",
  "agent": {
    "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
    "type": "agent",
    "version": 1
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "deployment_id": "deployment_id",
  "error": {
    "message": "message",
    "type": "environment_archived_error"
  },
  "session_id": "session_id",
  "trigger_context": {
    "scheduled_at": "2019-12-27T18:11:19.117Z",
    "type": "schedule"
  },
  "type": "deployment_run"
}

Domain types

Beta Managed Agents Agent Archived Run Error

  • BetaManagedAgentsAgentArchivedRunError object

The deployment's agent was archived.

  • type: "agent_archived_error"
  • message: string

Human-readable error description.

Beta Managed Agents Deployment Run

  • BetaManagedAgentsDeploymentRun object

A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.

  • type: "deployment_run"
  • id: string

Unique identifier for this run (drun_...).

  • agent: BetaManagedAgentsAgentReference

Snapshot of the agent at fire time. Always fully resolved — deployments pin agent + version.

  • type: "agent"
  • id: string
  • version: number

format: int32

  • created_at: string

Time this run record was persisted.

format: date-time

  • deployment_id: string

ID of the deployment that produced this run.

  • error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 more or null

Populated on creation failure. Null on success. Exactly one of session_id or error is non-null.

  • BetaManagedAgentsEnvironmentArchivedRunError object

The deployment's environment was archived.

  • type: "environment_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsAgentArchivedRunError object

The deployment's agent was archived.

  • type: "agent_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsEnvironmentNotFoundRunError object

The deployment's environment no longer exists.

  • type: "environment_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsVaultNotFoundRunError object

A vault referenced by the deployment no longer exists.

  • type: "vault_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsVaultArchivedRunError object

A vault referenced by the deployment is archived.

  • type: "vault_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsFileNotFoundRunError object

A file resource referenced by the deployment no longer exists.

  • type: "file_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsMemoryStoreArchivedRunError object

A memory store referenced by the deployment is archived.

  • type: "memory_store_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSkillNotFoundRunError object

A track referenced by the deployment's agent no longer exists.

  • type: "skill_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionResourceNotFoundRunError object

A referenced resource no longer exists and its kind was not reported.

  • type: "session_resource_not_found_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsWorkspaceArchivedRunError object

The deployment's workspace was archived.

  • type: "workspace_archived_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsOrganizationDisabledRunError object

The deployment's organization is disabled.

  • type: "organization_disabled_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionRateLimitedRunError object

Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.

  • type: "session_rate_limited_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSessionCreationRejectedRunError object

The session create request was rejected with a non-retryable validation error.

  • type: "session_creation_rejected_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsUnknownRunError object

An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.

  • type: "unknown_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object

The deployment configures resources, but its environment is self-hosted and cannot mount them.

  • type: "self_hosted_resources_unsupported_error"
  • message: string

Human-readable error description.

  • BetaManagedAgentsMCPEgressBlockedRunError object

An MCP server host used by the deployment's agent is blocked by the environment's network policy.

  • type: "mcp_egress_blocked_error"
  • message: string

Human-readable error description.

  • session_id: string or null

Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.

  • trigger_context: BetaManagedAgentsTriggerContext

What triggered this run and trigger-specific metadata.

  • BetaManagedAgentsScheduleTriggerContext object

The run was fired by the deployment's cron schedule.

  • type: "schedule"
  • scheduled_at: string

The UTC instant at which the cron expression matched in the configured timezone, before jitter is applied. At most one run is recorded per (deployment_id, scheduled_at) pair.

format: date-time

  • BetaManagedAgentsManualTriggerContext object

The run was started manually by creating a session directly against the deployment.

  • type: "manual"

Beta Managed Agents Environment Archived Run Error

  • BetaManagedAgentsEnvironmentArchivedRunError object

The deployment's environment was archived.

  • type: "environment_archived_error"
  • message: string

Human-readable error description.

Beta Managed Agents Environment Not Found Run Error

  • BetaManagedAgentsEnvironmentNotFoundRunError object

The deployment's environment no longer exists.

  • type: "environment_not_found_error"
  • message: string

Human-readable error description.

Beta Managed Agents File Not Found Run Error

  • BetaManagedAgentsFileNotFoundRunError object

A file resource referenced by the deployment no longer exists.

  • type: "file_not_found_error"
  • message: string

Human-readable error description.

Beta Managed Agents Manual Trigger Context

  • BetaManagedAgentsManualTriggerContext object

The run was started manually by creating a session directly against the deployment.

  • type: "manual"

Beta Managed Agents MCP Egress Blocked Run Error

  • BetaManagedAgentsMCPEgressBlockedRunError object

An MCP server host used by the deployment's agent is blocked by the environment's network policy.

  • type: "mcp_egress_blocked_error"
  • message: string

Human-readable error description.

Beta Managed Agents Memory Store Archived Run Error

  • BetaManagedAgentsMemoryStoreArchivedRunError object

A memory store referenced by the deployment is archived.

  • type: "memory_store_archived_error"
  • message: string

Human-readable error description.

Beta Managed Agents Organization Disabled Run Error

  • BetaManagedAgentsOrganizationDisabledRunError object

The deployment's organization is disabled.

  • type: "organization_disabled_error"
  • message: string

Human-readable error description.

Beta Managed Agents Schedule Trigger Context

  • BetaManagedAgentsScheduleTriggerContext object

The run was fired by the deployment's cron schedule.

  • type: "schedule"
  • scheduled_at: string

The UTC instant at which the cron expression matched in the configured timezone, before jitter is applied. At most one run is recorded per (deployment_id, scheduled_at) pair.

format: date-time

Beta Managed Agents Self Hosted Resources Unsupported Run Error

  • BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object

The deployment configures resources, but its environment is self-hosted and cannot mount them.

  • type: "self_hosted_resources_unsupported_error"
  • message: string

Human-readable error description.

Beta Managed Agents Session Creation Rejected Run Error

  • BetaManagedAgentsSessionCreationRejectedRunError object

The session create request was rejected with a non-retryable validation error.

  • type: "session_creation_rejected_error"
  • message: string

Human-readable error description.

Beta Managed Agents Session Rate Limited Run Error

  • BetaManagedAgentsSessionRateLimitedRunError object

Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.

  • type: "session_rate_limited_error"
  • message: string

Human-readable error description.

Beta Managed Agents Session Resource Not Found Run Error

  • BetaManagedAgentsSessionResourceNotFoundRunError object

A referenced resource no longer exists and its kind was not reported.

  • type: "session_resource_not_found_error"
  • message: string

Human-readable error description.

Beta Managed Agents Track Not Found Run Error

  • BetaManagedAgentsSkillNotFoundRunError object

A track referenced by the deployment's agent no longer exists.

  • type: "skill_not_found_error"
  • message: string

Human-readable error description.

Beta Managed Agents Trigger Context

  • BetaManagedAgentsTriggerContext = BetaManagedAgentsScheduleTriggerContext or BetaManagedAgentsManualTriggerContext

Describes what triggered a deployment run, with trigger-specific metadata.

  • BetaManagedAgentsScheduleTriggerContext object

The run was fired by the deployment's cron schedule.

  • type: "schedule"
  • scheduled_at: string

The UTC instant at which the cron expression matched in the configured timezone, before jitter is applied. At most one run is recorded per (deployment_id, scheduled_at) pair.

format: date-time

  • BetaManagedAgentsManualTriggerContext object

The run was started manually by creating a session directly against the deployment.

  • type: "manual"

Beta Managed Agents Trigger Type

  • BetaManagedAgentsTriggerType = "schedule" or "manual"

What triggered a deployment run.

  • "schedule"

The run was fired by the deployment's cron schedule.

  • "manual"

The run was started manually by creating a session directly against the deployment.

Beta Managed Agents Unknown Run Error

  • BetaManagedAgentsUnknownRunError object

An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.

  • type: "unknown_error"
  • message: string

Human-readable error description.

Beta Managed Agents Vault Archived Run Error

  • BetaManagedAgentsVaultArchivedRunError object

A vault referenced by the deployment is archived.

  • type: "vault_archived_error"
  • message: string

Human-readable error description.

Beta Managed Agents Vault Not Found Run Error

  • BetaManagedAgentsVaultNotFoundRunError object

A vault referenced by the deployment no longer exists.

  • type: "vault_not_found_error"
  • message: string

Human-readable error description.

Beta Managed Agents Workspace Archived Run Error

  • BetaManagedAgentsWorkspaceArchivedRunError object

The deployment's workspace was archived.

  • type: "workspace_archived_error"
  • message: string

Human-readable error description.

On this page
List Deployment RunsQuery parametersHeadersReturnsExampleResponse (200)Get Deployment RunPath parametersHeadersReturnsExampleResponse (200)Domain typesBeta Managed Agents Agent Archived Run ErrorBeta Managed Agents Deployment RunBeta Managed Agents Environment Archived Run ErrorBeta Managed Agents Environment Not Found Run ErrorBeta Managed Agents File Not Found Run ErrorBeta Managed Agents Manual Trigger ContextBeta Managed Agents MCP Egress Blocked Run ErrorBeta Managed Agents Memory Store Archived Run ErrorBeta Managed Agents Organization Disabled Run ErrorBeta Managed Agents Schedule Trigger ContextBeta Managed Agents Self Hosted Resources Unsupported Run ErrorBeta Managed Agents Session Creation Rejected Run ErrorBeta Managed Agents Session Rate Limited Run ErrorBeta Managed Agents Session Resource Not Found Run ErrorBeta Managed Agents Track Not Found Run ErrorBeta Managed Agents Trigger ContextBeta Managed Agents Trigger TypeBeta Managed Agents Unknown Run ErrorBeta Managed Agents Vault Archived Run ErrorBeta Managed Agents Vault Not Found Run ErrorBeta Managed Agents Workspace Archived Run Error