Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Existing Atlas integration connection with explicit api:connect plus appropriate native domain grants. atlas_ingest_ and browser cookies are not accepted.

Headers

X-Workspace-Id
string<uuid>
required

Selector within saved grants and current issuer authority; never grants authority.

Idempotency-Key
string<uuid>
required

Stable native operation key. Reuse it as request_key through MCP; a changed body under the same key conflicts.

Path Parameters

subjectKind
enum<string>
required
Available options:
person,
assignment
subjectId
string<uuid>
required

Body

application/json
expected_revision
integer
required
Required range: 0 <= x <= 9007199254740991
terms
object
required
reason
string
required
Required string length: 1 - 2000
valid_from
string

Response

Native typed result.

Native typed outcome. Depending on the operation: records and effective revisions, issues with code, field path, severity and source references, applied constraints, soft preference effects, affected drafts and future published commitments with complete, missing or unsupported evidence, replayed for an exact retry and verified effect references. Authored availability, preference and pattern bodies round-trip unchanged.