---
title: "Draft a reviewable policy strategy from unstructured sources"
method: POST
path: "/v1/orgs/{org_id}/policies/strategies/draft"
---

# Draft a reviewable policy strategy from unstructured sources

`POST /v1/orgs/{org_id}/policies/strategies/draft`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/orgs/{org_id}/policies/strategies/draft`
- Auth: HTTP bearer

Turns scattered policy material — pasted text and uploaded files
(PDF, XLSX, XML, HTML, JSON, plain text such as transaction or audit
logs) plus optional live policy-source connectors (Jira, Confluence,
Notion, Google Drive, Git repository, SAP) — into a strategy-shaped
Decionis draft with clauses bucketed for automatic execution,
escalation, and blocking. The draft is not persisted: review it, then
encode the accepted version. Drafting is LLM-assisted when a provider
is configured and falls back to deterministic extraction otherwise;
`used_llm` reports which path ran. Requires an org API key with the
ADMIN role and the `autonomous:manage` or `org:*` scope.

## Path parameters

- `org_id` string, uuid, required

## Headers

- `X-Correlation-ID` string

## Request body

- PolicyDraftRequest: Provide manual sources, live connector ids, or both — at least one of the two is required.
  - `suggested_name` string
  - `workflow_key` string
  - `sources` PolicyDraftSource[]
    - `label` string, required
    - `source_type` string, required: Caller-chosen tag, e.g. upload, jira, confluence, audit_log.
    - `content` string
    - `content_base64` string
    - `content_type` string
    - `file_name` string
    - `external_reference` string
  - `live_connector_ids` string[]: Org policy-source connectors to pull live at draft time (Jira, Confluence, Notion, Google Drive, Git repository, SAP).

## Response `200`

Non-persistent policy strategy draft

- PolicyStrategyDraftResponse
  - `org` object, required
    - `id` string
    - `name` string
  - `generated_at` string, date-time, required
  - `draft` object, required
    - `used_llm` boolean, required
    - `suggested_name` string, required
    - `workflow_key` string, required
    - `summary` string, required
    - `strategy` object, required: The strategy-shaped draft, including `strategy_rules` with clauses bucketed for automatic execution, escalation, and blocking.
    - `extracted_sources` unknown[]
      - unknown
    - `review_checklist` unknown[]
      - unknown
    - `open_questions` unknown[]
      - unknown
    - `warnings` unknown[]
      - unknown

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `403`: Structured API error
- `404`: Structured API error
- `502`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)