WAwarp
Agents

List environments

Changed on

Retrieve cloud environments accessible to the authenticated principal. Returns environments the caller owns, has been granted guest access to, or has accessed via link sharing.

get/agent/environments

Request

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

Query parameters

sort_by'name' | 'last_updated'

Sort order for the returned environments.

  • name: alphabetical by environment name
  • last_updated: most recently updated first (default)

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 accessible environments

Changes