HTTP API Reference
This document provides a comprehensive reference for all HTTP endpoints available in the AIOHM platform.
API Structure
The platform exposes three types of routes:
- Central Routes (
routes/web.php): These are for global actions like authentication and asset serving, and are not tied to a specific tenant. - Tenant Routes (
routes/tenant.php): These routes are active only on a tenant's specific domain and handle tenant-level functionality. - API Routes (
routes/api.php): These are the primary data-interchange endpoints. They are typically prefixed with/apiand may include versioning (e.g.,/api/v1/...).
Central Routes
Defined in routes/web.php. These handle global application concerns.
| Method | URI | Name | Controller Action |
|---|---|---|---|
| GET, HEAD | /auth/google/login | google.login | App\Http\Controllers\Auth\GoogleLoginController@redirectToGoogle |
| GET, HEAD | /auth/google/login/callback | google.login.callback | App\Http\Controllers\Auth\GoogleLoginController@handleGoogleCallback |
| GET, HEAD | /auth/google/finish | google.login.finish | App\Http\Controllers\Auth\GoogleFinishController@finish |
| GET, HEAD | /tenancy/assets/{path?} | stancl.tenancy.asset | Closure |
| POST | /livewire/update | default.livewire.update | Closure |
| GET, HEAD | /register | filament.admin.auth.register | Closure |
| POST | /filament/admin/logout | filament.admin.auth.logout | Closure |
| GET, HEAD | /filament/admin/login | filament.admin.auth.login | Closure |
| GET, HEAD | /docs/{path} | Closure | |
| GET, HEAD | /gallery/{path} | Closure | |
| POST | /demo/reset-data | Closure | |
| GET, HEAD | /connections/google-drive/connect | drive.connect | App\Http\Controllers\GoogleDriveController@redirectToDriveConnect |
| GET, HEAD | /connections/google-drive/callback | drive.callback | App\Http\Controllers\GoogleDriveController@handleDriveCallback |
| GET, HEAD | /auth/google/analytics/auth | google.analytics.auth | App\Http\Controllers\GoogleOAuthController@redirect |
| GET, HEAD | /auth/google/analytics/callback | google.analytics.callback | App\Http\Controllers\GoogleOAuthController@callback |
Tenant Routes
Defined in routes/tenant.php. These are active on tenant-specific domains.
| Method | URI | Name | Controller Action |
|---|---|---|---|
| GET, HEAD | /tenant-info | Closure | |
| GET, HEAD | /login | user.login | App\Http\Controllers\Auth\UserLoginController@show |
| POST | /login | user.login.post | App\Http\Controllers\Auth\UserLoginController@authenticate |
| GET, HEAD | /register | user.register | App\Http\Controllers\Auth\UserLoginController@showRegister |
| POST | /register | user.register.post | App\Http\Controllers\Auth\UserLoginController@register |
| POST | /logout | user.logout | App\Http\Controllers\Auth\UserLoginController@logout |
| GET, HEAD | /demo-login | Closure |
API Routes
Defined in routes/api.php and routes/api/v1.php.
Unversioned API
| Method | URI | Name | Controller Action |
|---|---|---|---|
| POST | api/templates/upload | templates.upload | App\Http\Controllers\Api\TemplateController@upload |
| DELETE | api/templates/{id} | templates.delete | App\Http\Controllers\Api\TemplateController@delete |
| POST | api/wp/content/generate | wp.content.generate | App\Http\Controllers\Api\WordPress\ContentController@generate |
| GET, HEAD | api/postiz/auto-login/execute/{token} | postiz.auto-login.execute | App\Http\Controllers\Api\PostizAutoLoginController@executeAutoLogin |
| GET, HEAD | api/wp/post-types | wp.post-types.index | App\Http\Controllers\Api\WordPress\PostTypeController@index |
| POST | api/webhooks/mautic | webhooks.mautic | App\Http\Controllers\Webhooks\MauticWebhookController@handle |
| POST | api/webhooks/postiz | webhooks.postiz | App\Http\Controllers\Webhooks\PostizWebhookController@handle |
Sanctum Authenticated API
These endpoints require authentication via Sanctum.
| Method | URI | Name | Controller Action |
|---|---|---|---|
| GET, HEAD | api/postiz/auto-login/data | postiz.auto-login.data | App\Http\Controllers\Api\PostizAutoLoginController@getAutoLoginData |
| POST | api/postiz/auto-login/token | postiz.auto-login.token | App\Http\Controllers\Api\PostizAutoLoginController@generateAutoLoginToken |
Version 1 API (/api/v1)
The following routes are defined for the V1 API but are currently commented out in the code, pending implementation.
| Method | URI |
|---|---|
| POST | api/v1/ai/chat |
| POST | api/v1/ai/image |
| POST | api/v1/wordpress/posts/sync |
| POST | api/v1/wordpress/media/upload |
| GET, HEAD | api/v1/connections |
MCP Routes (AI Agent/Tooling)
Defined in routes/ai.php. These are not traditional REST APIs but are endpoints for the Model Context Protocol.
| Method | URI | Server Class |
|---|---|---|
| ANY | /mcp/knowledgebase | App\Mcp\Servers\KnowledgebaseServer |
| ANY | /mcp/boost | Laravel\Boost\Mcp\Boost |