1. Create mapping session
Open a zero-config session for the workflow and provider.
Loading…
API documentation
Quickstart
Start by validating a sample payload through signal mapping. Once the mapping is accepted, issue the deployment bundle, store the returned env values, send live events through the webhook ingress route, and use the Decision Dossier surfaces for retrieval or verification.
Steps
This is the default order for a new enterprise integration.
2. Upload samples
Upload representative payloads so Decionis can infer the source schema.
3. Issue deployment bundle
Return the org ID, API key, connector ID, webhook secret, and webhook URL in one step.
4. Send live traffic
Post live provider events into the issued Decionis webhook.
5. Verify dossier
Use the Decision Dossier routes to prove the governed output.
Request flow
This is the smallest useful command sequence for a partner integration.
# 1. Create a mapping session
curl -X POST https://api.decionis.com/v1/public/pilot/signal-mapping/sessions \
-H "Authorization: Bearer sk_org_xxx" \
-H "Content-Type: application/json" \
-d '{"org_id":"<org_uuid>"}'
# 2. Upload a representative sample
curl -X POST https://api.decionis.com/v1/public/pilot/signal-mapping/sessions/<session_id>/upload \
-H "Authorization: Bearer sk_org_xxx" \
-H "Content-Type: application/json" \
-d @sample-events.json
# 3. Run the dry-run verdict
curl -X POST https://api.decionis.com/v1/public/pilot/signal-mapping/sessions/<session_id>/dry-run \
-H "Authorization: Bearer sk_org_xxx"
# 4. Issue the deployment bundle
curl -X POST https://api.decionis.com/v1/public/pilot/signal-mapping/sessions/<session_id>/deployment-bundle \
-H "Authorization: Bearer sk_org_xxx" \
-H "Content-Type: application/json" \
-d '{"provider_key":"enilo_ai","workflow_key":"eligibility_assessment","source_label":"enilo_primary"}'
# 5. Store the returned env values and send live traffic
curl -X POST https://api.decionis.com/v1/signals/webhooks/<connector_id> \
-H "Content-Type: application/json" \
-H "x-webhook-secret: whsec_xxx" \
-d '{"events":[{"type":"eligibility_assessed","timestamp":"2026-03-11T10:30:00Z","data":{"case_id":"case_123","outcome":"CONDITIONAL","risk_score":0.28,"channel":"study_abroad"}}]}'Reference paths
Use these pages for the full route and payload details.
| Need | Docs path |
|---|---|
| Authentication and API keys | /docs/auth |
| Sample mapping and dry-run | /docs/signal-mapping |
| Webhook ingress contract | /docs/webhooks |
| Policy bundle submission | /docs/policy-encoding |
| Decision Dossier retrieval and verification | /docs/decision-dossier |