> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grantex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Custom Domain

> Remove a custom domain registration.

## Endpoint

```
DELETE /v1/domains/:id
```

## Authentication

Requires a developer API key in the `Authorization` header.

## Request Headers

| Header          | Value              |
| --------------- | ------------------ |
| `Authorization` | `Bearer <api_key>` |

## Path Parameters

| Parameter | Type     | Description                                    |
| --------- | -------- | ---------------------------------------------- |
| `id`      | `string` | The domain ID to delete (e.g. `dom_01HXYZ...`) |

## Example Request

```bash theme={null}
curl -X DELETE https://grantex-auth-dd4mtrt2gq-uc.a.run.app/v1/domains/dom_01HXYZ... \
  -H "Authorization: Bearer gx_..."
```

## Response -- 204 No Content

No response body is returned on success.

## Error Responses

| Status | Code           | Description                                      |
| ------ | -------------- | ------------------------------------------------ |
| 401    | `UNAUTHORIZED` | Invalid or missing API key                       |
| 404    | `NOT_FOUND`    | Domain not found or does not belong to developer |

## SDK Examples

<CodeGroup>
  ```typescript TypeScript theme={null}
  import Grantex from '@grantex/sdk';

  const grantex = new Grantex({ apiKey: 'gx_...' });

  await grantex.domains.delete('dom_01HXYZ...');
  ```

  ```python Python theme={null}
  from grantex import Grantex

  grantex = Grantex(api_key="gx_...")

  grantex.domains.delete("dom_01HXYZ...")
  ```
</CodeGroup>