Skip to main content

Create Role

POST 
/api/roles

Creates a new role (guard_name is forced to 'sanctum') and syncs the given permissions.

Body fields:

  • name (required, string, max 255, unique in roles)
  • description (optional, string, max 500)
  • permissions (optional, array of permission names; each must exist in permissions)

Authentication: Requires Bearer token.

Requires permission: roles.create

Request​

Responses​

Created

Response Headers
    Content-Type