Document APIs Built with lorisleiva/laravel-actions

Laravel Actions (lorisleiva/laravel-actions) organizes application business logic into reusable action classes that can run as controllers, jobs, listeners, or commands. Geni natively understands this pattern — it detects Action classes registered as routes, resolves the correct execution method, extracts validation rules, documents authorization responses, and derives human-readable operation summaries, all without booting your application.

Routing Resolution

In Laravel Actions, single-action routes are commonly registered by passing the action class name directly to the router:

routes/api.php

use App\Actions\CreateUser;
use App\Actions\PublishArticle;
use Illuminate\Support\Facades\Route;

Route::post('/users', CreateUser::class);
Route::post('/articles/{article}/publish', PublishArticle::class);

When Geni encounters these routes, it:

Inspects the AST of the target class

Geni traverses the source file for the registered Action class.

Detects the AsAction trait or method presence

It checks for the Lorisleiva\Actions\Concerns\AsAction trait or equivalent method signatures.

Selects the execution method

It prefers asController() as the controller entry point, falling back to handle() if asController() is not defined.

Validation Extraction

When an Action class defines a rules() method or accepts an ActionRequest, Geni statically parses the returned rules array exactly as it does for dedicated Form Requests:

namespace App\Actions;

use Lorisleiva\Actions\ActionRequest;
use Lorisleiva\Actions\Concerns\AsAction;

class CreateUser
{
    use AsAction;

    public function authorize(ActionRequest $request): bool
    {
        return $request->user()->can('create-users');
    }

    public function rules(): array
    {
        return [
            'name'  => ['required', 'string', 'max:255'],
            'email' => ['required', 'email', 'unique:users,email'],
        ];
    }

    public function asController(ActionRequest $request)
    {
        // ...
    }
}

From the rules() method above, Geni produces a request body schema with:

name: type: string, maxLength: 255, marked required.
email: type: string, format: email, marked required.

Automatic 403 Response

When an action class defines an authorize() method containing non-trivial logic (i.e., not simply return true;), Geni automatically documents a 403 Forbidden response alongside the standard success response:

"403": {
  "description": "This action is unauthorized."
}

You do not need to annotate this manually — Geni detects the presence of real authorization logic through static analysis.

Operation Summary Derivation

When no explicit @summary annotation or #[Endpoint] title is present on an action method, Geni derives a clean, human-readable summary by splitting the action class name on word boundaries and removing common suffixes like Action:

Class Name	Generated Summary
`CreateUser`	`"Create user"`
`PublishArticleAction`	`"Publish article"`
`ExportMonthlyReport`	`"Export monthly report"`

Getting Started

Core Concepts

Integrations

Annotations

Guides

Reference

Document APIs Built with lorisleiva/laravel-actions

Routing Resolution

Validation Extraction

Automatic 403 Response

Operation Summary Derivation

​Routing Resolution

​Validation Extraction

​Automatic 403 Response

​Operation Summary Derivation

Routing Resolution

Validation Extraction

Automatic 403 Response

Operation Summary Derivation