> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ListCollections



## OpenAPI

````yaml openapi/api_v1_config_openapi3_DOCUMENTATION_ONLY.json GET /api/v1/config/collections
openapi: 3.0.3
info:
  description: >

    The Config API provides standard HTTP/JSON REST endpoints for creating,
    reading,

    updating, deleting, and listing configurable Chronosphere resources.


    Use this link to download the raw Swagger specification:

    <a href="/api/v1/config/swagger.json">/api/v1/config/swagger.json</a>
  title: Config V1 API
  version: v1
servers:
  - url: https://{tenant}.chronosphere.io
    variables:
      tenant:
        default: tenant
        description: tenant ID assigned by the service provider
security:
  - ApiKeyAuth: []
tags:
  - name: ConfigV1
paths:
  /api/v1/config/collections:
    get:
      tags:
        - Collection
      operationId: ListCollections
      parameters:
        - description: >-
            Sets the preferred number of items to return per page. If set to
            `0`, the

            server will use its default value. Regardless of the value
            specified, clients

            must never assume how many items will be returned.
          in: query
          name: page.max_size
          schema:
            format: int64
            type: integer
        - description: >-
            An opaque page token that identifies which page the client should
            request.

            An empty value indicates the first page.
          in: query
          name: page.token
          schema:
            type: string
        - description: >-
            Filters results by slug, where any Collection with a matching slug
            in the given list (and matches all other filters) will be returned.
          in: query
          name: slugs
          schema:
            items:
              type: string
            type: array
        - description: >-
            Filters results by team_slug, where any Collection with a matching
            team_slug in the given list (and matches all other filters) will be
            returned.
          in: query
          name: team_slugs
          schema:
            items:
              type: string
            type: array
        - description: >-
            Filters results by name, where any Collection with a matching name
            in the given list (and matches all other filters) will be returned.
          in: query
          name: names
          schema:
            items:
              type: string
            type: array
        - description: >-
            Get collections that directly reference notification policies
            specified in

            this array. To specify a notification policy, include its slug.
          in: query
          name: notification_policy_slugs
          schema:
            items:
              type: string
            type: array
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/configv1ListCollectionsResponse'
          description: A successful response.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: An unexpected error response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/genericError'
          description: An undefined error response.
components:
  schemas:
    configv1ListCollectionsResponse:
      properties:
        collections:
          items:
            $ref: '#/components/schemas/configv1Collection'
          type: array
        page:
          $ref: '#/components/schemas/configv1PageResult'
      type: object
    apiError:
      properties:
        message:
          description: An error message describing what went wrong.
          type: string
      type: object
    genericError:
      additionalProperties: true
      type: object
    configv1Collection:
      properties:
        created_at:
          description: >-
            Timestamp of when the Collection was created. Cannot be set by
            clients.
          format: date-time
          readOnly: true
          type: string
        description:
          description: A description of the collection.
          type: string
        name:
          description: >-
            The name of the Collection. You can modify this value after the
            Collection is created.
          type: string
        notification_policy_slug:
          description: >-
            The slug of the default notification policy for monitors in this
            collection.

            This value is only required when the collection contains monitors
            and one

            or more of those monitors don't explicitly reference a policy. This
            value does

            not override the policy used when a monitor explicitly references a
            different

            policy.
          type: string
        slug:
          description: >-
            The unique identifier of the Collection. If a `slug` isn't provided,
            one is generated based on the `name` field. You can't modify this
            field after the Collection is created.
          type: string
        team_slug:
          description: The slug of the team that the collection belongs to.
          type: string
        updated_at:
          description: >-
            Timestamp of when the Collection was last updated. Cannot be set by
            clients.
          format: date-time
          readOnly: true
          type: string
      required:
        - name
        - team_slug
      type: object
    configv1PageResult:
      properties:
        next_token:
          description: |-
            An opaque page token that identifies the next page of items that the
            client should request. An empty value indicates that there are no
            more items to return.
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Chronosphere API token
      in: header
      name: API-Token
      type: apiKey

````