Skip to main content
PATCH
Error

Authorizations

Authorization
string
header
required

Authorization-code grant with PKCE S256, exact scopes, explicit resource audience and a persisted consent grant. Obtain endpoint URLs from server discovery in the target environment. Refresh tokens remain client-bound.

FlowAuthorization Code
Authorization URL
/oauth/authorize
Token URL
/oauth/token
Refresh URL
/oauth/token
Scopes1
articles:write
Edit allowed local article fields.

Headers

Idempotency-Key
string
required

Opaque client command key of 1 to 128 visible ASCII characters. UUID recommended; reuse only for the same command.

Required string length: 1 - 128
Pattern: ^[!-~]+$

Path Parameters

profile_id
string<uuid>
required

Profile UUID; must be in the grant allowlist and currently accessible to the actor.

id
string<uuid>
required

Resource UUID, scoped by the path profile or persisted operation receipt.

Body

application/json

Local editorial edit only. Media references are not accepted in this command.

slug
string
Required string length: 1 - 500
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
h1_title
string
Required string length: 1 - 500
meta_description
string
Maximum string length: 2000
article_content
string

HTML text without media references.

Maximum string length: 60000

Response

Locally updated article and durable receipt.

data
object
required
meta
object
required