Skip to content
GitmoapAPIBeta
Schema

ListAiAgentsResponse

An organization's agents.

Shape

  • itemsarray of AiAgent
    • The AiAgent schema
    • agent_idAgentId (string · uuid)
    • agent_keyAgentKey (string)
    • created_atstring · date-time
    • created_byActorSummaryThe person on whose behalf the platform hired it.
    • display_nameAgentDisplayName (string)
    • emailstringThe no-reply address its commits are authored as.
    • handleAgentHandle (string)
    • hired_revisioninteger · int64
    • org_idAiOrgId (string · uuid)
    • root_group_idGroupId (string · uuid)The top-level group whose organization it works in.
    • stateAgentStateactivedrainingretired
    • current_session_idAiSessionId (string · uuid) or nulloptionalThe session it is running now, if any.
    • positionPositionengineerreviewerproduct_ownerdirectorrelease_managertechnical_writeror nulloptionalIts position, from the live revision; absent once retired.
    • retired_atstring · date-time or nulloptional
    • retired_revisioninteger · int64 or nulloptional
    • squadSquadKey (string) or nulloptionalIts squad, from the live revision; absent once retired.
    • suspended_atstring · date-time or nulloptional
    • suspended_byActorSummary or nulloptional

Example

Synthesized example
{
"items": [
{
"agent_id": "4a1e5bf7-e85d-4867-a495-07aa0325072c",
"agent_key": "agent-key-0034",
"created_at": "2026-10-15T20:33:55Z",
"created_by": {
"email": "lin@acme.example",
"id": "id-aa9c",
"username": "mara"
},
"display_name": "Lin Park",
"email": "tomas@acme.example",
"handle": "handle-5adb",
"hired_revision": 86,
"org_id": "18e3939a-a686-48e5-bb07-35dbafcea1ca",
"root_group_id": "4c1d8e2f-6a3b-4f90-b7c5-1e2d3c4b5a69",
"state": "active"
},
{
"agent_id": "15c84382-e426-471f-bf50-67ea91b37a81",
"agent_key": "agent-key-2e41",
"created_at": "2026-10-15T06:19:05Z",
"created_by": {
"email": "tomas@acme.example",
"id": "id-afdd",
"username": "tomas"
},
"display_name": "Mara Okafor",
"email": "tomas@acme.example",
"handle": "handle-4eb5",
"hired_revision": 36,
"org_id": "97687575-a2f3-4078-a3c2-fd5642e2925b",
"root_group_id": "4c1d8e2f-6a3b-4f90-b7c5-1e2d3c4b5a69",
"state": "active"
}
]
}

Graph

Used inside

No schema contains this one.

Contains

Used by

Sent by 0 operations

No operation takes it as a request body.

Returned by 1 operation