Skip to main content
The Pidgeon Bridge API provides programmatic access to all Pidgeon features. The Console and CLI both use this same API. Base URL: https://api.pidgeon.health

​
Authentication

Two authentication schemes are supported. Include one on protected endpoints:

​
Response Format

​
Authorization Policies

PolicyRequirement
PublicNo authentication required
AuthenticatedValid JWT or API Key
OrgMemberAuthenticated + org_id claim
LoftViewerOrgMember + Viewer role
LoftOperatorOrgMember + Operator role
LoftEditorOrgMember + Editor role
LoftAdminOrgMember + Admin role

​
Rate Limits

TierLimit
Free100 requests/minute
Pro1,000 requests/minute
EnterpriseCustom
Rate limit headers are included in every response:
  • X-RateLimit-Limit — Maximum requests per window
  • X-RateLimit-Remaining — Remaining requests
  • X-RateLimit-Reset — Window reset timestamp

​
Endpoint Groups

GroupAuthDescription
GeneratePublicSynthetic message generation
ValidatePublicMessage validation
DiffPublicMessage comparison
AI TriagePublicAI-powered failure analysis
Loft InterfacesPublicInterface CRUD + metrics
Loft AlertsPublicAlert management
Loft StatusPublicStatus and reports
AnalyticsPublicTime-series and dashboards
TracesPublicPatient tracing and gaps
FlockPublicPopulation generation
AdminLoftAdminRBAC, workspaces, SLA
EnterpriseLoftAdminSSO, audit, observability
SignalRJWT/API KeyReal-time updates

​
Content Type

All request and response bodies use JSON. Set Content-Type: application/json on all requests with a body.