DOdocker
Policies

List policies

Changed on

Returns a shallow summary of the organization's policies, one page at a time. The rule set is not included; use GetPolicy to fetch the full object.

Results are paginated with an opaque cursor. Pass page_size to bound the page; if more policies remain, the response includes a non-null next_page_token to pass as page_token on the next request. Iterate until next_page_token is null. Treat the token as opaque; do not parse or construct it.

get/orgs/{org_name}/governance/policies

Request

Query parameters

page_sizeinteger

Maximum number of policies to return. Defaults to 100 if omitted or zero. The server caps values above 100 at 100.

page_tokenstring

Opaque cursor from a previous response's next_page_token. Omit to fetch the first page.

Response

Object wrapping an array of policy summaries under data and a next_page_token, which is null on the last page. Rule sets are not included; use GetPolicy to fetch a full policy.

next_page_tokenstring nullable required

The opaque cursor for the next page, or null on the last page.

Example response

{
  "data": [
    {
      "id": "pol_06evsmp24r1pg71cm8500546pkbn",
      "name": "Security Research — hardened",
      "org": "my-org",
      "scope": {
        "teams": [
          "d290f1ee-6c54-4b01-90e6-d701748f0851"
        ]
      },
      "created_at": "2026-04-22T00:00:00Z",
      "updated_at": "2026-04-22T00:00:00Z",
      "type": "allowlist_v0"
    }
  ],
  "next_page_token": "AQpteyJQSyI6Im15LW9yZyIsIlNLIjoicG9saWN5I3BvbF8ifQ"
}

Changes

  • 85e78016fe38Revision changes
    • warning

      added the new allowlist_v0 enum value to the // response property for the response status

    • warning

      added the new cedar_v1 enum value to the // response property for the response status

    • info

      added the new optional query request parameter page_size

    • info

      added the new optional query request parameter page_token

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status

  • c133c0782991Revision changes
    • warning

      added the new limit_exceeded enum value to the / response property for the response status

    • warning

      added the new limit_exceeded enum value to the / response property for the response status

    • warning

      added the new limit_exceeded enum value to the / response property for the response status

    • warning

      added the new limit_exceeded enum value to the / response property for the response status