Skip to main content
PUT
Update stewardship-plan strategy

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

plan_id
integer
required

Plan id in the current organization.

Body

application/json

Validated request fields for this operation.

version
integer
required

Current plan version for optimistic concurrency. Stale versions return 409.

Required range: x >= 1
Example:

1

tier
enum<string> | null

Tier. Validation: nullable; allowed values: A, B, C.

Available options:
A,
B,
C,
null
Example:

"A"

goal_amount
number | null

Goal amount. Validation: nullable, numeric, min:0, max:9999999999999.99.

Required range: 0 <= x <= 9999999999999.99
Example:

25

target_ask_amount
number | null

Target ask amount. Validation: nullable, numeric, min:0, max:9999999999999.99.

Required range: 0 <= x <= 9999999999999.99
Example:

25

expected_giving_month
integer | null

Expected giving month. Validation: nullable, integer, between:1,12.

Required range: 1 <= x <= 12
Example:

1

expected_giving_note
string | null

Expected giving note. Validation: nullable, string, max:255.

Maximum string length: 255
Example:

"Expected Giving Note"

strategy_summary
string | null

Strategy summary. Validation: nullable, string, max:10000.

Maximum string length: 10000
Example:

"Strategy Summary"

interests_summary
string | null

Interests summary. Validation: nullable, string, max:10000.

Maximum string length: 10000
Example:

"Interests Summary"

communication_guidance
string | null

Communication guidance. Validation: nullable, string, max:10000.

Maximum string length: 10000
Example:

"Communication Guidance"

action_donor_id
integer | null

Action donor id. Validation: nullable, integer, min:1.

Required range: x >= 1
Example:

1

next_review_at
string<date-time> | null

Next review at. Validation: nullable, date.

Example:

"2026-10-20T12:00:00Z"

Response

Operation result.

status
string
Example:

"success"

data
object

Strategy fields, moves and reviews are omitted unless permissions.can_view_strategy is true; mutations return the refreshed plan workspace unless their response says otherwise.