> ## 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.

# CreateCollection



## OpenAPI

````yaml openapi/api_v1_config_openapi3_DOCUMENTATION_ONLY.json POST /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:
    post:
      tags:
        - Collection
      operationId: CreateCollection
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/configv1CreateCollectionRequest'
        required: true
        x-originalParamName: body
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/configv1CreateCollectionResponse'
          description: A successful response containing the created Collection.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: Cannot create the Collection because the request is invalid.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: >-
            Cannot create the Collection because there is a conflict with an
            existing Collection.
        '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:
    configv1CreateCollectionRequest:
      properties:
        collection:
          allOf:
            - $ref: '#/components/schemas/configv1Collection'
          description: The Collection to create.
        dry_run:
          description: >-
            If `true`, validates the specified configuration without creating
            the Collection. If the specified configuration is valid, the
            endpoint returns a partial response without the Collection. If the
            specified configuration is invalid, the endpoint returns an error.
          type: boolean
      type: object
    configv1CreateCollectionResponse:
      properties:
        collection:
          $ref: '#/components/schemas/configv1Collection'
      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
  securitySchemes:
    ApiKeyAuth:
      description: Chronosphere API token
      in: header
      name: API-Token
      type: apiKey

````