---
updatedAt: 2026-06-03T20:01:30.000Z
agentTools:
  projectIndex: https://apidocs.klipfolio.com/llms.txt
---

# Role Permissions

View, update and manage permissions associated with a role in the company or client account.

## GET /roles/`{id}`/permissions

|              |                                                                                                                           |
| :----------- | :------------------------------------------------------------------------------------------------------------------------ |
| Description  | Get a list of all the role’s permissions in the company or client account.                                                |
| Permissions  | user.manage                                                                                                               |
| Resource URL | [https://app.klipfolio.com/api/1.0/roles/`{id}`/permissions](https://app.klipfolio.com/api/1.0/roles/`\{id}`/permissions) |
| Parameters   | role\_id=`{id}`                                                                                                           |

## Example Request

```Text Get permissions for role
GET https://app.klipfolio.com/api/1/roles/fedcba9876543210fedcba9876543210/permissions
```
```Text Client get permissions for role
GET https://app.klipfolio.com/api/1/roles/fedcba9876543210fedcba9876543210/permissions?client_id=0123456789abcdef0123456789abcdef
```

## Example Response

```
{
 "data": {
"permissions":["account.api","account.eventlog","account.profile","account.settings","account.tokens","admin.annotation","admin.client","admin.datasource","admin.klip","admin.tab","client.access","client.build","client.delete","client.edit","client.login","client.share","dashboard.annotation.edit","dashboard.annotation.view","dashboard.ds_warning.view","dashboard.fullscreen","dashboard.klip","dashboard.library","dashboard.tab","dashboard.theme","datasource.create","datasource.delete","datasource.download","datasource.edit","datasource.import","datasource.share","klip.build","klip.delete","klip.download","klip.edit","klip.email","klip.embed","klip.import","klip.share","tab.build","tab.delete","tab.download","tab.edit","tab.email","tab.import","tab.push","tab.share","user.manage"]
  },
 "meta": {
     "status": 200,
     "success": true
 }
}
```

## PUT /roles/`{id}`/permissions

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>

      </th>

      <th>

      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Description
      </td>

      <td>
        Update the permissions associated with the role in the company or client account.
      </td>
    </tr>

    <tr>
      <td>
        Permissions
      </td>

      <td>
        user.manage
      </td>
    </tr>

    <tr>
      <td>
        Resource URL
      </td>

      <td>
        [https://app.klipfolio.com/api/1.0/roles/`{id}`/permissions](https://app.klipfolio.com/api/1.0/roles/`\{id}`/permissions)
      </td>
    </tr>

    <tr>
      <td>
        Parameters
      </td>

      <td>
        role_id=`{id}`  
        permissions = "account.api", "account.eventlog", "account.profile", "account.settings", "account.tokens", "admin.annotation", "admin.client", "admin.datasource", "admin.klip", "admin.tab", "client.access", "client.build", "client.delete", "client.edit", "client.login", "client.share", "dashboard.annotation.edit", "dashboard.annotation.view", "dashboard.ds_warning.view", "dashboard.fullscreen", "dashboard.klip", "dashboard.library", "dashboard.tab", "dashboard.theme", "datasource.create", "datasource.delete", "datasource.download", "datasource.edit", "datasource.import", "datasource.share", "klip.build", "klip.delete", "klip.download", "klip.edit", "klip.email", "klip.embed", "klip.import", "klip.share", "tab.build", "tab.delete", "tab.download", "tab.edit", "tab.email", "tab.import", "tab.push", "tab.share", "user.manage"
      </td>
    </tr>
  </tbody>
</Table>

## Example Request

```Text Update permissions on a role
PUT https://app.klipfolio.com/api/1/roles/fedcba9876543210fedcba9876543210/permissions -d {"permissions":["dashboard.annotation.view","dashboard.fullscreen","dashboard.library"]}
```
```Text Client update permissions on a role
PUT https://app.klipfolio.com/api/1/roles/fedcba9876543210fedcba9876543210/permissions?client_id=0123456789abcdef0123456789abcdef
 -d {"permissions":["dashboard.annotation.view","dashboard.fullscreen","dashboard.library"]}
```

## Example Response

```
{
 "meta": {
     "status": 200,
     "success": true
 }
}
```

## DELETE /roles/`{id}`/permissions

|              |                                                                                                                                             |
| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------ |
| Description  | Delete a specific role permission in the company or client account.                                                                         |
| Permissions  | user.manage                                                                                                                                 |
| Resource URL | [https://app.klipfolio.com/api/1.0/roles/`{id}`/permissions](https://app.klipfolio.com/api/1.0/roles/`\{id}`/permissions)?\<field>=\<value> |
| Parameters   | None.                                                                                                                                       |

## Example Request

```Text Remove permission from role
DELETE https://readme.io/.com/api/1/roles/0123456789abcdef0123456789abcdef/permissions?name='klip.delete'
```
```Text Client remove permission from role
DELETE https://readme.io/.com/api/1/roles/0123456789abcdef0123456789abcdef/permissions?client_id=0123456789abcdef0123456789abcdef&name='klip.delete'
```

## Example Response

```
{
"meta": {
      "status": 200,
      "success": true
  }
}
```