---
title: "Update entity user"
method: POST
path: "/entity/{entityId}/user/{userId}"
tags: ["entity > user"]
---

# Update entity user

`POST /entity/{entityId}/user/{userId}`

## Request

- Base URL: `https://api.mercoa.com`
- URL: `https://api.mercoa.com/entity/{entityId}/user/{userId}`
- Auth: HTTP bearer

Update entity user

## Path parameters

- `entityId` string, required
- `userId` string, required

## Request body

- EntityTypesEntityUserRequest
  - `foreignId` string: The ID used to identify this user in your system.
  - `email` string
  - `name` string
  - `roles` string[]: List of roles. A role can be any string. For example: "payer", "approver", "viewer"

## Response `200`

Response with status 200

- EntityTypesEntityUserResponse
  - `id` string, required
  - `foreignId` string: The ID used to identify this user in your system.
  - `email` string
  - `name` string
  - `roles` string[], required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `403`: Error response with status 403
- `404`: Error response with status 404
- `409`: Error response with status 409
- `500`: Error response with status 500
- `501`: Error response with status 501

---

[API](https://skmtc.dev/mercoa/apis/mercoa-2.md) - [All operations](https://skmtc.dev/mercoa/apis/mercoa-2/llms.txt) - [OpenAPI document](https://skmtc.dev/mercoa/apis/mercoa-2/revisions/00a8e403ae18?raw)