Skip to main content
POST
Propose immutable content changes without publishing

Authorizations

Authorization
string
header
required

Use a workspace API key in the Authorization header. Keys use pk_live_<key_id> for production and pk_test<key_id>_ for test mode.

Headers

Idempotency-Key
string
required
Required string length: 8 - 128

Path Parameters

id
string
required

Body

application/json
expectedRevision
integer<int64>
required
Required range: x >= 1
content
object
required

Response

Saved proposal or authorized retry, with a credential-free relative review URL. No article was published.

kind
enum<string>
Available options:
update,
create
articleSetId
string
articleSetName
string
newArticle
object | null
id
string
articleId
string
status
enum<string>
Available options:
pending,
approved,
dismissed
baseRevision
integer<int64>
currentRevision
integer<int64> | null
content
object
reviewUrl
string
publicationChanged
boolean