Get App Permissions

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

  • Perrmission 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

JavaScript (using kintone REST API Request)

XMLHttpRequest

Response Parameters

Parameter Type Description
rights Array An array listing 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

Was this article helpful?
0 out of 0 found this helpful
Comments
Please sign in to leave a comment.