Api / Artifacts

GET/v1/artifacts/:aid/raw

Auth: tenant — Status: stable

Tenant-scoped raw content blob with Content-Type + strong ETag. Same semantics as the conversation-scoped variant; cross-tenant ids surface as 404.

Request

Path paramTypeDescription
aidintArtifact id.

Conditional headers

HeaderDescription
If-None-MatchIf the value matches the artifact's ETag, respond 304 with no body.
curl -H "Authorization: Bearer atr_…" \
  -H 'If-None-Match: "ad14a...e3"' \
  http://arbiter.example.com/v1/artifacts/12/raw

Response

200 OK

Raw bytes; headers identical to the conversation-scoped variant. See GET/v1/conversations/:id/artifacts/:aid/raw.

304 Not Modified

When If-None-Match matches.

Failure modes

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

See also