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 | API Token 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.
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.
|
| 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.
|
| rights[].appEditable | Boolean | The App management permission of the entity. Entities with this permission are able to access and edit the App's settings.
|
| rights[].recordViewable | Boolean | The record view permission of the entity.
|
| rights[].recordAddable | Boolean | The record add permission of the entity
|
| rights[].recordEditable | Boolean | The record edit permission of the entity.
|
| rights[].recordDeletable | Boolean | The record delete permission of the entity.
|
| rights[].recordImportable | Boolean | The file import permission of the entity.
|
| rights[].recordExportable | Boolean | The file export permission of the entity.
|
| revision | String | The revision number of the App settings. |
Sample Response