HTTP endpoints
Besides gRPC and gRPC-Web, the backend answers a short, fixed list of plain HTTP routes on the same port. None of them is a data API. Campaigns, content, leads, and everything else are gRPC only.
| Route | Auth | Purpose |
|---|---|---|
GET /health | None | Always 200. Body: {"status":"ok","model_ready":<bool>,"port":<int>} |
GET /auth/config | None | {"google_client_id":"…","password_auth":<bool>} for the login screen |
POST /auth/google | None (it is the sign-in) | Exchanges a Google ID token for a PULSE session. Same JSON shape as Login. With x-pulse-session: cookie it sets the session cookie and returns no token. A refusal is JSON {"error": <code>, "message": …} (plus "email" for not_allowed), with codes not_configured (503), missing_token (400), csrf, sso_closed, not_allowed (403), invalid_token, wrong_client, email_unverified (401) and server_error (500). |
POST /auth/refresh | Refresh token | Exchanges a refresh token for a new pair in the same session. Refused once the session is signed out. |
POST /auth/logout | The session cookie | Revokes the browser session and clears the cookie. It clears the cookie even when the session has already expired, which is how a stale one is cleaned up. |
/creatives/<name>, /media/<name> | The owner’s session, or a server-signed URL | Generated media, decrypted from the sealed store |
GET /podcast/feed.xml | None, on purpose | The podcast RSS feed that podcast platforms poll. Needs PULSE_PUBLIC_BASE_URL. |
POST /voice/webrtc/offer | Session | Forwards a WebRTC offer to the calling agent (CALLING_AGENT_URL). 503 when that is not set. |
POST /voice/transcribe | Session | Raw PCM in, {"text":"…"} out, via Voxtral |
GET /.well-known/agent-card.json | None | The A2A agent card |
/a2a | Session (bearer header only) | A2A JSON-RPC. See Calling the API. |
POST /twilio/message | Twilio signature | Inbound WhatsApp and SMS |
POST /inbound/leads/<secret> (and OPTIONS) | The secret in the path; no session, no cookie | A website enquiry becomes a lead. Form-encoded, multipart or JSON, at most 16 KiB. CORS only for the sites listed on the link. Served ahead of every other route, including gRPC-Web and the deployment-wide CORS headers. See Website form. |
POST /comms/twilio/status | Twilio signature | Delivery-status callbacks for messages and calls sent from the Send / Call panel. An unsigned callback is refused and changes nothing. |
POST /comms/twilio/inbound | Twilio signature | Replies to PULSE’s SMS sender: STOP and START (and their synonyms) are recorded for the number; other replies are not stored. Refuses everything (503) while no Twilio auth token is set. |
POST /pulse/aicall/twilio/answer, POST /pulse/aicall/twilio/status | Twilio signature | An AI call’s answer (a person gets the disclosure and the conversation, a voicemail the short message) and its final status. |
/pulse/aicall/twilio/stream/<token> | A single-use token minted by the signed answer | The AI call’s audio over a WebSocket. |
GET /oauth/mail/callback | The single-use state from the connect link | Google or Microsoft returns here after Connect Gmail or Connect Microsoft 365. |
GET /oauth/social/callback | The single-use state from StartSocialConnect | Meta, Google or LinkedIn returns here after Connect with Instagram, YouTube or LinkedIn; the tokens are sealed and the window shows the result. |
GET /oauth/search-console/callback | The single-use state from StartSearchConsoleConnect | Google returns here after Connect Search Console. |
| anything else | None | Not found (404). The backend serves no web app; PULSE is an Android and iOS app. |
Requests with gRPC-Web content types go to the gRPC server before any of these routes are checked.
The three /oauth/…/callback routes are what you register as redirect URIs
in each developer console, under PULSE_PUBLIC_BASE_URL. The social and Search Console sign-ins are
offered only when that address is https. The TIDE edge must route them to the
backend. See Public address and redirects.