---
title: "Propose a policy from signed findings or governed documents"
method: POST
path: "/v1/policies/{policyId}/proposals"
---

# Propose a policy from signed findings or governed documents

`POST /v1/policies/{policyId}/proposals`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/policies/{policyId}/proposals`
- Auth: API key in cookie `decionis_account_session`

Account session of a policy AUTHOR or POLICY_OWNER; same-site JSON and an Idempotency-Key are required. With findingsIds, a deterministic parameter proposer sets commerce-preflight-v2 parameters (P01, P09, P12, P13, P14, P15, P16) from the findings' distributions; every parameter cites the findings behind it and the same findings always produce the same parameters. An approved model, when named, writes only the rationale. With sourceIds, the existing document drafting runs. Alias kept on the same handler /v1/public/account/workspace/policy-platform/{policyId}/proposals.

## Headers

- `Idempotency-Key` string

## Request body

- union
  - PolicyFindingsDraftRequest
    - `expectedSequence` integer, required
    - `findingsIds` string[], required
    - `modelId` string
    - `modelVersion` string
    - `intent` string
  - PolicyDocumentDraftRequest
    - `expectedSequence` integer, required
    - `modelId` string, required
    - `modelVersion` string, required
    - `sourceIds` string[], required
    - `intent` string, required

## Response `202`

The proposal run. A findings proposal is READY or HELD immediately.

- object
  - `policy` object, required
  - `run` object, required

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `403`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `422`: 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)