---
title: "getUserSchemaFileCollections"
method: GET
path: "/v1/{slug}/collections"
tags: ["File Collections"]
---

# getUserSchemaFileCollections

`GET /v1/{slug}/collections`

Get all file collections for the current user within a specific schema.

Collections help organize files into logical groups (e.g., "Contracts", "Invoices").
User collections are private to the creating user.

## Path parameters

- `slug` string, required

## Response `200`

List of collections for the user and schema

- FileCollectionItem[]
  - `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

- `401` — Authentication required or invalid credentials
- `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)