Artifacts
Documents generated in conversations, saved as versioned artifacts.
List versions of an artifact
Returns one page of up to 50 versions, newest first. With `grouped=1` the page comes wrapped with autosave sessions and the total version count; `before` requests the window of versions strictly older than the given version number, and `pinnedVersion` forces a published version into the first page.
Create or update an artifact
When `artifact.id` matches an existing artifact it is updated (as a draft when `draft` is true), honouring an optional `If-Match` version precondition; otherwise a new artifact is created in the application collection.
Delete an artifact
A soft delete: the document backing the artifact is marked ARCHIVED, which hides the artifact from listings and lookups. Failures answer 500 with `{ success: false, error }` instead of the standard error shape.
Export an artifact to a collection as a document
Renders the selected artifact version (`version`, latest when omitted) as a PDF file and saves it as a new document in the destination collection, which requires write permission. The document then goes through the regular ingestion pipeline. Failure responses are plain-text bodies.