> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glider.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Patch strategy

> Patches the strategy's mutable display + discovery metadata.

Patches the strategy's display metadata — name, description, visibility.
Doesn't change the allocation, schedule, or preferences (each has its own
endpoint).

* Auth: `x-api-key` header (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.            |

The patchable surface mirrors the `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.

Empty body `{}` is a 200 no-op. Body is strict; unknown keys return `400`.

### Where to make other changes

* Allocation: [`POST /v2/strategies/{strategyId}/versions`](/api-reference/endpoints/v2-publish-strategy-version)
* Schedule: [`PUT /v2/strategies/{strategyId}/schedule`](/api-reference/endpoints/v2-set-strategy-schedule)
* Preferences: [`PATCH /v2/strategies/{strategyId}/preferences`](/api-reference/endpoints/v2-patch-strategy-preferences)

### Cross-tenant access

Returns `404` — strategies you don't own are not exposed.

### Response

Returns the full `Strategy` shape (same as `GET /v2/strategies/{strategyId}`).

<RequestExample>
  ```bash cURL — rename and toggle visibility theme={null}
  curl --request PATCH \
    --url 'https://api.glider.fi/v2/strategies/01JWZEE2MF30KVRMRX53N88VA4' \
    --header 'x-api-key: gldr_sk_your_api_key' \
    --header 'content-type: application/json' \
    --data '{ "name": "Conservative Yield v2", "isPublic": true }'
  ```

  ```bash cURL — clear the description theme={null}
  curl --request PATCH \
    --url 'https://api.glider.fi/v2/strategies/01JWZEE2MF30KVRMRX53N88VA4' \
    --header 'x-api-key: gldr_sk_your_api_key' \
    --header 'content-type: application/json' \
    --data '{ "description": null }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.glider.fi/v2/strategies/01JWZEE2MF30KVRMRX53N88VA4",
    {
      method: "PATCH",
      headers: {
        "x-api-key": "gldr_sk_your_api_key",
        "content-type": "application/json",
      },
      body: JSON.stringify({ name: "Conservative Yield v2" }),
    },
  );
  const { data } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "strategyId": "01JWZEE2MF30KVRMRX53N88VA4",
      "name": "Conservative Yield v2",
      "description": "Multi-chain balanced allocation strategy",
      "allocation": {
        "assets": [
          {
            "assetId": "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "weight": "100"
          }
        ]
      },
      "schedule": { "type": "interval", "frequency": "daily" },
      "preferences": {
        "swap": {
          "slippageBps": null,
          "priceImpactBps": null,
          "thresholdUsd": null
        }
      },
      "isPublic": true,
      "version": 3,
      "createdAt": "2026-04-01T12:00:00.000Z"
    }
  }
  ```
</ResponseExample>