Headers

  • X-PLANNR-ACCOUNT-UUID string

Path parameters

  • uuid string Required
application/json

Body

  • name string

    The name of the role.

    Maximum length is 255.

  • description string

    A description of the role.

    Maximum length is 255.

  • permissions array[string]

    An array of permissions in the format "resource:verb".

PUT /api/v2/roles/{uuid}
curl \
 --request PUT 'https://api.plannrcrm.com/api/v2/roles/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"Admin Role","description":"Full administrative access","permissions":["network:read","firm:read","firm:update"]}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Admin Role",
  "description": "Full administrative access",
  "permissions": [
    "network:read",
    "firm:read",
    "firm:update"
  ]
}