List environments

GET /api/v1/cloud/environments Lists environments under the current account with cursor pagination. Archived environments are excluded by default.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or SAT>`

Query parameters

Parameter	Type	Required	Default	Description
`limit`	integer	No	20	Items per page. Range 1-100; values above 100 return `400 invalid_request_error`
`page`	string	No	-	Cursor returned by the previous response's `next_page`
`include_archived`	boolean	No	`false`	Set to `true` to include archived environments
`created_at[gte]`	string	No	-	Include environments created at or after this RFC 3339 timestamp
`created_at[lte]`	string	No	-	Include environments created at or before this RFC 3339 timestamp

See Pagination for cursor semantics.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/cloud/environments' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "env_019e3bb39b6774d8878cd0b9d237574b",
      "type": "environment",
      "name": "doc-test-env",
      "description": "",
      "config": {
        "type": "cloud",
        "packages": {
          "type": "packages",
          "apt": ["curl"],
          "cargo": [],
          "gem": [],
          "go": [],
          "npm": [],
          "pip": []
        }
      },
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-05-18T15:28:07.017808Z",
      "updated_at": "2026-05-18T15:28:07.017808Z"
    },
    {
      "id": "env_019e2590d33f711fabf42f2857cecd8a",
      "type": "environment",
      "name": "default",
      "description": "",
      "config": {
        "type": "cloud",
        "packages": {
          "type": "packages",
          "apt": [],
          "cargo": [],
          "gem": [],
          "go": [],
          "npm": [],
          "pip": []
        }
      },
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-05-14T08:18:28.800813Z",
      "updated_at": "2026-05-14T08:18:28.800813Z"
    }
  ],
  "first_id": "env_019e3bb39b6774d8878cd0b9d237574b",
  "has_more": false,
  "last_id": "env_019e2590d33f711fabf42f2857cecd8a",
  "next_page": null
}

Response fields

Field	Type	Description
`data`	array of Environment object	Environments on the current page
`first_id`	string	ID of the first record on this page
`last_id`	string	ID of the last record on this page
`has_more`	boolean	Whether more records remain
`next_page`	string\|null	Cursor for the next page. Equals `last_id` when `has_more` is true, otherwise `null`

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	`limit` is not a positive integer
400	`invalid_request_error`	Invalid pagination cursor
400	`invalid_request_error`	`created_at[gte]` or `created_at[lte]` is not RFC 3339
401	`authentication_error`	PAT or SAT invalid or expired
403	`permission_error`	Not authorized for this resource

See Errors for the full error envelope.

Notes

Records are returned in descending ID order by default.
Archived environments do not appear in the default listing. Pass include_archived=true to include them.
Pagination is cursor-based; offset-based pagination is not supported.

Cloud environment setup

Choose the container, network, and dependencies your agent runs in.

​Headers

​Query parameters

​Example request

​Example response

​Response fields

​Errors

​Notes

​Related