Skip to main content
POST
Recommend and store an advisory decision plan

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer <key>. Each operation lists the scope its key needs: decisions:evaluate (evaluate and read evaluations), decisions:feedback (your app's feedback) or decisions:develop (everything else, including owner feedback and the review queue). An operation listing no scope takes any scoped key. A key with no scope, or without the operation's, gets 403 INSUFFICIENT_SCOPE.

Scopes

decisions:develop

Headers

idempotency-key
string
required
Required string length: 1 - 255
Pattern: ^[\x20-\x7e]+$

Path Parameters

decision_id
string
required

A name you choose for this decision, such as refund-exception: a lowercase letter, then up to 127 of a-z 0-9 _ . -. Unique in your organization and shared by its test and production keys. The first registration or evaluation under a new one creates the decision.

Pattern: ^[a-z][a-z0-9_.-]{0,127}$

Body

application/json
intake_from
object
required
parent_plan_id
string
Pattern: ^dpl_[A-Za-z0-9-]{1,80}$

Response

Focused clarification needed; no plan stored

status
enum<string>
required
Available options:
needs_answers
intake_release
string
required
Required string length: 1 - 80
Pattern: ^[A-Za-z0-9][A-Za-z0-9._/-]*$
questions
object[]
required
Required array length: 1 - 128 elements
issues
object[]
required
Required array length: 1 - 128 elements
unresolved
string[]
required
Pattern: ^[a-z][a-z0-9_]{0,63}$