API and integrations

Ask questions and fetch results from your own systems (Pro Max).

Basics

REST under /v1, described by OpenAPI 3.1.

Topic	Detail
Base URL	`https://app.danphecouncil.com/api/v1`
Authentication	`Authorization: Bearer dk_live_…` with a key from Settings → API keys (Pro Max)
Writes	Send an `Idempotency-Key` header so a retried request never runs twice
Errors	RFC 9457 `application/problem+json`
Lists	Cursor pagination with `cursor` and `limit`
Rate limits	60 requests a minute on Free, 300 on Pro, 1,200 on Pro Max

Ask a question

Start a run, then follow it.

Link

Request

curl -X POST https://app.danphecouncil.com/api/v1/deliberations \
  -H "Authorization: Bearer $DANPHE_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"workspace_id": "…", "question": "Can the supplier share our data with affiliates?", "mode": "auto"}'

The answer is 202 with the run's id. Follow it with GET /deliberations/{id}/events (server-sent events) or poll GET /deliberations/{id}.

Main resources

What the API covers.

Link

/files: upload documents; /collections: large document sets
/deliberations: ask and read checked answers
/audit-records: fetch and verify audit records
/review-items, /feedback: human review
/usage, /api-keys

Note: Webhook delivery and published SDKs are not available yet; the OpenAPI document at /v1/openapi.yaml is the reference.