Skip to main content

Observability

Requires LoftAdmin authorization.

GET /api/admin/observability/sla/

Get organization-level SLA overview.
curl
curl -H "Authorization: Bearer YOUR_JWT" \
  "https://api.pidgeon.health/api/admin/observability/sla/org-uuid?from=2026-02-01&to=2026-02-22"

GET /api/admin/observability/sla//violations

Get SLA violations for an organization.
curl
curl -H "Authorization: Bearer YOUR_JWT" \
  "https://api.pidgeon.health/api/admin/observability/sla/org-uuid/violations?from=2026-02-01"

GET /api/admin/observability/metrics/cost

Get infrastructure cost metrics.
curl
curl -H "Authorization: Bearer YOUR_JWT" \
  https://api.pidgeon.health/api/admin/observability/metrics/cost

SSO Configuration

Requires LoftAdmin authorization.

GET /api/loft/sso/providers

List configured SSO providers.
curl
curl -H "Authorization: Bearer YOUR_JWT" \
  https://api.pidgeon.health/api/loft/sso/providers

POST /api/loft/sso/configure

Configure an SSO provider.
curl
curl -X POST https://api.pidgeon.health/api/loft/sso/configure \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "providerType": "oidc",
    "displayName": "Corporate SSO",
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "issuerUrl": "https://login.corp.com",
    "jitProvisioning": true
  }'

DELETE /api/loft/sso/providers/

Remove an SSO provider.
curl
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \
  https://api.pidgeon.health/api/loft/sso/providers/oidc

Audit Logs

Requires LoftAdmin authorization.

GET /api/loft/audit/

Query audit logs.
Query ParamTypeDescription
actionstringFilter by action type
resourceTypestringFilter by resource
fromISO 8601Start time
toISO 8601End time
limitintMax results
offsetintPagination offset
curl
curl -H "Authorization: Bearer YOUR_JWT" \
  "https://api.pidgeon.health/api/loft/audit/?action=role.assign&limit=50"

GET /api/loft/audit/export

Export audit logs as CSV or JSON.
curl
curl -H "Authorization: Bearer YOUR_JWT" \
  "https://api.pidgeon.health/api/loft/audit/export?format=csv&from=2026-02-01" \
  -o audit.csv

Feature Flags

GET /api/features

Get feature flags. Public — returns org-specific flags if authenticated, global flags otherwise.
curl
curl https://api.pidgeon.health/api/features

Health Check

GET /api/health

Health check endpoint. Public.
curl
curl https://api.pidgeon.health/api/health
{
  "status": "healthy",
  "timestamp": "2026-02-22T14:30:00Z",
  "version": "1.0.0",
  "uptimeSeconds": 86400,
  "checks": {
    "database": "healthy",
    "cache": "healthy"
  }
}