---
updatedAt: 2026-05-21T16:41:02.000Z
---

# Deletes a specific alias

Deletes a specific alias of tenant.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "description": "Federation",
    "title": "Federation"
  },
  "servers": [
    {
      "url": "https://{tenanturl}",
      "variables": {
        "tenanturl": {
          "default": "{tenant_url}",
          "description": "URL of your IBM Security Verify tenant"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "SAML 2.0 Alias Management"
    }
  ],
  "paths": {
    "/v1.0/saml/alias/{aliasUuid}": {
      "delete": {
        "tags": [
          "SAML 2.0 Alias Management"
        ],
        "summary": "Deletes a specific alias",
        "description": "Deletes a specific alias of tenant.",
        "operationId": "deleteAlias",
        "parameters": [
          {
            "name": "aliasUuid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Authorization Header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Deletion",
            "content": {}
          },
          "400": {
            "description": "Bad Request Exception",
            "content": {}
          },
          "403": {
            "description": "Forbidden",
            "content": {}
          },
          "404": {
            "description": "Alias Not Found",
            "content": {}
          },
          "500": {
            "description": "Internal Server Error",
            "content": {}
          }
        },
        "x-category": "Federation",
        "x-publicAPI": "true"
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-explorer-enabled": false
}
```