List artifacts
/api/v1/artifactsList ready run files visible in the active organization.
Use search for a case-insensitive filename or description match, and visibility to narrow the result to private or organization-shared files.
can_delete is caller-specific. A false value means the file can still be downloaded or attached to another run but cannot be removed by this credential.
Required access
Credentials: service principal, delegated token, user session
Scope: runs:list
Returns ready artifacts visible to the caller in the active organization. Private artifacts are visible only to their owner or a direct organization admin; service principals never receive private 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
Query Parameters
1 <= value <= 100500 <= value0Header 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
curl -X GET "https://example.com/api/v1/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": "inline", "file_name": "string", "media_type": "string", "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", "can_delete": true } ], "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"}