AiGate

Shape

• approversarray of ActorSummaryThe people named to decide it; empty means the organization's board.

  • The ActorSummary schema
  • emailstringThe principal's address. An agent's is a generated no-reply address — the author of its commits. unknown on a deleted actor and empty on a redacted one.
  • idstringThe principal's id: a user id, a service account id or an agent id, as kind says. Empty on a redacted actor.
  • usernamestringThe name to show: a person's or service account's username, or an agent's handle (which always ends in -ai). deleted-user when the actor no longer resolves, redacted when the caller may not see who it was.
  • avatar_urlstring or nulloptionalThe principal's picture, when one is known. Absent otherwise: a client derives the deterministic avatar URL itself.
  • kindPrincipalKinduserservice_accountagentor nulloptionalWhat the actor is — a person, a service account or an AI organization's agent — and so which page it links to. Absent on a placeholder (a redacted or deleted actor) and on an actor that is not a principal, such as the platform's own system actor; a client draws such an actor unlinked.
• decide_bystring · date-timeWhen it expires if nobody decides it.
• gate_idAiGateId (string · uuid)The gate.
• kindAiGateKindmerge_protectedmerge_unprotectedlarge_changeadd_dependencycreate_work_itemclose_work_itemreleasedeploy_non_productiondeploy_productionexternal_messagesession_spendprivileged_pathritual_outcomeWhich gate of the catalogue it is.
• org_idAiOrgId (string · uuid)The organization it belongs to.
• requested_atstring · date-timeWhen it was raised.
• stateAiGateStatependingapproveddeniedexpiredwithdrawnconsumednotifiedWhere it stands.
• subjectobjectThe exact action waiting — what a decision applies to and nothing else.
• agentActorSummary or nulloptionalThe agent whose action it is.

  • The ActorSummary schema
  • emailstringThe principal's address. An agent's is a generated no-reply address — the author of its commits. unknown on a deleted actor and empty on a redacted one.
  • idstringThe principal's id: a user id, a service account id or an agent id, as kind says. Empty on a redacted actor.
  • usernamestringThe name to show: a person's or service account's username, or an agent's handle (which always ends in -ai). deleted-user when the actor no longer resolves, redacted when the caller may not see who it was.
  • avatar_urlstring or nulloptionalThe principal's picture, when one is known. Absent otherwise: a client derives the deterministic avatar URL itself.
  • kindPrincipalKinduserservice_accountagentor nulloptionalWhat the actor is — a person, a service account or an AI organization's agent — and so which page it links to. Absent on a placeholder (a redacted or deleted actor) and on an actor that is not a principal, such as the platform's own system actor; a client draws such an actor unlinked.
• bodystring or nulloptionalThe exact text an outgoing write would publish, for an external_message gate.
• consumed_atstring · date-time or nulloptionalWhen the approved action was taken.
• decided_atstring · date-time or nulloptionalWhen it was decided.
• decided_byActorSummary or nulloptionalWho decided it.

  • The ActorSummary schema
  • emailstringThe principal's address. An agent's is a generated no-reply address — the author of its commits. unknown on a deleted actor and empty on a redacted one.
  • idstringThe principal's id: a user id, a service account id or an agent id, as kind says. Empty on a redacted actor.
  • usernamestringThe name to show: a person's or service account's username, or an agent's handle (which always ends in -ai). deleted-user when the actor no longer resolves, redacted when the caller may not see who it was.
  • avatar_urlstring or nulloptionalThe principal's picture, when one is known. Absent otherwise: a client derives the deterministic avatar URL itself.
  • kindPrincipalKinduserservice_accountagentor nulloptionalWhat the actor is — a person, a service account or an AI organization's agent — and so which page it links to. Absent on a placeholder (a redacted or deleted actor) and on an actor that is not a principal, such as the platform's own system actor; a client draws such an actor unlinked.
• decision_notestring or nulloptionalWhat the person who decided it wrote for the agent.
• ritual_run_idAiRitualRunId (string · uuid) or nulloptionalThe ritual run whose outcome waits on it.
• session_idAiSessionId (string · uuid) or nulloptionalThe session waiting on it; absent for a ritual's outcome.

Graph

Used by