---
title: "PATCH /users/{user_ref}"
method: PATCH
path: "/users/{user_ref}"
tags: ["Users"]
---

# PATCH /users/{user_ref}

`PATCH /users/{user_ref}`

Updates a user.

## Path parameters

- `user_ref` string, required — User `id` or `external_id`.

## Request body

- UpdateUserRequest — Request body for updating a user.
  - `tags` object, required — Tag operations to apply to the user.
    - `set` TagRequest[] — Tags to set. Creates a new tag or updates an existing tag.
      - `key` string, required — Tag key. Must not contain #, /, or :. Max 50 characters.
      - `value` string, required — Tag value. Must not contain #, /, or :. Max 200 characters.
    - `create` TagRequest[] — Tags to create. The tag key must not already exist.
      - `key` string, required — Tag key. Must not contain #, /, or :. Max 50 characters.
      - `value` string, required — Tag value. Must not contain #, /, or :. Max 200 characters.
    - `update` TagRequest[] — Tags to update. The tag key must already exist.
      - `key` string, required — Tag key. Must not contain #, /, or :. Max 50 characters.
      - `value` string, required — Tag value. Must not contain #, /, or :. Max 200 characters.
    - `delete` TagDeleteRequest[] — Tags to remove.
      - `key` string, required — Tag key to delete.

## Response `200`

Success

- UserSuccessResponse
  - `data` User, required — User object.
    - `id` string, required — FRAGMENT generated unique ID.
    - `external_id` string, required — User-provided unique ID.
    - `tags` Tag[], required — Tags for the user.
      - `key` string, required — Tag key.
      - `value` string, required — Tag value.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-05-11** `91a072ddf86d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/changes/users/:user_ref/patch.md)

---

[API](https://skmtc.dev/fragment-dev/apis/fragment-payments-api.md) · [All operations](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fragment-dev/fragment-payments-api/revisions/91a072ddf86d/schema)