v1

latestOpenAPI 3.1.0BSD-32026-07-2471176175.5 KB

costformation-namespaces

Get all namespaces

Retrieves all namespaces for the organization with pagination support

get/v2/costformation/namespace

Query parameters

limitnumber

Number of items to return per page

cursorstring

Allows you to page forward and back in your results. NOTE: This must be URL Encoded!

See the Pagination section of the API Reference for more information!

sort_key'last_updated' | 'fqn'

Sortable Namespace properties

sort_order'asc' | 'desc'

ASC or DESC sort order

Headers

cloudzero-idempotency-keystring

If passed, any subsequent operation with the same value for this header will return the exact same result. This is true for all responses, i.e. successes and errors.

cloudzero-test-keystring

If passed, the operation executes in the namespace specified by this key. Resource mutations in the namespace last for 1 hour.

Response

List of namespaces retrieved successfully

Example response

{
  "namespaces": [
    {
      "id": "User:Production",
      "view_role_ids": [
        "a1b2c3d4-5678-4abc-9def-012345678901"
      ],
      "edit_role_ids": [
        "a1b2c3d4-5678-4abc-9def-012345678901"
      ],
      "display_name": "Production"
    }
  ]
}