Skip to main content
GET
/
permissions
/
{permission_id}
Get a Permission
curl --request GET \
  --url https://api.emulator.farm/v1/permissions/{permission_id} \
  --header 'X-EMULATOR-FARM-API-KEY: <api-key>'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "role_id": "550e8400-e29b-41d4-a716-446655440000",
  "operation": "builds:create",
  "created_at": "2025-12-10T12:00:00Z"
}

Authorizations

​
X-EMULATOR-FARM-API-KEY
string
header
required

Path Parameters

​
permission_id
string<uuid>
required

The unique identifier of the Permission

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

Permission retrieved successfully

​
id
string<uuid>
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
role_id
string<uuid>
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
operation
enum<string>
required
Available options:
builds:create,
builds:get,
builds:list,
builds:delete,
instances:create,
instances:get,
instances:list,
instances:delete,
users:create,
users:get,
users:list,
users:edit,
users:delete,
service_accounts:create,
service_accounts:get,
service_accounts:list,
service_accounts:delete,
roles:create,
roles:get,
roles:list,
roles:edit,
roles:delete,
permissions:create,
permissions:get,
permissions:list,
permissions:delete,
role_bindings:create,
role_bindings:get,
role_bindings:list,
role_bindings:delete
​
created_at
string<date-time>
required
Example:

"2025-12-10T12:00:00Z"