Skip to main content
POST
Create Proposal

Body

application/json

A NEW VERSION proposal with lineage — never an edit to a live one (§12a.1).

parent_playbook_version/parent_playbook_hash default to the RUNNING document, which is the only parent a proposal opened against this binary can honestly claim. They are settable so a proposal can be filed against an older parent explicitly, and the mismatch is then visible in the row rather than implied.

created_by is absent on purpose: the handler stamps it from the authenticated operator.

template_id
string
required
proposed_spec
Proposed Spec · object
required
diff_summary
string
required
Minimum string length: 1
proposed_playbook_version
string
required
Minimum string length: 1
proposed_playbook_hash
string
required
Pattern: ^[0-9a-f]{64}$
parent_playbook_version
string
default:scenario_playbook_v1
parent_playbook_hash
string
default:9bc0b7aa353352daec05d666829fbd22cb962a8c6403d44d0a9a66d9777c5f9f

Response

Successful Response

The response is of type Response Create Proposal Api Graph V1 Template Governance Proposals Post · object.