Skip to main content
POST
Create an immutable artifact title, content, or source revision

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required
artifactId
string<uuid>
required

Query Parameters

projection
enum<string>

Opt in to revision.source_reference. Omission preserves the default response. Unknown or duplicate values return 400.

Available options:
source_provenance_v1

Body

application/json

Provide an exact expected revision and at least one of title, content, or source. An effective no-op is rejected. Requests containing title or source also return updated artifact metadata.

title
string
required
Required string length: 1 - 200
expected_revision_id
string<uuid>
required
content
string

Markdown or HTML source; the server enforces a 256 KiB UTF-8 limit before sanitization.

Required string length: 1 - 262144
content_format
enum<string>
default:markdown
Available options:
markdown,
html
expected_revision_number
integer
Required range: x >= 1

Omit to inherit, UUID to set or replace from a live matching link, null to clear. Historical snapshots remain immutable.

Response

Revision created. Requests containing title or source also return the updated artifact metadata.

revision
object
required
artifact
object