---
title: "PUT /api/v1/config/collections/{slug}"
method: PUT
path: "/api/v1/config/collections/{slug}"
tags: ["Collection"]
---

# PUT /api/v1/config/collections/{slug}

`PUT /api/v1/config/collections/{slug}`

## Path parameters

- `slug` string, required

## Request body

- ConfigV1UpdateCollectionBody
  - `collection` Configv1Collection
    - `created_at` string, date-time — Timestamp of when the Collection was created. Cannot be set by clients.
    - `description` string — A description of the collection.
    - `name` string, required — The name of the Collection. You can modify this value after the Collection is created.
    - `notification_policy_slug` string — 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.
    - `slug` string — 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.
    - `team_slug` string, required — The slug of the team that the collection belongs to.
    - `updated_at` string, date-time — Timestamp of when the Collection was last updated. Cannot be set by clients.
  - `create_if_missing` boolean — If `true`, the Collection will be created if it does not already exist, identified by `slug`. If `false`, an error will be returned if the Collection does not already exist.
  - `dry_run` boolean — If `true`, validates the specified configuration without creating or updating 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.

## Response `200`

A successful response containing the updated Collection.

- Configv1UpdateCollectionResponse
  - `collection` Configv1Collection
    - `created_at` string, date-time — Timestamp of when the Collection was created. Cannot be set by clients.
    - `description` string — A description of the collection.
    - `name` string, required — The name of the Collection. You can modify this value after the Collection is created.
    - `notification_policy_slug` string — 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.
    - `slug` string — 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.
    - `team_slug` string, required — The slug of the team that the collection belongs to.
    - `updated_at` string, date-time — Timestamp of when the Collection was last updated. Cannot be set by clients.

## Other responses

- `400` — Cannot update the Collection because the request is invalid.
- `404` — Cannot update the Collection because the slug does not exist.
- `409` — Cannot update the Collection because there is a conflict with an existing Collection.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.net/chronosphere/apis/data-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/data-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/data-v1-api/versions/ee91fd539ced/schema)