---
title: "Partially update stub by ID"
method: PATCH
path: "/stubs/{uuid}"
tags: ["stubs"]
---

# Partially update stub by ID

`PATCH /stubs/{uuid}`

Updates only the provided fields of the stub; omitted fields are preserved

## Path parameters

- `uuid` string, uuid, required

## Request body

- StubPatch — Partial stub update - only provided fields are updated
  - `service` string
  - `method` string
  - `priority` integer
  - `options` StubOptions — Optional behavior settings for a stub
    - `times` integer — Max number of matches; 0 = unlimited
  - `headers` StubHeaders
    - `equals` object
    - `contains` object
    - `matches` object
  - `input` StubInput
    - `ignoreArrayOrder` boolean
    - `equals` object
    - `contains` object
    - `matches` object
  - `inputs` StubInput[]
    - `ignoreArrayOrder` boolean
    - `equals` object
    - `contains` object
    - `matches` object
  - `output` StubOutput
    - `data` object
    - `stream` object[]
    - `headers` object
    - `error` string
    - `code` integer
    - `delay` string — Delay before sending the response

## Response `200`

Stub updated successfully

- Stub
  - `id` string, uuid
  - `service` string, required
  - `method` string, required
  - `priority` integer — Priority of the stub. Higher priority stubs are matched first.
  - `headers` StubHeaders
    - `equals` object
    - `contains` object
    - `matches` object
  - `input` StubInput, required
    - `ignoreArrayOrder` boolean
    - `equals` object
    - `contains` object
    - `matches` object
  - `inputs` StubInput[] — Inputs to match against. If multiple inputs are provided, the stub will be matched if any of the inputs match.
    - `ignoreArrayOrder` boolean
    - `equals` object
    - `contains` object
    - `matches` object
  - `output` StubOutput, required
    - `data` object
    - `stream` object[]
    - `headers` object
    - `error` string
    - `code` integer
    - `delay` string — Delay before sending the response
  - `options` StubOptions — Optional behavior settings for a stub
    - `times` integer — Max number of matches; 0 = unlimited

## Other responses

- `400` — Invalid UUID or patch data
- `404` — Stub not found
- `500` — Internal Server Error

## Changes

- **2026-02-14** `001f2b1780f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bavix/apis/gripmock-api-schema/changes/stubs/:uuid/patch.md)

---

[API](https://skmtc.dev/bavix/apis/gripmock-api-schema.md) · [All operations](https://skmtc.dev/bavix/apis/gripmock-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bavix/gripmock-api-schema/revisions/001f2b1780f3/schema)