List a run's artifact bindings
/api/v1/runs/{run_id}/artifact-bindingsList safe artifact capabilities held by one authorized run.
The default scope=inputs returns only capabilities consumed by the run. Use scope=all when debugging to include artifacts the run produced or acquired from completed children.
Bindings expose safe provenance and immutable checksum metadata, never storage paths, signed URLs, or internal source-binding IDs.
Required access
Credentials: service principal, delegated token, user session
Scope: runs:read
Authorized through the run holding the bindings. Runs in another organization answer 404 rather than revealing their artifacts.
An organization-owned automation key, prefixed gsmc_sk_. Already bound to one organization, so it needs no X-Org-Id header. It carries no user identity: it never reaches a private resource however it is scoped, and a run it starts has no user for an interactive tool to reach.
In: header
Path Parameters
Query Parameters
"inputs"Value in
- "inputs"
- "all"
Header Parameters
Selects the active organization for a credential that belongs to more than one. Service-principal keys are bound to a single 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/artifact-bindings" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"{ "bindings": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "holder_run_id": 0, "artifact_id": "b7bd6bbb-c7f1-4314-8742-2aeeeece9d12", "source_artifact_id": "68c7ee57-1229-4d3b-bd1c-3836c1d74712", "grant_kind": "api_input", "alias": "string", "file_name": "string", "media_type": "string", "file_size": 0, "sha256": "string", "producer_run_id": 0, "root_run_id": 0, "available": true, "granted_by_run_id": 0, "created_at": "2019-08-24T14:15:22Z", "released_at": "2019-08-24T14:15:22Z" } ], "total": 0}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}