Role Permissions

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

GET /roles/{id}/permissions

DescriptionGet a list of all the role’s permissions in the company or client account.
Permissionsuser.manage
Resource URLhttps://app.klipfolio.com/api/1.0/roles/{id}/permissions
Parametersrole_id={id}

Example Request

GET https://app.klipfolio.com/api/1/roles/fedcba9876543210fedcba9876543210/permissions
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

DescriptionUpdate the permissions associated with the role in the company or client account.
Permissionsuser.manage
Resource URLhttps://app.klipfolio.com/api/1.0/roles/{id}/permissions
Parametersrole_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"

Example Request

PUT https://app.klipfolio.com/api/1/roles/fedcba9876543210fedcba9876543210/permissions -d {"permissions":["dashboard.annotation.view","dashboard.fullscreen","dashboard.library"]}
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

DescriptionDelete a specific role permission in the company or client account.
Permissionsuser.manage
Resource URLhttps://app.klipfolio.com/api/1.0/roles/{id}/permissions?<field>=<value>
ParametersNone.

Example Request

DELETE https://readme.io/.com/api/1/roles/0123456789abcdef0123456789abcdef/permissions?name='klip.delete'
DELETE https://readme.io/.com/api/1/roles/0123456789abcdef0123456789abcdef/permissions?client_id=0123456789abcdef0123456789abcdef&name='klip.delete'

Example Response

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