Creating requests

The Requests facade is the discoverable entry point. The fully-qualified RoundlyConsulting\Requests\Facades\Requests always works; a short Requests alias is also registered when the name is free:

use RoundlyConsulting\Requests\Facades\Requests;

$request = Requests::make()
    ->author($user)
    ->type('Claim')
    ->title('Expense reimbursement')
    ->description('Travel costs for the client visit.')
    ->meta(['ip' => request()->ip()])
    ->requireApprovalsFrom([$alice, $bob])   // saved approver models — only they may decide
    ->expiresAt(now()->addDays(7))
    ->create();

create() saves the request, associates the author, opens the approval flow when approvers, stages or a workflow are given, and dispatches RequestCreated. requireApprovalsFrom() accepts a saved model or a list of them — only they, or their delegates, may decide, and their keys are recorded in require_approvals_from. A bare id is refused with InvalidApprover. The request and its approval round are written together, so a round that can’t open leaves no request behind.

Builder reference

Requests without approvers

Declaring approvers is optional. Without them no approval request is opened, and the first approve or reject resolves the request immediately:

// No approvers declared — the first decision resolves the request.
$request = Requests::make()
    ->author($user)
    ->type('AccessRequest')
    ->title('Access to the billing dashboard')
    ->create();

Building the DTO only

toDto() returns the assembled CreateRequestDto without saving — handy for queueing or for passing to the manager later:

// Build the DTO without persisting, then hand it to the manager.
$dto = Requests::make()
    ->author($user)
    ->title('Expense reimbursement')
    ->toDto();

$request = Requests::create($dto);

Expiry

expiresAt() stamps a deadline on the request. Without it, requests.default_ttl (in minutes) applies when set; otherwise the request never expires on its own (Cancel & expire).