---
title: "Update buy orders"
method: PATCH
path: "/api/public/v1/orders"
tags: ["Buy Orders"]
---

# Update buy orders

`PATCH /api/public/v1/orders`

Updates the spend cap, FDV cap, or expiry of one or more active buy orders.

Each item is processed independently. The response is always HTTP 200 once authenticated and the body is valid — check the per-item `ok` flag in `results` (index-aligned to your request) for each outcome.

## Request body

- object
  - `items` object[], required
    - `slug` string, required — Public project slug identifying the buy order to update.
    - `maxSpendUsdc` string — New per-buy USDC spend cap. Omit to keep the current value.
    - `maxFdvUsdc` string, nullable — New maximum FDV cap, in USDC. Omit to keep the current cap; pass an explicit null to clear it — no FDV cap, so the project is bought as quickly as possible.
    - `expiresInMs` integer — New expiry window, in milliseconds. Omit to keep the current value.

## Response `200`

Per-item results for the batch.

- BuyOrderMutationResponse
  - `results` union[], required
    - union
      - object
        - `slug` string, required
        - `ok` true, required
        - `status` 'created' | 'updated' | 'deleted' | 'unchanged' | 'already_deleted', required
      - object
        - `slug` string, required
        - `ok` false, required
        - `code` 'unknown_project' | 'already_exists' | 'not_found' | 'not_modifiable' | 'invalid_value' | 'duplicate_in_request', required
        - `message` string, required

## Other responses

- `400` — Malformed JSON, an invalid body, or an over-limit batch.
- `401` — Missing, invalid, or revoked API key.
- `429` — Rate limit exceeded. Wait `Retry-After` seconds before retrying.
- `500` — An unexpected server-side error occurred.

---

[API](https://skmtc.dev/thefirm/apis/autoboy-public-api.md) · [All operations](https://skmtc.dev/thefirm/apis/autoboy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thefirm/autoboy-public-api/revisions/56f5091b8f06/schema)