Interactions

Create a durable request in the credential workspace.

Requires Idempotency-Key. Only account-scoped tokens may create requests, and the linked Resource must currently be owned by the credential owner. Decision mutation is human-only; approved Fulfillment reporting uses its dedicated route and scope.

post/api/v1/interactions

Request

  • Base URL: https://commentary.dev
  • URL: https://commentary.dev/api/v1/interactions
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required
X-Correlation-Idstring
X-Commentary-Workspace-Idstring

Must match the credential workspace. This header cannot widen grant authority.

Request body

contentobject required
initialState'draft' | 'active'
interactionType'request' | 'notification' | 'decision_request'
priority'low' | 'normal' | 'high' | 'urgent'

Response

Successful response.

Changes

No recorded changes to this operation across all 1 revision of this API.