Skip to main content
POST
Create a saved record for a document

Authorizations

Authorization
string
header
required

Short-lived, Developer-API-audience token obtained by the trusted MCP service through token exchange (mcp_at_...). Raw MCP resource tokens are rejected.

Path Parameters

documentId
string
required

Body

application/json
label
string

Human-readable record label, e.g. customer or case name.

Example:

"Acme GmbH - Angebot Juli 2026"

documentVersionId
string

Document version to pin this record to. Defaults to latest version when available.

variableValues
object

Variable values used to fill the document.

Example:
sourceUploads
object[]

Optional upload/source references used to create the record. Kept as structured metadata.

metadata
object

Additional metadata, e.g. origin flow, assistant job, notes.

Response

201 - application/json
id
string
required
orgId
string
required
documentId
string
required
label
string
required
status
enum<string>
required
Available options:
DRAFT,
READY,
ARCHIVED
variableValues
object
required
sourceUploads
object[]
required
metadata
object
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
documentVersionId
object
createdByUserId
object
exports
object[]