Interactions

Read immutable human Decision receipts for one Interaction.

An eligible browser human may list receipts. The authorized creating agent may retrieve one opaque receipt by decisionId or poll/wait after a prior receipt for at most ten seconds. Agent results omit human identity, Resource data, consequence content, and action snapshots. waitMs=0 is the universal polling fallback.

get/api/v1/interactions/{interactionId}/decisions

Request

  • Base URL: https://commentary.dev
  • URL: https://commentary.dev/api/v1/interactions/{interactionId}/decisions
  • Auth: one of:
    • API key in cookie commentary_session
    • HTTP bearer

Path parameters

interactionIdstring required

Opaque Interaction id.

Query parameters

approvalunknown

Return an approving receipt only when the exact current revision/action/fingerprint, expiry, and current policy are satisfied. polling.approval contains sanitized counts; pending yields no receipt.

decisionIdstring

Opaque Decision id for a creating agent.

afterstring

Opaque prior Decision id used as a polling cursor.

waitMsinteger

Bounded cancelable wait; zero performs an immediate poll.

Headers

X-Commentary-Workspace-Idstring

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

X-Correlation-Idstring

Response

Successful response.

pollingobject

Changes

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