API Reference — Servio

POST/v1/auth/sessions

Stable

Create an authenticated session for a role.

Request

curl -X POST https://api.servio.app/v1/auth/sessions \
  -H "Authorization: Bearer $SERVIO_KEY" \
  -H "Content-Type: application/json"

Response 200

{
  "token": "sk_live_...",
  "user": { "id": "u_123", "role": "customer" }
}

Authentication

Bearer tokens. Rotate every 90 days. Per-role scopes enforced server-side.

Rate limits

600 req/min per token. 429 with Retry-After header on burst.

Webhooks

Signed with HMAC-SHA256. Retries with exponential back-off for 24h.

SDKs

Official client libraries kept in lock-step with the API.

TypeScript

Python

Ruby