Cloud HTTP API

Base URL (prod):

https://api.bissap.dev

The Cloud API is used by the SDK internally when running in hybrid or cloud mode. You do not need to call these endpoints directly. The SDK handles all Cloud communication.

Auth types

SDK auth (server → Cloud)

Used by your backend server (automatic when Cloud mode is configured).

Headers:

• Authorization: Bearer <bss_...sdkSecret>
• x-bissap-project: <projectId>

Agent key auth (agent → your app)

Used by AI agents calling your app's intents.

Header:

• Authorization: Bearer <bs_live_...>

For SDK endpoint documentation, see:

• Node SDK
• Python SDK