Skip to main content

Get permissions on several objects

GET 

/permissions/:object_type

Returns the permissions of the calling API key on several objects of one type, as an object that maps each object identifier to a permission from 0 to 7. The request names each object in a separate object_id query parameter, such as ?object_id=<id>&object_id=<id>. Each permission combines the key's permission on the object type with the key's permission on the object.

Permissions. None. The operation reports the permissions of the calling key, and any valid API key can call the operation.

Access control describes the permission model.

Request​

Responses​

The body maps each requested object identifier to the calling key's permission on the object, a number from 0 to 7, whether or not the object exists. A request without object_id returns an empty object.