Laravel

Laravel Roles API

The Roles API from Laravel — 7 operation(s) for roles.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /predefined-roles List Forge's predefined roles · List predefined roles #
Ask an LLM
“What built-in roles are available out of the box?”
“Which predefined roles include a given permission?”
Tell an agent
List the predefined roles.
Show predefined roles that include permission {permission}.
GET /predefined-roles/{role} Get a predefined role · Get predefined role #
Ask an LLM
“What permissions does a specific built-in role grant?”
“Can I inspect one predefined role before assigning it?”
Tell an agent
Show predefined role {role}.
Get the built-in role {role} and its permissions.
GET /permissions List all available permissions · List permissions #
Ask an LLM
“Which permissions can I assign to a role?”
“Can I search the permission catalog by name?”
Tell an agent
List all permissions.
Find permissions named {name}.
GET /permissions/{permission} Get a permission · Get permission #
Ask an LLM
“What does a specific permission allow?”
“Where can I look up a single permission's details?”
Tell an agent
Show permission {permission}.
Describe what permission {permission} grants.
POST /orgs/{organization}/roles Create a custom role · Create role #
Ask an LLM
“How do I create a custom role for my organization?”
“Can I set a role's permissions at the moment I create it?”
Tell an agent
Create role {name} in organization {organization}.
Add role {name} to {organization} with permissions {permissions}.
GET /orgs/{organization}/roles List my organization's custom roles · List roles #
Ask an LLM
“What roles has my organization defined?”
“Which of our custom roles carry a certain permission?”
Tell an agent
List roles in organization {organization}.
Show our roles in {organization} that have permission {permission}.
GET /orgs/{organization}/roles/{role} Get one of my organization's roles · Get role #
Ask an LLM
“What are the details of a custom role in my organization?”
“Which permissions and description does one specific role of ours have?”
Tell an agent
Show role {role} in organization {organization}.
Get our custom role {role}.
PUT /orgs/{organization}/roles/{role} Edit a custom role · Update role #
Ask an LLM
“How do I change the permissions on an existing role?”
“Can I rename a role and add a description?”
Tell an agent
Update role {role} in {organization}: name {name}, permissions {permissions}.
Rename our role {role} to {name} with description {description}.
DELETE /orgs/{organization}/roles/{role} Delete a custom role · Delete role #
Ask an LLM
“How do I remove a role we no longer use?”
“Can I delete a custom role from my organization?”
Tell an agent destructive · confirm first
Delete role {role} from organization {organization}.
Remove our custom role {role}.
GET /orgs/{organization}/roles/{role}/permissions List the permissions on a role · List role permissions #
Ask an LLM
“Which permissions does one of our roles have?”
“Does a particular role include a permission I'm looking for?”
Tell an agent
List permissions on role {role} in {organization}.
Check whether role {role} has permission {name}.

Documentation

📖
Documentation
https://forge.laravel.com/docs/api-reference/introduction
📖
APIReference
https://forge.laravel.com/docs/api-reference/introduction
📖
Documentation
https://cloud.laravel.com/docs/api/authentication
📖
APIReference
https://cloud.laravel.com/docs/api/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/laravel/refs/heads/main/openapi/laravel-roles-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/laravel:laravel-roles-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

laravel-roles-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Forge Roles API
  version: 0.0.1
  description: Laravel Forge - API Documentation
servers:
- url: https://forge.laravel.com/api
security:
- http: []
- oauth2: []
tags:


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/laravel/refs/heads/main/openapi/laravel-roles-api-openapi.yml