---
title: "Delete a user attribute definition"
method: DELETE
path: "/api/v1/user-attributes/{id}"
tags: ["User Attributes"]
---

# Delete a user attribute definition

`DELETE /api/v1/user-attributes/{id}`

Deletes a custom user attribute definition. Every value users hold for the attribute is removed with it. Any embed SSO login that still passes the attribute name then fails outright, locking out the organization's embed users until those URLs stop sending it; model SQL that references the attribute by name breaks; and a connection that selects an environment by that attribute name stops resolving one, so those users query the default connection instead. Requires the Manage User Attributes permission.

## Path parameters

- `id` string, uuid, required — User attribute definition ID

## Response `204`

User attribute definition deleted

## Other responses

- `400` — Invalid definition ID
- `401` — Authentication required
- `403` — Requires the Manage User Attributes permission
- `404` — User attribute definition does not exist

## Changes

- **2026-09-22** `d3c0855161b1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/omniapp/apis/omni-api/changes/api/v1/user-attributes/:id/delete.md)

---

[API](https://skmtc.dev/omniapp/apis/omni-api.md) · [All operations](https://skmtc.dev/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc.dev/omniapp/apis/omni-api/revisions/299eacbcab4d?raw)