배포 실행

배포 실행 목록 조회

client.Beta.DeploymentRuns.List(ctx, params) (*PageCursor[BetaManagedAgentsDeploymentRun], error)

GET/v1/deployment_runs

배포 실행 조회

client.Beta.DeploymentRuns.Get(ctx, deploymentRunID, query) (*BetaManagedAgentsDeploymentRun, error)

GET/v1/deployment_runs/{deployment_run_id}

Models

type BetaManagedAgentsAgentArchivedRunError struct { Type: "agent_archived_error"; Message }

The deployment's agent was archived.

Type BetaManagedAgentsAgentArchivedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsDeploymentRun struct { Type: "deployment_run"; ID; Agent; /* 5 more */ }

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

type BetaManagedAgentsEnvironmentArchivedRunError struct { Type: "environment_archived_error"; Message }

The deployment's environment was archived.

Type BetaManagedAgentsEnvironmentArchivedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsEnvironmentNotFoundRunError struct { Type: "environment_not_found_error"; Message }

The deployment's environment no longer exists.

Type BetaManagedAgentsEnvironmentNotFoundRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsFileNotFoundRunError struct { Type: "file_not_found_error"; Message }

A file resource referenced by the deployment no longer exists.

Type BetaManagedAgentsFileNotFoundRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsManualTriggerContext struct { Type: "manual" }

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

Type BetaManagedAgentsManualTriggerContextType

type BetaManagedAgentsMCPEgressBlockedRunError struct { Type: "mcp_egress_blocked_error"; Message }

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

Type BetaManagedAgentsMCPEgressBlockedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsMemoryStoreArchivedRunError struct { Type: "memory_store_archived_error"; Message }

A memory store referenced by the deployment is archived.

Type BetaManagedAgentsMemoryStoreArchivedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsOrganizationDisabledRunError struct { Type: "organization_disabled_error"; Message }

The deployment's organization is disabled.

Type BetaManagedAgentsOrganizationDisabledRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsScheduleTriggerContext struct { Type: "schedule"; ScheduledAt }

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

Type BetaManagedAgentsScheduleTriggerContextType

ScheduledAt Time

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.

formatdate-time

type BetaManagedAgentsSelfHostedResourcesUnsupportedRunError struct { Type: "self_hosted_resources_unsupported_error"; Message }

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

Type BetaManagedAgentsSelfHostedResourcesUnsupportedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsSessionCreationRejectedRunError struct { Type: "session_creation_rejected_error"; Message }

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

Type BetaManagedAgentsSessionCreationRejectedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsSessionRateLimitedRunError struct { Type: "session_rate_limited_error"; Message }

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

Type BetaManagedAgentsSessionRateLimitedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsSessionResourceNotFoundRunError struct { Type: "session_resource_not_found_error"; Message }

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

Type BetaManagedAgentsSessionResourceNotFoundRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsSkillNotFoundRunError struct { Type: "skill_not_found_error"; Message }

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

Type BetaManagedAgentsSkillNotFoundRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsTriggerContextUnion interface{…}

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

One of the following:

type BetaManagedAgentsScheduleTriggerContext struct { Type: "schedule"; ScheduledAt }

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

Type BetaManagedAgentsScheduleTriggerContextType

ScheduledAt Time

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.

formatdate-time

type BetaManagedAgentsManualTriggerContext struct { Type: "manual" }

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

Type BetaManagedAgentsManualTriggerContextType

type BetaManagedAgentsTriggerType string

What triggered a deployment run.

One of the following:

const BetaManagedAgentsTriggerTypeSchedule BetaManagedAgentsTriggerType = "schedule"

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

const BetaManagedAgentsTriggerTypeManual BetaManagedAgentsTriggerType = "manual"

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

type BetaManagedAgentsUnknownRunError struct { Type: "unknown_error"; Message }

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 BetaManagedAgentsUnknownRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsVaultArchivedRunError struct { Type: "vault_archived_error"; Message }

A vault referenced by the deployment is archived.

Type BetaManagedAgentsVaultArchivedRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsVaultNotFoundRunError struct { Type: "vault_not_found_error"; Message }

A vault referenced by the deployment no longer exists.

Type BetaManagedAgentsVaultNotFoundRunErrorType

Message string

Human-readable error description.

type BetaManagedAgentsWorkspaceArchivedRunError struct { Type: "workspace_archived_error"; Message }

The deployment's workspace was archived.

Type BetaManagedAgentsWorkspaceArchivedRunErrorType

Message string

Human-readable error description.