---
title: "Record a source artifact: a document, page, message or transcript a claim came from."
method: POST
path: "/context/artifacts"
---

# Record a source artifact: a document, page, message or transcript a claim came from.

`POST /context/artifacts`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/context/artifacts`
- Auth: HTTP bearer

Capability: evidence:append. Immutable once written. `kind` is persisted faithfully and is never coerced; an unsupported kind returns 400 invalid_artifact_type. `sessionId` is persisted as the artifact's session link and echoed back; an unresolvable sessionId fails the write instead of being dropped.

## Request body

- object
  - `sessionId` string
  - `kind` 'conversation' | 'document' | 'email' | 'transcript' | 'webpage' | 'spreadsheet' | 'image' | 'note' | 'dataset' | 'other'
  - `title` string
  - `uri` string
  - `excerpt` string
  - `capturedAt` string
  - `metadata` object

## Response `200`

Artifact recorded

- object

## Other responses

- `208`: Idempotent replay of a previous request with the same Idempotency-Key. Nothing was applied again.
- `400`: Invalid or unrecognised field
- `404`: Session not found in this workspace

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)