Sign in

Run Deployment Now

post/v1/deployments/{deployment_id}/run?beta=true

Path parameters

deployment_idstring required

Path parameter deployment_id

Headers

anthropic-versionstring
anthropic-betastring
anthropic-workspace-idstring

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.

Response

Successful response (OK)

type'deployment_run' required
idstring required

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

deployment_idstring required

ID of the deployment that produced this run.

session_idstring nullable required

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

created_atstring date-time required

A timestamp in RFC 3339 format

Example response

{
  "agent": {
    "type": "agent",
    "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
    "version": 1
  }
}

Changes