---
title: "Unassign Role"
method: DELETE
path: "/api/users/{user_id}/roles/{assignment_id}"
tags: ["security"]
---

# Unassign Role

`DELETE /api/users/{user_id}/roles/{assignment_id}`

## Request

- Base URL: `https://app.sentientmail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sentientmail.com/api/users/{user_id}/roles/{assignment_id}`
- Auth: none declared

Remove an assignment OWNED BY THE ACTIVE UNIT: the assignment's
tenant_id and its role's tenant_id must both be the unit the caller
was authorized in. An assignment of another unit, or an account-wide
(NULL) one, is not this unit's to remove.

## Path parameters

- `user_id` string, uuid, required
- `assignment_id` string, uuid, required

## Cookies

- `esp_session` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sentientmail/apis/sentientmail.md) · [All operations](https://skmtc.dev/sentientmail/apis/sentientmail/llms.txt) · [OpenAPI document](https://skmtc.dev/sentientmail/apis/sentientmail/revisions/4c87ece26935?raw)