Search the API

Authentication

Alphie supports two token styles: Bearer (Personal API Token) and OAuth (Password grant). In both cases, pass the token via the Authorization header.

Bearer (Personal API Token)

# 1) Create a token (as yourself)
curl -s -X POST "https://alphieui.com/api/admin/tokens" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"description":"CLI token"}'

# Response contains: id, token (JWT), expires_at, jti
# 2) Use it
export TOKEN="<PASTE JWT HERE>"
curl -s "https://alphieui.com/api/admin/me" -H "Authorization: Bearer $TOKEN"

OAuth (Password grant)

# Get an access token
curl -s -X POST "https://alphieui.com/api/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=<user>&password=<pass>"
# -> { "access_token": "...", "token_type": "bearer", "expires_in": 3600 }

# Use it
export TOKEN="<ACCESS TOKEN>"
curl -s "https://alphieui.com/api/admin/me" -H "Authorization: Bearer $TOKEN"

Tip: You can also POST JSON to /api/login or /api/oauth/login with {"username":"...","password":"..."} depending on your client needs.

Notes

• All endpoints require authentication unless noted otherwise.
• Most write operations accept and return JSON.
• Timestamps are returned in server-local time strings for UI convenience.
• Long-running operations (runs/pipelines) expose /file-log and /file-log/tail for streaming logs.