Update a stack

Save changes to a stack as a new revision.

PATCH /manager/stacks/{id}

Update a stack

cURL

curl --request PATCH \
  --url https://api-staging.mystacks.ai/manager/stacks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Updated example stack",
  "schedule": {
    "preset": "weekly"
  }
}
'

200

{
  "id": "bf4bc5e9-0d9e-454c-bc1c-30abc120b074",
  "current_revision_id": "e137435f-83ce-4b3c-86ae-75d6462487b6",
  "name": "Updated example stack",
  "allocation": [
    {
      "token_address": "0x117cc2133c37b721f49de2a7a74833232b3b4c0c",
      "weight_bps": 6000
    },
    {
      "token_address": "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec",
      "weight_bps": 4000
    }
  ],
  "schedule": {
    "preset": "weekly"
  }
}

Updates a stack owned by the manager identified by your API key. Every accepted update creates a new complete revision.

Try it saves a real update to staging. Every accepted update creates a revision. Use a stack ID from your own account.

Omitted fields retain their values from the current saved revision. A supplied allocation replaces the entire target list. Omitting a token from that supplied list removes its allocation. The replacement still needs weights totaling 10000.

An empty object is invalid. Unknown fields and null field values are invalid.

Response

200 OK returns the complete stack response with the new current_revision_id. The response includes the new quoted revision ID in ETag. It also includes X-Request-Id.

The saved configuration is visible immediately. An update does not trigger an immediate trade. See schedules for preset meanings and the planned execution contract.

Revisions and concurrent updates

Every successfully saved update creates a revision. This includes an update that repeats the current values.

Concurrent updates are saved in sequence. For each supplied field, the last successfully saved value wins. A delayed older request can overwrite a newer request that was saved first. Omitted fields are copied from the current configuration when the update is saved.

Neither If-Match nor Idempotency-Key is required or enforced for this endpoint. Sending them does not protect against overwrites or deduplicate a retry.

A retried PATCH is a new update. If a response is lost, read the stack before deciding whether to send another update. Use one ordered stream of updates per stack when your client needs to preserve its intended order.

Errors

Status	Code	Cause
400	invalid_request	Invalid stack UUID, malformed JSON, empty patch, or invalid configuration.
404	not_found	Stack is missing or belongs to another manager.

See shared errors for authentication, body size, and service failures.

Authorizations

Authorization · string · header · required

Enter the API key supplied by MyStacks. The playground adds the Authorization: Bearer prefix for you.

Headers

X-Request-Id · string

Optional request trace ID. A nonempty value is echoed in the response. Missing or empty values cause a UUID to be generated.

Path Parameters

id · string<uuid> · required

UUID of a stack owned by this manager. Missing or unowned stacks return 404. Invalid UUIDs return 400.

Body

application/json

Supply at least one of name, allocation, or schedule. Omitted fields retain their saved values. A supplied allocation replaces the full target list. Unknown fields and null values are invalid. The request body must not exceed 262144 bytes.

name · string

Must contain non-whitespace text and must not contain U+0000. Accepted names retain their exact whitespace. No separate name-length limit applies within the body size limit.

Minimum string length: 1

Pattern: ^(?![\s\S]*\u0000)[\s\S]*\S[\s\S]*$

Example:

"Example stack"

allocation · object[]

The complete target allocation. Weights must total exactly 10000. Duplicate token identities are rejected after lowercase normalization. When supplied in PATCH, this list replaces the full saved allocation. Omitted tokens are removed.

Required array length: 1 - 30 elements

Show child attributes

Example:

[
  {
    "token_address": "0x117cc2133c37b721f49de2a7a74833232b3b4c0c",
    "weight_bps": 6000
  },
  {
    "token_address": "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec",
    "weight_bps": 4000
  }
]

schedule · object

Schedule configuration only. Saving a preset does not execute trades.

Show child attributes

Example:

{ "preset": "daily" }

Response

200

application/json

Complete saved configuration with the new revision and ETag.

Current complete configuration. No subscriber, balance, performance, or execution data is included.

id · string<uuid> · required

Stable stack identifier.

Example:

"bf4bc5e9-0d9e-454c-bc1c-30abc120b074"

current_revision_id · string<uuid> · required

Identifier of this complete saved configuration revision.

Example:

"e137435f-83ce-4b3c-86ae-75d6462487b6"

name · string · required

Must contain non-whitespace text and must not contain U+0000. Accepted names retain their exact whitespace. No separate name-length limit applies within the body size limit.

Minimum string length: 1

Pattern: ^(?![\s\S]*\u0000)[\s\S]*\S[\s\S]*$

Example:

"Example stack"

allocation · object[] · required

Complete saved allocation. Addresses are lowercase, unique, and ordered by token address. Weights total exactly 10000.

Required array length: 1 - 30 elements

Show child attributes

Example:

[
  {
    "token_address": "0x117cc2133c37b721f49de2a7a74833232b3b4c0c",
    "weight_bps": 6000
  },
  {
    "token_address": "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec",
    "weight_bps": 4000
  }
]

schedule · object · required

Schedule configuration only. Saving a preset does not execute trades.

Show child attributes

Example:

{ "preset": "daily" }