---
title: "updateUserSchemaFileCollection"
method: PUT
path: "/v1/{slug}/collections/{collectionSlug}"
tags: ["File Collections"]
---

# updateUserSchemaFileCollection

`PUT /v1/{slug}/collections/{collectionSlug}`

Update an existing file collection.

You can update the name, parent relationships, starred status, and enabled locations/purposes.

## Path parameters

- `slug` string, required
- `collectionSlug` string, required

## Request body

- FileCollectionAttributes
  - `name` string — Name of the collection
  - `parents` string[] — Array of parent collection slugs, empty array if top-level collection
  - `starred` boolean — Whether the collection is starred / favorited
  - `enabled_locations` string[] — List of location slugs where the collection is enabled. If empty, enabled for all.
  - `enabled_purposes` string[] — List of purpose IDs where the collection is enabled. If empty, enabled for all.

## Response `200`

File collection updated successfully

- FileCollectionItem — A file collection with identifiers and timestamps
  - `slug` string — Full slug for the collection. Format depends on collection type: - User collection: `_system_files_collection_{entity_uuid}_{user_id}:{collection_name}` Example: `_system_files_collection_3fa85f64-5717-4562-b3fc-2c963f66afa6_10234:documents` - Global collection: `_system_files_collection_schema_{schema_slug}:{collection_name}` Example: `_system_files_collection_schema_opportunity:templates`
  - `name` string, required — Display name of the collection
  - `id` string, uuid — Generated uuid for a file collection
  - `parents` string[] — Array of parent collection slugs, empty array if top-level collection. Format depends on collection type: - User collection: `_system_files_collection_{entity_uuid}_{user_id}` Example: `["_system_files_collection_3fa85f64-5717-4562-b3fc-2c963f66afa6_10234"]` - Global collection: `_system_files_collection_schema_{schema_slug}` Example: `["_system_files_collection_schema_opportunity"]`
  - `starred` boolean — Whether the collection is starred / favorited
  - `order` number — Display order for the collection
  - `enabled_locations` string[] — List of location slugs where the collection is enabled. If empty, enabled for all.
  - `enabled_purposes` string[] — List of purpose slugs where the collection is enabled. If empty, enabled for all.
  - `created_at` string, date-time — Timestamp when the collection was created
  - `updated_at` string, date-time — Timestamp when the collection was last updated

## Other responses

- `400` — Invalid request parameters or payload
- `401` — Authentication required or invalid credentials
- `404` — The requested resource was not found
- `500` — An unexpected error occurred on the server

---

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