Api / Artifacts

GET/v1/conversations/:id/artifacts/:aid

Auth: tenant — Status: stable

Metadata for one artifact (no content). For the blob, use /raw.

Request

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

Response

200 OK

The ArtifactRecord shape:

{
  "id": 12,
  "tenant_id": 1,
  "conversation_id": 7,
  "path": "output/report.md",
  "sha256": "ad14a...e3",
  "mime_type": "text/markdown",
  "size": 1832,
  "created_at": 1777060001,
  "updated_at": 1777060123
}

Field schemas: Data model → ArtifactRecord.

Failure modes

StatusWhenBody
401Missing / invalid bearer.{"error": "..."}
404Id doesn't exist for this tenant + conversation pair.{"error": "artifact not found"}

See also