ListAiGatesResponse

Shape

• itemsarray of AiGateThe gates of this page.

  • The AiGate schema
  • 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.
• next_tokenstring or nulloptionalWhere the next page starts; absent on the last.

Graph

Used by