Skip to main content
POST
/
permissions
Create a new Permission
curl --request POST \
  --url https://api.emulator.farm/v1/permissions \
  --header 'Content-Type: application/json' \
  --header 'X-EMULATOR-FARM-API-KEY: <api-key>' \
  --data '
{
  "role_id": "550e8400-e29b-41d4-a716-446655440000",
  "operation": "builds:create"
}
'
{
  "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

Body

application/json
​
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

Response

Permission created 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"