Approval Events — Proposed Guide

Planned API — Reference Only

Approval Events: Approval events would represent routing changes and reviewer decisions as separate facts. Assignment of a reviewer is not a recorded approval.

Overview

Approval events would represent routing changes and reviewer decisions as separate facts. Assignment of a reviewer is not a recorded approval.

Key concepts

Link the approval id, reviewed resource and decision version. Preserve delegate and original reviewer context where authorized.

Implementation considerations

Consumers should not infer that an entire chain is complete from one reviewer decision. No approval event is emitted here.

Illustrative data model

This local fixture shows a possible representation for the concepts above. It is not an endpoint response, production configuration or a claim that the described capability is implemented.

JSON fixture

Fictional concept fixture

{
  "reference_only": true,
  "topic": "Approval Events",
  "event_id": "event_example_123",
  "approval_id": "apr_example_123",
  "resource_id": "resource_example_123",
  "decision": "pending",
  "version": 1
}

Design review checklist

Document which organization owns the approval events representation and which actor may view or change it.
Test the boundaries of event id, approval id, resource id, decision, version using synthetic values, including missing or inconsistent references.
Before future implementation, obtain an approved contract and review failure behavior. This documentation does not authorize production activation.

Proposed data types

Illustrative field dictionary
Name	Type	Description
event_id	string	Stable fictional event reference; not a secret and not evidence that a resource exists.
approval_id	string	Stable fictional approval reference; not a secret and not evidence that a resource exists.
resource_id	string	Stable fictional resource reference; not a secret and not evidence that a resource exists.
decision	string	Illustrative review outcome; pending is not a completed approval.
version	integer	Illustrative resource revision for detecting stale updates; no live concurrency contract is published.

Expense Events

Webhooks & Events

Reimbursement Events