---
title: "/api/v1/account/groupId"
method: PATCH
path: "/api/v1/account/groupId"
tags: ["Account Data"]
---

# /api/v1/account/groupId

`PATCH /api/v1/account/groupId`

Sets or updates the group ID for a specific account. 
Accounts belonging to the same group cannot trade against each other.
If the groupId is not set, the account will be removed from its group.
Only the first 6 characters of the groupID are guaranteed to be respected,
longer group IDs may be rejected.

## Request body

- AccountGroupIdPatch
  - `accountAddress` string, required — The address of the account to update.
  - `groupId` string — The new group to assign the account to. If not present, the account will be removed from any group.

## Response `202`

Accepted and processing.

## Other responses

- `400` — request missing required parameters
- `401` — unauthorized access
- `404` — account not found
- `500` — internal server error

---

[API](https://skmtc.net/bluefin/apis/bluefin-account-data-api.md) · [All operations](https://skmtc.net/bluefin/apis/bluefin-account-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluefin/bluefin-account-data-api/versions/5fd638fb0785/schema)