---
title: "Update user"
method: PUT
path: "/api/users/{id}"
tags: ["Users"]
---

# Update user

`PUT /api/users/{id}`

## Request

- Base URL: `https://app.cotool.ai`
- URL: `https://app.cotool.ai/api/users/{id}`
- Auth: HTTP bearer

Update a user's role assignment within your organization.

## Path parameters

- `id` string, uuid, required: User ID

## Request body

- object: Fields that may be updated on a user via the API
  - `roleId` string, required: Update the user's role assignment

## Response `200`

Successful response

- unknown

## Other responses

- `400`: Bad request — input validation failed or the request was malformed
- `401`: Unauthorized — missing or invalid API key / session
- `403`: Forbidden — the authenticated user lacks the required permissions
- `500`: Internal server error

---

[API](https://skmtc.dev/cotool/apis/cotool-api.md) - [All operations](https://skmtc.dev/cotool/apis/cotool-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cotool/apis/cotool-api/revisions/f5abe0add203?raw)