Gets the App permissions of an app.
| Method |
GET |
| URL |
https://{subdomain}.kintone.com/k/v1/app/acl.json |
| URL(guest space) |
https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/app/acl.json |
| Authentication |
Password Authentication |
| Content-Type |
|
Pre-live settings
Apps may hold pre-live settings that have not yet been deployed to the live app.
Access the pre-live settings with the below URL.
| URL |
https://{subdomain}.kintone.com/k/v1/preview/app/acl.json |
| URL(guest space) |
https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/acl.json |
Permissions
- Permission to view records are needed when obtaining information of live Apps.
- App management permissions are needed when obtaining information of pre-live settings.
- API Tokens cannot be used with this API.
Request Parameters
| Parameter |
Value |
Required |
Description |
| app |
Integer or String |
Yes |
The App ID |
Sample Request
Response Parameters
| Parameter |
Type |
Description |
| rights |
Array |
An array of objects that contain data of App permissions, in order of priority. |
| rights[].entity |
Object |
An object containing data of the entity the permission is granted to. |
| rights[].entity.type |
String |
The type of the entity the permission is granted to.
- USER： User
- GROUP： Group
- ORGANIZATION： Department
- CREATOR： The creator of the App
|
| rights[].entity.code |
String |
The code of the entity the permission is granted to. |
| rights[].includeSubs |
Boolean |
The permission inheritance settings of the department the permission is granted to.
- true： Permissions are inherited.
- false： Permissions are not inherited.
|
| rights[].appEditable |
Boolean |
The App management permission of the entity.
Entities with this permission are able to access and edit the App's settings.
- true： The App's settings are accessible.
- false： The App's settings are not accessible.
|
| rights[].recordViewable |
Boolean |
The record view permission of the entity.
- true： Records are viewable.
- false： Records are not viewable.
|
| rights[].recordAddable |
Boolean |
The record add permission of the entity
- true： Records can be added.
- false： Records cannot be added.
|
| rights[].recordEditable |
Boolean |
The record edit permission of the entity.
- true： Records are editable.
- false： Records are not editable.
|
| rights[].recordDeletable |
Boolean |
The record delete permission of the entity.
- true： Records are deletable.
- false： Records are not deletable.
|
| rights[].recordImportable |
Boolean |
The file import permission of the entity.
- true： Files are importable
- false： Files are not importable
|
| rights[].recordExportable |
Boolean |
The file export permission of the entity.
- true： Files are exportable
- false： Files are not exportable
|
| revision |
String |
The revision number of the App settings. |
Sample Response
Please share your views with us in the Community forums!