V2 Integrator API
Patch strategy
Patches the strategy’s mutable display + discovery metadata.
PATCH
Patches the strategy’s display metadata — name, description, visibility.
Doesn’t change the allocation, schedule, or preferences (each has its own
endpoint).
The patchable surface mirrors the
- Auth:
x-api-keyheader (required) - Required scope:
strategies:write
Mutable fields
| Field | Type | Nullable | Notes |
|---|---|---|---|
name | string (1–256) | no | Display name. Cannot be cleared. |
description | string (≤2000) | yes | Send null to clear. |
isPublic | boolean | no | Discoverability flag. |
POST /v2/strategies body — anything you
can set at create, you can patch here.
Patch semantics
JSON Merge Patch (RFC 7396):- Omit a field — preserve the current value.
- Send
null— clear (only on nullable fields above). - Send a value — set.
{} is a 200 no-op. Body is strict; unknown keys return 400.
Where to make other changes
- Allocation:
POST /v2/strategies/{strategyId}/versions - Schedule:
PUT /v2/strategies/{strategyId}/schedule - Preferences:
PATCH /v2/strategies/{strategyId}/preferences
Cross-tenant access
Returns404 — strategies you don’t own are not exposed.
Response
Returns the fullStrategy shape (same as GET /v2/strategies/{strategyId}).