---
title: "Get folder permissions"
method: GET
path: "/api/v1/folders/{folderId}/permissions"
tags: ["Folders"]
---

# Get folder permissions

`GET /api/v1/folders/{folderId}/permissions`

## Path parameters

- `folderId` string, required

## Response `200`

successful operation

- BoardPermission[]
  - `id` string
  - `type` string
  - `role` 'ADMIN' | 'AUTHOR' | 'MEMBER' | 'COLL_ADMIN'
  - `group` UserGroup
    - `name` string — Group Name
    - `id` string — ID of the group
    - `members` UserGroupMember[]
      - `id` string — ID of the group member
      - `managedByScim` boolean
      - `dateCreated` string, date-time — Date the group member was added to the group. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
      - `user` User, required
        - `id` string — The identifier of this User
        - `profilePicUrl` string — The profile picture url for the user
        - `joinedDate` string, date-time
        - `userProfile` UserProfile — Specifies additional information about a Guru User
          - `roleLevel` string — The level at which the user operates in their current role
          - `useCaseList` UseCase[] — Describes different ways the user intends to use Guru
            - `description` string — A description of this use case
          - `role` string — The functional role a Guru user performs on their team
        - `lastName` string, required — The user's last name
        - `firstName` string, required — The user's first name
        - `status` 'ACTIVE' | 'PENDING' — The status of a User can be ACTIVE or PENDING. The User must verify their email address to be considered ACTIVE.
        - `email` string, required — The user's email address
    - `expertIdRank` integer
    - `numberOfCardsAsVerifier` integer
    - `managedByScim` boolean
    - `groupIdentifier` string
    - `numberOfMembers` integer
    - `modifiable` boolean
    - `userModifiable` boolean
    - `singleUser` boolean
    - `team` Team
      - `name` string — Team Name
      - `id` string — ID of the fact
      - `profilePicUrl` string
      - `companyName` string — Team Company Name
      - `currentUserIsMember` boolean
      - `domain` string — Domain
      - `edition` TeamEdition
        - `adminOverrides` object
        - `name` string
        - `key` string
        - `id` string
        - `usage` object
        - `code` string
        - `features` object
      - `billableUsers` integer
      - `totalUsers` integer
      - `teamDomains` TeamDomain[]
        - `verificationCode` string
        - `verified` boolean
        - `capture` boolean
        - `domain` string
      - `slackCommandState` string
      - `slackCommandInstalled` boolean
      - `sfdcIntegrationState` string
      - `sfdcIntegrationInstalled` boolean
      - `clearProfilePic` boolean
      - `defaultGroup` UserGroup — recursive
      - `defaultUserType` 'FREE_CORE' | 'CORE'
      - `trialExpirationDate` string, date-time
      - `zendeskAssistState` string
      - `zendeskAssistInstalled` boolean
      - `zendeskKnowledgeState` string
      - `zendeskKnowledgeInstalled` boolean
      - `fileSharingDisabled` boolean
      - `collectionCreated` boolean
      - `teamCreationToken` string
      - `cardsCreated` integer
      - `topLevelOrganizationId` string
      - `numberOfCollections` integer
      - `numberOfOrgSharedCollections` integer
      - `allMembersGroupId` string
      - `deleted` boolean — Indicates if the fact has been deleted
      - `dateCreated` string, date-time — Date the team was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
      - `userRole` string
      - `useCase` string
      - `description` string
      - `status` 'ACTIVE' | 'DORMANT' | 'LOCKED' | 'EXPIRED' | 'LOCKED_PAY'
      - `organization` Organization
        - `name` string
        - `id` string
        - `workspaces` Team[]
    - `dateCreated` string, date-time — Date the group was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
    - `role` 'ADMIN' | 'AUTHOR' | 'MEMBER' | 'COLL_ADMIN'

## Other responses

- `400` — Invalid/Incomplete Request
- `401` — Request was unauthorized
- `403` — Forbidden access to the resource
- `404` — Resource could not be found

---

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