Skip to main content
POST
/
role-permissions
/
batch
curl -X POST 'https://api.example.com/role-permissions/batch' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '[
    {"roleId": "role_viewer", "permissionId": "permission_read"},
    {"roleId": "role_editor", "permissionId": "permission_read"},
    {"roleId": "role_editor", "permissionId": "permission_write"},
    {"roleId": "role_admin", "permissionId": "permission_read"},
    {"roleId": "role_admin", "permissionId": "permission_write"},
    {"roleId": "role_admin", "permissionId": "permission_delete"}
  ]'

[
  {"id": "role_perm_abc123", "roleId": "role_viewer", "permissionId": "permission_read"},
  {"id": "role_perm_def456", "roleId": "role_editor", "permissionId": "permission_read"},
  {"id": "role_perm_ghi789", "roleId": "role_editor", "permissionId": "permission_write"},
  {"id": "role_perm_jkl012", "roleId": "role_admin", "permissionId": "permission_read"},
  {"id": "role_perm_mno345", "roleId": "role_admin", "permissionId": "permission_write"},
  {"id": "role_perm_pqr678", "roleId": "role_admin", "permissionId": "permission_delete"}
]

​
Overview

Batch creation allows you to assign multiple permissions to roles in a single API call.
ID Format: All IDs use a namespaced UUIDv7 format: role_perm_{uuidv7}.

​
Request Body

Array of role-permission assignment objects:
​
[].roleId
string
required
ID of the role
​
[].permissionId
string
required
ID of the permission to assign

​
Response

Returns an array of created role-permission assignment objects. 
curl -X POST 'https://api.example.com/role-permissions/batch' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '[
    {"roleId": "role_viewer", "permissionId": "permission_read"},
    {"roleId": "role_editor", "permissionId": "permission_read"},
    {"roleId": "role_editor", "permissionId": "permission_write"},
    {"roleId": "role_admin", "permissionId": "permission_read"},
    {"roleId": "role_admin", "permissionId": "permission_write"},
    {"roleId": "role_admin", "permissionId": "permission_delete"}
  ]'

[
  {"id": "role_perm_abc123", "roleId": "role_viewer", "permissionId": "permission_read"},
  {"id": "role_perm_def456", "roleId": "role_editor", "permissionId": "permission_read"},
  {"id": "role_perm_ghi789", "roleId": "role_editor", "permissionId": "permission_write"},
  {"id": "role_perm_jkl012", "roleId": "role_admin", "permissionId": "permission_read"},
  {"id": "role_perm_mno345", "roleId": "role_admin", "permissionId": "permission_write"},
  {"id": "role_perm_pqr678", "roleId": "role_admin", "permissionId": "permission_delete"}
]