Issue, verify, close, or heartbeat a signed permit for one governed action.

post/v1/agent/enforcement

Request

  • Base URL: https://api.getmarrow.ai
  • URL: https://api.getmarrow.ai/v1/agent/enforcement
  • Auth: HTTP bearer

Request body

operation'issue' | 'verify' | 'close' | 'heartbeat' required
agent_idstring required
session_idstring required
harnessstring
actionstring
action_typestring
targetstring
surfacesstring[]

Canonical action surfaces. Verify must send the same set used to issue the permit; ordering is normalized and duplicates are rejected.

proof_requirementsstring[]

Exact server-required proof field names; broad proof categories do not satisfy these fields.

decision_idstring
gate_receipt_idstring
owner_approval_receipt_idstring
permitstring
permit_idstring
successboolean
evidenceobject

Exact proof-field map. Every required field needs a non-empty validated value; an empty blockers array is allowed when blockers is required.

expected_hooksstring[]
observed_hooksstring[]

Response

Successful tenant-scoped response.

object required

Changes

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