# Delete Alias

### Request

Delete an existing alias by providing its unique ID in the request path. This action permanently removes the alias from the organization’s records.

**Endpoint:**

```
DELETE /organization/api/v1/alias/delete/:id
```

**URL:**

```
https://link.api.datagram.network/organization/api/v1/alias/delete/:id
```

### Path Parameters

| Parameter | Type   | Required | Description                                  | Example       |
| --------- | ------ | -------- | -------------------------------------------- | ------------- |
| **id**    | string | ✅ Yes    | Unique identifier of the alias to be deleted | `"abc123xyz"` |

### Headers

| Header            | Type   | Required | Description                          | Example                                     |
| ----------------- | ------ | -------- | ------------------------------------ | ------------------------------------------- |
| **Authorization** | string | ✅ Yes    | Bearer token used for authentication | `"BearereyJhbGciOiJIUzl1NilsLnR5cCi6....."` |

#### Example Request

```
DELETE /organization/api/v1/alias/delete/12345 HTTP/1.1
Host: link.api.datagram.network
Authorization: Bearer <your_token>
```

### Responses

{% tabs %}
{% tab title="200" %}
Alias deleted successfully.

**Response Body**

| Parameter   | Type   | Description                        | Example                        |
| ----------- | ------ | ---------------------------------- | ------------------------------ |
| **message** | string | Confirmation message of the action | `"Alias deleted successfully"` |

**Example**

```
{
  "message": "Alias deleted successfully."
}

```

{% endtab %}

{% tab title="401" %}
Returned when the request is made without a valid authentication token.

| Field     | Type   | Description                       | Example            |
| --------- | ------ | --------------------------------- | ------------------ |
| **error** | object | Contains the error details object | `"``UNAUTHORIZED"` |

#### Example Response

```
{
    "error": {
        "message": "UNAUTHORIZED"
    }
}
```

{% endtab %}

{% tab title="404" %}
Returned when the alias with the provided ID does not exist.

| Field     | Type   | Description                       | Example       |
| --------- | ------ | --------------------------------- | ------------- |
| **error** | object | Contains the error details object | `"NOT FOUND"` |

#### Example

```
{
  "error": {
    "message": "Not found"
  }
}
```

{% endtab %}
{% endtabs %}