Update Role

Update an existing role’s code, name, description, and permission assignments.

Endpoint

/api/v1/projects/{project_id}/roles/{role_id}

Method

PUT

Path Parameters

Parameter	Type	Required	Description
`project_id`	`string`	Yes	Unique ID of the project
`role_id`	`string`	Yes	Unique ID of the role

Headers

Header	Required	Description
`Content-Type`	Yes	`application/json`
`Authorization`	Yes	Bearer access token: `Bearer <access_token>`

Request Body

Field	Type	Required	Description
`code`	`string`	Yes	Role code (alphanumeric, dash, underscore, max 50 chars)
`name`	`string`	Yes	Role name (max 50 chars)
`description`	`string`	No	Description (max 200 chars)
`permission_ids`	`array of strings`	No	List of permission IDs to assign to role

Required Permission

roles:update

Examples

curl --request PUT \
  --url https://auth.roled.id/api/v1/projects/2JUSLUee46xG6iEwG8JwPc/roles/2JRtjyxfZudzaJkFczgoUY \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJo...' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Store Manager Updated",
    "code": "store-manager-updated",
    "description": "Manages store operations including products, orders, and staff with enhanced permissions",
    "permission_ids": [
      "2JUUyotLUqz5eqsuYXXDet",
      "2JUUyotLUr7SuBqkzjRbTc",
      "2JUUyotLUrApxL7zcx7Xoy",
      "2JUUyotLUrDfBK9iwe25jj",
      "2JRjbZKS7f4oRkDaAD4gAF",
      "2JRjbZKS7fJAfNjgShH3TE",
      "2JRjbZKS7h72qSpPAJBuSj",
      "2JRjbZKS7hJfHq9yRzVqhV",
      "2JRjbZKS7feihqSQx5D8yf"
    ]
  }'

{
  "success": true,
  "data": {
    "id": "2JRtjyxfZudzaJkFczgoUY",
    "created_at": "2026-07-16T14:30:00Z",
    "updated_at": "2026-07-29T08:30:00Z",
    "code": "store-manager-updated",
    "name": "Store Manager Updated",
    "description": "Manages store operations including products, orders, and staff with enhanced permissions",
    "permissions": [
      {
        "id": "2JUUyotLUqz5eqsuYXXDet",
        "resource_name": "Products",
        "permission_name": "Create"
      },
      {
        "id": "2JUUyotLUr7SuBqkzjRbTc",
        "resource_name": "Products",
        "permission_name": "Read"
      },
      {
        "id": "2JUUyotLUrApxL7zcx7Xoy",
        "resource_name": "Products",
        "permission_name": "Update"
      },
      {
        "id": "2JUUyotLUrDfBK9iwe25jj",
        "resource_name": "Products",
        "permission_name": "Delete"
      },
      {
        "id": "2JRjbZKS7f4oRkDaAD4gAF",
        "resource_name": "Orders",
        "permission_name": "Read"
      },
      {
        "id": "2JRjbZKS7fJAfNjgShH3TE",
        "resource_name": "Orders",
        "permission_name": "Update"
      },
      {
        "id": "2JRjbZKS7h72qSpPAJBuSj",
        "resource_name": "Users",
        "permission_name": "Read"
      },
      {
        "id": "2JRjbZKS7hJfHq9yRzVqhV",
        "resource_name": "Users",
        "permission_name": "Update"
      },
      {
        "id": "2JRjbZKS7feihqSQx5D8yf",
        "resource_name": "Roles",
        "permission_name": "Read"
      }
    ]
  }
}

Error Codes

Code	HTTP Status	Description
`invalid_params`	400	Missing or invalid request params, headers, or body
`invalid_authorization_token`	401	Missing or invalid authorization token
`insufficient_permission`	403	Insufficient permission
`project_not_found`	404	Project not found
`role_not_found`	404	Role not found
`some_permissions_not_found`	404	One or more specified permission IDs not found
`role_code_already_used`	409	Role with the same code already exists
`system_error`	500	Internal server error

Create Role Delete Role