---
title: "Deletes a claim alias for the company"
method: DELETE
path: "/companies/{identifier}/saml/claim-aliases/{aliasId}"
tags: ["companies"]
---

# Deletes a claim alias for the company

`DELETE /companies/{identifier}/saml/claim-aliases/{aliasId}`

Permanently deletes the specified alias for the company
Requires the privilege [`COMPANY_SAMLCLAIM_ALIAS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `identifier` string, required
- `aliasId` string, required

## Response `204`

Alias deleted

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: COMPANY_SAMLCLAIM_ALIAS_WRITE
- `404` — Company not found

## Changes

- **2026-09-02** `358b43b8f258` — 2 info
  - added the non-success response with the status `404`
  - added the success response with the status `204`

[Change history](https://skmtc.dev/gremlin/apis/gremlin-api/changes/companies/:identifier/saml/claim-aliases/:aliasId/delete.md)

---

[API](https://skmtc.dev/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.dev/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/358b43b8f258/schema)