Partners
Offer Dcision inside your own app — one sub-workspace per customer, an embeddable editor for your end users and usage billed to your workspace.
Partner mode lets an app that uses Dcision offer it to its own customers: each customer gets their own decisions, edits them inside your app and never needs a Dcision account. You pay for the usage.
your backend ──(your API key)──▶ POST /v1/workspaces one sub-workspace per customer (external_id)
your backend ──(your API key)──▶ POST /v1/embed/sessions a session for the signed-in user → { url }
your page ──(iframe, url)───▶ app.dcision.io/embed/… the decision editor, inside your app
your backend ──(your API key + Dcision-Workspace: ext:<id>)──▶ POST /v1/decisions/{slug} runs the customer's decisionTurn it on
- Settings → Partner in the app: turn on partner mode and add the allowed origins — the exact
https://hostof the pages that will show the editor. Only those pages can frame it. - Optional: a display name (shown to your customers), default limits per customer (decisions, runs per billing cycle) and whether your customers' LLM destinations may use your LLM keys.
- Partner mode needs a plan with sub-workspaces (see plans). The plan's decision limit counts your customers' decisions too.
What lives where
| Your workspace (parent) | A customer's sub-workspace | |
|---|---|---|
| Decisions, versions, executions | Your own | The customer's, isolated |
| API keys, team, billing, secrets | Yes | None — your key acts in it with Dcision-Workspace |
| Engine settings and engine keys (BYOK) | Yours | Yours (inherited) |
| Plan, wallet, rate limits | Yours | Yours (usage counts in your workspace) |
| Inbound webhook (Advanced tab) | Yes | No |
Next
- Sub-workspaces: create them, run their decisions, limits and usage.
- Embed the editor: sessions, permissions, the
@dcision/embedscript and events. - API reference: workspaces and embed sessions.
Python SDK
The dcision package for Python 3.9+ — build from source, decide, destinations and functions, errors, idempotent retries, executions, me() and webhook verification with Flask or FastAPI.
Sub-workspaces
One sub-workspace per customer of your app, by your own id — create it, copy your decisions into it, run them with Dcision-Workspace, limit and watch its usage.