Policies

Propose a policy from signed findings or governed documents

POST
/v1/policies/{policyId}/proposals

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.

Authorization

AccountSessionCookie
decionis_account_session<token>

The signed HttpOnly account session the web app holds after sign-in (also accepted as a Bearer acct_ token).

In: cookie

Path Parameters

policyId*string
Formatuuid

Header Parameters

Idempotency-Key?string

Request Body

application/json

expectedSequence*integer
Range0 < value
findingsIds*array<>
Items1 <= items <= 20
modelId?string
Length1 <= length <= 120
modelVersion?string
Length1 <= length <= 120
intent?string
Length1 <= length <= 12000

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/policies/497f6eca-6276-4993-bfeb-53cbbbba6f08/proposals" \  -H "Content-Type: application/json" \  -d '{    "expectedSequence": 1,    "findingsIds": [      "354a1e00-ef18-4773-b403-c022bc163da5"    ]  }'
{  "policy": {},  "run": {}}