---
title: "List user permissions for a collection"
method: GET
path: "/collections/{collection_id}/user_permissions"
tags: ["user_permissions"]
---

# List user permissions for a collection

`GET /collections/{collection_id}/user_permissions`

Lists user permissions for the matching collection.

## Query parameters

- `page` integer
- `per` integer

## Response `200`

User permissions for the matching collection.

- object
  - `data` UserPermissionToCollection[], required
    - `id` string, required — Unique identifier for the resource instance.
    - `type` 'user_permissions', required — The type of the resource.
    - `attributes` object, required
      - `permission_level` 'guest' | 'collaborator' | 'admin' | 'owner' — Access level to the object. Learn more about the permission levels you can grant Users in our Knowledge Base article on <a href="https://help.smartsheet.com/115002602273-User-Permissions" target="_blank">User Permissions</a>.
    - `relationships` object, required
      - `user` object
        - `id` string — Unique identifier for the resource instance.
        - `type` 'users' — The type of the resource.
      - `permissible` object
        - `id` string — Unique identifier for the resource instance.
        - `type` 'collections' — The type of the resource.
  - `included` union[] — An array listing the collection and its users.
    - union
      - User
        - `id` string, required — Unique identifier for the resource instance.
        - `type` 'users', required — The type of the resource.
        - `attributes` UserAttributes, required
          - `email` string, required — The user's email address.
          - `first_name` string, required — The user's first name.
          - `last_name` string, required — The user's last name.
      - Collection
        - `id` string, required — Unique identifier for the resource instance.
        - `type` 'collections', required — The type of the resource.
        - `attributes` CollectionAttributes, required
          - `name` string — The name of the collection.
          - `tagline` string — The tagline of the collection.
          - `slug` string — The URL-friendly slug of the collection.
          - `public` boolean — Set to `true` for hassle-free sharing, allowing search engines to index your brand assets. Otherwise, set to `false` to share only with the users you specify.
          - `stealth` boolean — Set to `true` to remove the collection from appearing in web searches.
          - `is_workspace` boolean — Set to `true` if the collection is a Brandfolder workspace.
  - `meta` PaginationMetadataResponse, required — Page context information.
    - `current_page` integer, required
    - `next_page` object, nullable, required
    - `prev_page` object, nullable, required
    - `total_pages` unknown, required
    - `total_count` unknown, required

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/revisions/fd95b0a2d2f8/schema)