Skip to main content
POST
Draft case blueprint with AI
Didit’s blueprint AI-draft API turns a policy description into an unsaved review-policy proposal. Authenticate with x-api-key and write:cases permission for the application.

Generate and review a proposal

Send a nonblank prompt of at most 4000 characters. The response is 200 with a draft object, not a saved blueprint or UUID.
The proposal can contain name, description, applies_to, content_config, require_resolution_note, assignment_method, max_active_cases and default_deadline_hours. Fields may be absent, so review the response before using it. The top-level proposal excludes assignee lists, approval settings and routing references. Select assignees, teams, approvals and routing yourself before saving. If a generated stage contains worked_by, it is validated as an active review-team UUID in the application; do not treat a proposal as an approved assignment. Use Create case blueprint after review, including its required name and nonempty assignee_pool. Generating a proposal does not save a policy draft, publish a policy, or change existing cases. The saved draft and publish lifecycle is separate.

Errors

A generation failure returns:

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

organization_id
string<uuid>
required

Organization UUID.

application_id
string<uuid>
required

Application UUID.

Body

application/json
prompt
string
required

Nonblank description of the review policy to propose.

Required string length: 1 - 4000
Example:

"Draft an AML review policy with triage and evidence review stages."

Response

Unsaved proposal. No state was changed.

draft
object
required

Unsaved, validated proposal. Fields are optional; review the result and select assignees, teams and routing before saving.

Last modified on November 11, 2026