Evaluate Record Permissions

Evaluates the API user's permissions for records and fields within an App..
Method GET
URL https://{subdomain}.kintone.com/k/v1/records/acl/evaluate.json
URL(guest space) https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/records/acl/evaluate.json
Authentication Password Authentication
Content-Type  

Permissions

Permission to view the App is needed.
API Tokens cannot be used with this API.

Request Parameters

Parameter Value Required Description
app Integer or String Yes The App ID.
ids Array Yes An array of record IDs that will be evaluated.
The maximum limit is 100 IDs.

 

Example of parameters in the URL

Example of parameters in the request body

Sample Request

JavaScript (using Kintone REST API Request)

 

XMLHttpRequest

 

Response Parameters

Parameter Type Description
rights Array An array of objects that contain permission settings of the specified records.
rights[].id String The record ID.
rights[].record Object An object consisting of record permissions of the specified record ID.
rights[].record.viewable Boolean The view permissions of the specified record ID.
rights[].record.editable Boolean The edit permissions of the specified record ID.
rights[].record.deletable Boolean The delete permissions of the specified record ID.
rights[].fields Object

An object consisting of field permissions of the specified record ID.
The following are also included in the response:

  • fields that the user has no permissions to view
  • fields that have no permission settings set on them
  • fields that do not allow permissions to be set
  • fields set in tables
rights[].fields.<fieldcode>.viewable Boolean The view permissions of the field of the specified record ID. If the user has no view permissions of the record, all the values are set as false.
rights[].fields.<fieldcode>.editable Boolean The edit permissions of the field of the specified record ID.

Sample Response

Was this article helpful?
0 out of 0 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!