Skip to main content
POST
Propose changes

Authorizations

Authorization
string
header
required

Sign in as a person: Planner shows them what the agent asks for (planner:read, planner:propose) and they agree. The agent then sees what they can see. Discovery: /.well-known/oauth-protected-resource.

Scopes

planner:propose

Propose changes for you to review in your Planner inbox. Nothing changes until you accept it.

Headers

Idempotency-Key
string

Body

application/json
title
string
required

One line: what this proposal does.

Required string length: 1 - 200
changes
object[]
required
Required array length: 1 - 500 elements
note
string

Why, briefly: what you were asked, and anything the person should check.

Maximum string length: 4000
edition
integer

The edition the changes are for, by year. Default: the current edition.

Required range: -9007199254740991 <= x <= 9007199254740991

Response

The same Idempotency-Key again: the first proposal.

The response is of type object.