agent-run-monitoring

Append Agent Event

Append exactly the next ordered event; exact duplicates are safe.

post/v1/agent-events

Request

  • Base URL: https://api.forgeorbital.com
  • URL: https://api.forgeorbital.com/v1/agent-events
  • Auth: one of:
    • API key in header X-API-Key
    • OAuth 2 (client credentials, token URL /oauth/token, scopes: decision_records.write)
    • OAuth 2 (client credentials, token URL /oauth/token, scopes: decision_records)
    • HTTP bearer

Headers

Idempotency-Keystring required

Request body

schema_version'forge-agent-run-event/v1'
event_idstring required
run_idstring required
sequenceinteger required
parent_event_idstring nullable
occurred_atstring date-time required
event_typestring required
tool_call_idstring nullable
action_payload_sha256string nullable
result_payload_sha256string nullable
previous_event_sha256string nullable
event_sha256string nullable

Optional caller-computed canonical hash. When supplied it must match Forge's domain-separated v1 hash exactly.

Response

Exact normalized event replay; no additional event was stored.

schema_version'forge-agent-run-append-response/v1' required
tenant_idstring required
acceptedtrue required
idempotent_replayboolean required

Changes

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