approval.routed

A pending approval handed to somebody else to answer (M5.5): a teammate, a role, or the lane’s lead. Chips resolves to to ids, as it does on the request.

Direction: Chips → the log
Sent by: a person
Requires a run: no
Schema: approval.routed.json

Fields

Every event also carries the envelope.

Field	Required	Type	Description
v	yes	1	Protocol major version.
type	yes	"approval.routed"
id	yes	string	The event’s own id. Stable across a retry of the same event.
ts	yes	string	When it happened, by Chips’ clock. Stamped on the way in; a value the sender writes is replaced.
workspace_id	yes	string	A workspace identifier: ws_ followed by a ULID.
space_id	no	string	The space, when the event belongs to one.
run_id	no	string	The run, when the event belongs to one.
seq	no	number	Assigned by the server on append, monotonic per workspace. Absent on the way in.
idempotency_key	no	string	Required on every client-originated write. Sending the same key twice is a no-op.
actor	yes	object	The participant an event is attributed to.
actor.kind	yes	"person" | "harness" | "agent" | "system"	Whether a person, a harness, one of a harness’s agents or Chips itself acted.
actor.id	yes	string	The participant id, or system for Chips.
actor.harness_id	no	string	For an agent: the harness it speaks through, whose budget and runs are the agent’s (ADR 0087). Filled in by Chips.
approval_id	yes	string	A approval identifier: apr_ followed by a ULID.
to	yes	string[]	Who should answer, as the router asks it: owner, any, role:<name>, lead, or a person id — the same words as approvers on the request.
approvers	no	string[]	Who may answer now, as ids. Filled in by Chips from to; a value the sender writes is replaced.
ask	no	object	What the ask is, written by Chips from the approval. Somebody handed an ask in a room they are not in never saw the request that raised it (ADR 0042), and this is what their card is drawn from; whoever is in the room has the request itself and ignores this.
ask.harness_id	yes	string	The harness that asked.
ask.action	yes	{ kind: string; }	The action as the harness proposed it.
ask.action.kind	yes	string
ask.risk	no	string[]	The risk classes it declared.
ask.expires_at	no	string	When it expires, if it does.
reason	no	string	Why it was handed on, for the card and the audit.
routed_by	no	string	Who handed it on. Filled in by Chips from the credential.
routed_at	no	string	When. Filled in by Chips from its clock.

Example

{
  "v": 1,
  "type": "approval.routed",
  "id": "evt_01K4ZQPX0000000000000000D8",
  "ts": "2026-09-06T12:04:00.004Z",
  "workspace_id": "ws_01K4ZQPX000000000000000001",
  "space_id": "spc_01K4ZQPX000000000000000002",
  "run_id": "run_01K4ZQPX000000000000000005",
  "actor": {
    "kind": "person",
    "id": "usr_01K4ZQPX000000000000000003"
  },
  "idempotency_key": "route-1",
  "approval_id": "apr_01K4ZQPX000000000000000006",
  "to": ["usr_01K4ZQPX000000000000000009"],
  "approvers": ["usr_01K4ZQPX000000000000000009"],
  "reason": "Dana knows the Northwind account.",
  "routed_by": "usr_01K4ZQPX000000000000000003",
  "routed_at": "2026-09-06T12:04:00.004Z"
}