Guest Machines
API referenceRuns

List a run's artifacts

GET/api/v1/runs/{run_id}/artifacts

List ready artifacts produced by this run or its completed run tree. Caller uploads supplied as inputs are not reported as produced output.

Required access

Credentials: automation account, delegated token, user session, user API key

User API keys use the owner’s current permissions, subject to any key restrictions. Capability scopes below apply to automation account keys and delegated tokens.

Scope: runs:read

Authorized through the producing run.

Authorization

AuthorizationBearer <token>

A user-owned key prefixed gsmc_uk_, bound to one organization. It follows its owner's current membership, role and resource permissions, optionally restricted to read-only access. No X-Org-Id header is needed; a conflicting organization is rejected. Credential creation, personal connection setup and human attestations require a signed-in session. Runs are private to the calling user; sharing an agent grants access to your own personal memory of it, never to the agent's own memory.

In: header

Path Parameters

run_id*Run Id

Query Parameters

scope?Scope
Default"tree"

Value in

  • "self"
  • "tree"

Header Parameters

X-Org-Id?|

Selects the active organization for a direct user session that has more than one membership. Automation account keys and delegated tokens are each bound to one organization and ignore it.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/runs/0/artifacts" \  -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"
{  "artifacts": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "producer_run_id": 0,      "root_run_id": 0,      "chat_message_id": 0,      "visibility": "org_shared",      "status": "deleted",      "source_kind": "generated",      "file_name": "string",      "media_type": "string",      "download_only": false,      "file_size": 0,      "sha256": "string",      "description": "string",      "is_primary": true,      "metadata": {},      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "total": 0}

Resolve an uncertain tool outcome POST

Record an explicit human decision for a tool request whose external effect could not be confirmed. The run may remain paused while the decision is applied.

List artifacts GET

List immutable files visible to the caller, including both run-produced outputs and caller-uploaded inputs.