---
title: "Delete a Realm"
method: DELETE
path: "/v1/tenants/{tenant_id}/realms/{realm_id}"
tags: ["Realms"]
---

# Delete a Realm

`DELETE /v1/tenants/{tenant_id}/realms/{realm_id}`

## Request

- Base URL: `https://api-us.beyondidentity.com`
- URL: `https://api-us.beyondidentity.com/v1/tenants/{tenant_id}/realms/{realm_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/docs/v1/tenants/:tenant_id/realms/:realm_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

To delete a realm, send a DELETE request to `/v1/tenants/$TENANT_ID/realms/$REALM_ID`. To be deleted, a realm must not have any identities, groups, or roles. All associated resources must first be deleted or you will receive a 409 error.
A successful request will receive a 200 status code with no body in the response. This indicates that the request was processed successfully.

## Path parameters

- `tenant_id` string, required
- `realm_id` string, required

## Response `200`

The action was successful and the response body is empty.

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: The resource was not found.
- `409`: Conflict.
- `500`: Server error.

---

[API](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api.md) - [All operations](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/revisions/42f3cac49392?raw)