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

# Delete a user attribute definition

`DELETE /v1/user-attributes/{userAttributeId}`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/user-attributes/{userAttributeId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

<Note>
  **Organization Admin** permissions are required to use this endpoint.
</Note>

Delete a custom [user attribute](/administration/users/attributes) definition. This permanently removes the value every user holds for the attribute.

Additionally, any references to the attribute will break upont deletion. This includes model SQL, dashboard or embed SSO URLs that pass it as a parameter, and connections that select an environment by its value will fall back to the default environment instead.

## Path parameters

- `userAttributeId` string, uuid, required

## Response `204`

User attribute definition deleted

## Other responses

- `400`: Bad Request. The `userAttributeId` parameter is not a valid UUID.
- `401`: Authentication required
- `403`: Forbidden. Requires Organization Admin permissions.
- `404`: Not Found. No user attribute definition with that ID exists in the caller's organization.
- `405`: Method Not Allowed - Invalid HTTP method for this endpoint
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

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

---

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