WAwarp
Agents

List agents

Changed on

List all agents on the caller's team.

get/agent/identities

Request

  • Base URL
    https://app.warp.dev/api/v1
  • Auth
    HTTP bearer

Query parameters

factory_uidstring

Optional UID of a Factory to filter by. When provided, only agents linked to that factory are returned.

branch_uidstring

Optional Factory branch UID. Requires factory_uid and access to that factory. Returns only active agents in that branch; when omitted, only production agents are returned.

Headers

X-Warp-Team-Uidstring

UID of the team to use as the request's active team. Ignored for service-account callers, which always act as their bound team.

Response

List of agents

Changes

  • 7ee3ba55debcRevision changes
    • info

      added the new optional query request parameter branch_uid

    • info

      added the non-success response with the status

  • 2c45dcc0a13eRevision changes
    • breaking

      added subschema #1 to the /////// response property oneOf list for the response status

    • breaking

      the /////// response's property type changed from string to no type for status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property //////// to the response with the status

    • info

      removed the claude enum value from the /////// response property for the response status

    • info

      removed the codex enum value from the /////// response property for the response status

    • info

      removed the gemini enum value from the /////// response property for the response status

    • info

      removed the oz enum value from the /////// response property for the response status