Api / Artifacts

GET/v1/artifacts/:aid

Auth: tenant — Status: stable

Tenant-scoped lookup by artifact id — the conversation id is inferred from the row. Same semantics as the conversation-scoped variant; cross-tenant ids surface as 404 (never 403, to avoid id-existence side channels).

Request

Path paramTypeDescription
aidintArtifact id.
curl -H "Authorization: Bearer atr_…" \
  http://arbiter.example.com/v1/artifacts/12

Response

200 OK

ArtifactRecord (no content). Field schemas: Data model → ArtifactRecord.

Failure modes

StatusWhenBody
401Missing / invalid bearer.{"error": "..."}
404Id doesn't exist or belongs to another tenant.{"error": "artifact not found"}

See also