Skip to main content
POST
Create an immutable artifact title and/or content 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

Body

application/json

Provide an exact expected revision and at least one of title or content. Content-only requests keep the legacy response shape; requests containing title 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

Response

Revision created. Title-aware requests also return the updated artifact metadata.

revision
object
required
artifact
object