Skip to main content
POST
Create an artifact and immutable revision 1

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

Body

application/json
type
enum<string>
required
Available options:
prd,
implementation_plan,
test_plan,
decision,
research,
release_checklist
title
string
required

Artifact title; the server enforces a 200-byte UTF-8 limit.

Required string length: 1 - 200
content
string
required

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
Maximum array length: 20

Response

Artifact created atomically

artifact
object
required
revision
object
required