Agent Governance Protocol
API ReferenceExecution APILedger

Append ledger event

Append-only. Events are hash-chained per task stream via prev_event_hash (§14.1).

POST
/agp/ledger-events

Authorization

AuthorizationBearer <token>

In: header

Scope: agp.execution.read, agp.execution.write

Header Parameters

Idempotency-Key?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/agp/ledger-events" \  -H "Content-Type: application/json" \  -d '{    "type": "EventLedgerRecord",    "event_id": "string",    "task_id": "string",    "timestamp": "2019-08-24T14:15:22Z",    "agent_id": "string",    "principal_id": "string",    "outcome": "initiated"  }'
{  "type": "EventLedgerRecord",  "event_id": "string",  "prev_event_hash": "string",  "task_id": "string",  "timestamp": "2019-08-24T14:15:22Z",  "agent_id": "string",  "principal_id": "string",  "decision_ref": "string",  "delegation_ref": "string",  "evidence_refs": [    "string"  ],  "tool_action_ref": "string",  "artifact_hashes": [    "string"  ],  "outcome": "initiated",  "signature": {    "alg": "string",    "kid": "string",    "issuer": "string",    "issued_at": "2019-08-24T14:15:22Z",    "payload_hash": "string",    "value": "string"  }}
{  "error": {    "code": "AGP_INVALID_REQUEST",    "message": "string",    "retryable": true,    "details": {}  }}
{  "error": {    "code": "AGP_INVALID_REQUEST",    "message": "string",    "retryable": true,    "details": {}  }}
{  "error": {    "code": "AGP_INVALID_REQUEST",    "message": "string",    "retryable": true,    "details": {}  }}