API reference

The Reflex API is a RESTful JSON API available at https://reflex.expertweb.tools/api/v1.

Authentication

All API requests require a Bearer token. Generate an API token from your dashboard under Settings → API Tokens.

Authorization: Bearer <your-api-token>

Include this header in every request. Example:

curl -H "Authorization: Bearer $REFLEX_API_TOKEN" \
  https://reflex.expertweb.tools/api/v1/servers

Tokens are scoped to a team. Each token can be given a name and revoked individually.

Base URL

https://reflex.expertweb.tools/api/v1

Rate limits

Tier	Requests per minute
Solo	60
Studio	120
Agency	300

Rate limit headers are included in every response:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1714834200

Common endpoints

Servers

Method	Endpoint	Description
GET	/servers	List all servers
GET	/servers/{id}	Get server details
GET	/servers/{id}/metrics	Get server metrics

Deployments

Method	Endpoint	Description
GET	/deployments	List deployments
POST	/deployments/trigger	Trigger a deployment
GET	/deployments/{id}	Get deployment status
POST	/deployments/{id}/rollback	Rollback a deployment

Incidents

Method	Endpoint	Description
GET	/incidents	List incidents
GET	/incidents/{id}	Get incident details
GET	/incidents/{id}/timeline	Get incident timeline

Response format

All responses follow a consistent format:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-05-04T10:30:00Z"
  }
}

Error format

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The server_id field is required.",
    "request_id": "req_abc123"
  }
}

Webhooks

Reflex can send webhook notifications for deployments, incidents, and server status changes. Configure webhooks in your dashboard under Settings → Webhooks.

See Webhooks for payload formats and verification.

OpenAPI specification

The full OpenAPI 3.1 specification is available at:

https://reflex.expertweb.tools/openapi/v1.json

Interactive API documentation is available at /api/docs.