1.x

Routing

Declarative HTTP routes, middleware stacks, and versioned API prefixes.

Routes in Atlas are declared in PHP files and compiled into a cached route map for production. Version 3 introduces typed route parameters and first-class API version prefixes.

Basic routing

phproutes/web.php

use Atlas\Routing\Route;

Route::get('/projects/{project:uuid}', [ProjectController::class, 'show'])
    ->middleware(['auth', 'throttle:api']);

API version prefixes

GET/api/v3/projects

List projects visible to the authenticated workspace.

Parameter	Type	Description
limit	integer	Maximum number of results
cursor	string	Opaque cursor from a previous response

Info

Keep public docs aligned with the route prefix you ship. Publishing a 3.x release while examples still show /api/v2 confuses integrators.

Named routes

Prefer route('projects.show', $project) over hard-coded paths so renames stay safe across minor releases.

Project structure

Data access

Updated Aug 5, 2026