---
title: "PUT /collections/{collectionName}"
method: PUT
path: "/collections/{collectionName}"
tags: ["Collection"]
---

# PUT /collections/{collectionName}

`PUT /collections/{collectionName}`

Creates or updates a collection entity.

## Path parameters

- `collectionName` string, required

## Query parameters

- `api-version` string, required

## Request body

- Collection — Collection resource.
  - `collectionProvisioningState` 'Unknown' | 'Creating' | 'Moving' | 'Deleting' | 'Failed' | 'Succeeded' — Gets the state of the provisioning.
  - `description` string — Gets or sets the description.
  - `domain` string — Gets the domain.
  - `friendlyName` string — Gets or sets the friendly name of the collection.
  - `name` string — Gets the name.
  - `parentCollection` CollectionReference — Reference to a Collection.
    - `referenceName` string — Gets or sets the reference name.
    - `type` string — Gets or sets the reference type property.
  - `systemData` SystemData — Metadata pertaining to creation and last modification of the resource.
    - `createdAt` string, date-time — The timestamp of resource creation (UTC).
    - `createdBy` string — The identity that created the resource.
    - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key' — The type of identity that created the resource.
    - `lastModifiedAt` string, date-time — The timestamp of the last modification the resource (UTC).
    - `lastModifiedBy` string — The identity that last modified the resource.
    - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key' — The type of identity that last modified the resource.

## Response `200`

Success

- Collection — Collection resource.
  - `collectionProvisioningState` 'Unknown' | 'Creating' | 'Moving' | 'Deleting' | 'Failed' | 'Succeeded' — Gets the state of the provisioning.
  - `description` string — Gets or sets the description.
  - `domain` string — Gets the domain.
  - `friendlyName` string — Gets or sets the friendly name of the collection.
  - `name` string — Gets the name.
  - `parentCollection` CollectionReference — Reference to a Collection.
    - `referenceName` string — Gets or sets the reference name.
    - `type` string — Gets or sets the reference type property.
  - `systemData` SystemData — Metadata pertaining to creation and last modification of the resource.
    - `createdAt` string, date-time — The timestamp of resource creation (UTC).
    - `createdBy` string — The identity that created the resource.
    - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key' — The type of identity that created the resource.
    - `lastModifiedAt` string, date-time — The timestamp of the last modification the resource (UTC).
    - `lastModifiedBy` string — The identity that last modified the resource.
    - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key' — The type of identity that last modified the resource.

## Other responses

- `default` — An error response received from the provider.

---

[API](https://skmtc.net/azure/apis/purview-account.md) · [All operations](https://skmtc.net/azure/apis/purview-account/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/purview-account/versions/dc51c3b3ddf7/schema)