Developer
Robomap API
HTTPS JSON API for the Robomap platform: authentication, on-demand services, devices, workspace data, account management, and integrations.
Overview
Production base URL: https://api.robomap.ai
Web app proxy: https://app.robomap.ai/api/ rewrites to the same backend for same-origin browser requests.
Machine API prefix: https://api.robomap.ai/api/ for Passport-protected integrations.
All requests use HTTPS. JSON is returned unless noted otherwise.
Authentication
The API supports three access patterns:
- Browser session — cookie-based login via
POST /auth/loginfor the Angular app. - Bearer access token — returned by login/OAuth and sent as
Authorization: Bearer <token>. - Passport OAuth 2.0 — machine clients under
/api/oauth/*and/api/devices,/api/data.
Authorization: Bearer YOUR_ACCESS_TOKENSocial sign-in entry points:
| Method | Endpoint | Description |
|---|---|---|
| GET | /auth/google |
Redirect to Google OAuth. Optional ?returnUrl=/home. |
| GET | /auth/callback |
Google OAuth callback. |
| GET | /auth/apple |
Redirect to Apple Sign In. |
| POST | /auth/apple/callback |
Apple OAuth callback (form_post). |
Public endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /auth/login |
Email/password login. Returns access_token and user payload. |
| POST | /auth/register |
Create a user or business account. |
| POST | /auth/logout |
End the current browser session. |
| GET | /auth/me |
Current authenticated user (session). |
| GET | /auth/oauth/bootstrap |
Resolve a bearer token to a user after social login. |
| GET | /utilities/countries |
Country list for registration forms. |
| GET | /utilities/phone-prefixes |
International phone prefixes. |
| GET | /on-demand-services/catalog |
Public service categories and catalog metadata. |
| POST | /assistant/chat |
Platform assistant chat endpoint. |
| GET | /api/ping |
Health probe. Returns empty JSON object. |
| GET | /api/check |
Extended API status check. |
Authenticated session API
Requires a logged-in browser session or valid bearer token. Base path: https://api.robomap.ai
On-demand services
| Method | Endpoint | Description |
|---|---|---|
| GET | /on-demand-services/map | Map data for active service activity. |
| GET | /on-demand-services/requests | List service requests for the current user. |
| POST | /on-demand-services/requests | Create a new on-demand service request. |
| GET | /on-demand-services/business/available | Requests available to business providers. |
| GET | /on-demand-services/business/assignments | Assignments claimed by the business. |
| POST | /on-demand-services/business/requests/{id}/claim | Claim a request. |
Devices and workspace data
| Method | Endpoint | Description |
|---|---|---|
| GET | /devices | List devices. |
| POST | /devices | Create a device. |
| PUT | /devices/{id} | Update a device. |
| DELETE | /devices/{id} | Delete a device. |
| GET | /data | List workspace data records. |
| POST | /data | Create a data record. |
| PUT | /data/{id} | Update a data record. |
| DELETE | /data/{type}/{id} | Delete a typed data record. |
| GET | /settings | Read workspace settings. |
| POST | /settings | Update workspace settings. |
Account, notifications, and administration
| Method | Endpoint | Description |
|---|---|---|
| GET | /account/getuserdata | Current profile data. |
| POST | /account/user-profile | Update profile fields. |
| GET | /account/business-profile | Business profile for provider accounts. |
| GET | /account/plans | Subscription plan catalog. |
| GET | /notifications | In-app notifications. |
| GET | /administration/users | Organization user list. |
| GET | /administration/organizations | Organizations for the active account. |
Machine API
Passport-protected integrations use the /api prefix.
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/oauth/token | Issue an OAuth access token. |
| POST | /api/oauth/clients | Register an OAuth client. |
| POST | /api/devices | Create a device via API token. |
| POST | /api/data | Ingest workspace data via API token. |
OAuth 2.0
Robomap uses Laravel Passport for machine-to-machine access. Token and client management routes are available under /oauth/* and /api/oauth/*.
curl -X POST https://api.robomap.ai/api/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"Example: login
curl -X POST https://api.robomap.ai/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"user@example.com","password":"your-password"}'Example: countries
curl https://api.robomap.ai/utilities/countries