Skip to content

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.

RouteAuthPurpose
GET /healthNoneAlways 200. Body: {"status":"ok","model_ready":<bool>,"port":<int>}
GET /auth/configNone{"google_client_id":"…","password_auth":<bool>} for the login screen
POST /auth/googleNone (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/refreshRefresh tokenExchanges a refresh token for a new pair in the same session. Refused once the session is signed out.
POST /auth/logoutThe session cookieRevokes 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 URLGenerated media, decrypted from the sealed store
GET /podcast/feed.xmlNone, on purposeThe podcast RSS feed that podcast platforms poll. Needs PULSE_PUBLIC_BASE_URL.
POST /voice/webrtc/offerSessionForwards a WebRTC offer to the calling agent (CALLING_AGENT_URL). 503 when that is not set.
POST /voice/transcribeSessionRaw PCM in, {"text":"…"} out, via Voxtral
GET /.well-known/agent-card.jsonNoneThe A2A agent card
/a2aSession (bearer header only)A2A JSON-RPC. See Calling the API.
POST /twilio/messageTwilio signatureInbound WhatsApp and SMS
POST /inbound/leads/<secret> (and OPTIONS)The secret in the path; no session, no cookieA 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/statusTwilio signatureDelivery-status callbacks for messages and calls sent from the Send / Call panel. An unsigned callback is refused and changes nothing.
POST /comms/twilio/inboundTwilio signatureReplies 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/statusTwilio signatureAn 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 answerThe AI call’s audio over a WebSocket.
GET /oauth/mail/callbackThe single-use state from the connect linkGoogle or Microsoft returns here after Connect Gmail or Connect Microsoft 365.
GET /oauth/social/callbackThe single-use state from StartSocialConnectMeta, 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/callbackThe single-use state from StartSearchConsoleConnectGoogle returns here after Connect Search Console.
anything elseNoneNot 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.