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

# getGlobalFileCollections

`GET /v1/collections/{schemaSlug}`

Get all global file collections for a specific schema.

Global collections are shared across all users in the organization for the specified schema.
Unlike user collections, these are visible to everyone with access to entities of that schema.

## Path parameters

- `schemaSlug` string, required

## Response `200`

List of global collections for the 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)