---
title: "Update an existing user group."
method: PUT
path: "/v1/user-groups/{id}"
tags: ["user_groups"]
---

# Update an existing user group.

`PUT /v1/user-groups/{id}`

Used to update a single user group. The available fields are still limited.

## Path parameters

- `id` string, required

## Headers

- `X-Trace-Id` string, uuid

## Request body

- UserGroupUpdate
  - `title` string, string, required — A descriptive title for the user group.
  - `primary_currency_id` string, string — Use either primary_currency_id or primary_currency_code. This will set the primary currency for the user group ('financial administration').
  - `primary_currency_code` string, string — Use either primary_currency_id or primary_currency_code. This will set the primary currency for the user group ('financial administration').

## Response `200`

Updated user group is stored, result is in the response

## Other responses

- `400` — Bad request
- `401` — Unauthenticated
- `404` — Page not found
- `422` — Validation error. The body will have the exact details.
- `500` — Internal exception

---

[API](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop.md) · [All operations](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firefly-iii/firefly-iii-api-develop/revisions/8a1f6472e04b/schema)