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