---
title: "Update a Strategy's metadata"
method: PATCH
path: "/strategies/{strategy_id}"
tags: ["Trade Strategy"]
---

# Update a Strategy's metadata

`PATCH /strategies/{strategy_id}`

Updates the Strategy's `metadata`. Synchronous. The submitted value replaces the previous one verbatim (no merge); pass `{}` to clear. Only `metadata` is mutable.

## Path parameters

- `strategy_id` string, uuid, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- UpdateTradeStrategyBody
  - `metadata` object, required — New value for the Strategy metadata. Replaces the previous value verbatim (no merge). Pass `{}` to clear.

## Response `200`

The updated Strategy.

- TradeStrategyResponse
  - `message` object
    - `id` string, uuid — Unique identifier (UUID v4) for the Strategy.
    - `request_id` string, uuid — Platform's idempotency key for the Strategy (the `X-REQUEST-ID` sent at creation).
    - `quoted_currency` string — Currency the Strategy denominates participant amounts in (e.g., "USD").
    - `metadata` object, nullable — Arbitrary JSON object the platform attached at creation; persisted verbatim and echoed back on reads. zerohash does not interpret the contents.
    - `created_at` string, date-time — When the Strategy was created.
    - `updated_at` string, date-time — When the Strategy was last updated.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Strategy doesn't exist or belongs to a different platform.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)