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

# Branded Links

> Connect your own domain so Shortlinks carry your brand instead of the default Dashlink domain. Covers custom domains you own and platform subdomains Dashlink hosts for you.

Branded links serve from a domain you control instead of the default Dashlink
domain. Two routes:

**A custom domain you own.** Add it, prove ownership with a DNS record, and a
certificate is issued automatically. `get_domain_verification_info` returns the
exact records to create.

**A platform subdomain Dashlink hosts.** Claim `yourbrand.dshl.ink` with no DNS
work and no certificate wait.

> [!NOTE]
>
> Verification is not instant — DNS has to propagate. Poll `verify_domain` rather
> than assuming the first call after creating the record will succeed. Certificate
> issue is separate again; check it with `get_domain_ssl_status`.

## Endpoints

| Endpoint | Method | Description |
| - | - | - |
| [`/api/v1/domains/create_domain`](https://docs.dashlink.ai/api-reference/branded-links/create-domain) | `POST` | Add a custom domain |
| [`/api/v1/domains/get_user_domains`](https://docs.dashlink.ai/api-reference/branded-links/get-user-domains) | `GET` | List domains |
| [`/api/v1/domains/delete_domain`](https://docs.dashlink.ai/api-reference/branded-links/delete-domain) | `POST` | Delete a domain |
| [`/api/v1/domains/verify_domain`](https://docs.dashlink.ai/api-reference/branded-links/verify-domain) | `POST` | Verify domain ownership |
| [`/api/v1/domains/get_domain_verification_info`](https://docs.dashlink.ai/api-reference/branded-links/get-domain-verification-info) | `GET` | Retrieve DNS records for verification |
| [`/api/v1/domains/get_domain_ssl_status`](https://docs.dashlink.ai/api-reference/branded-links/get-domain-ssl-status) | `GET` | Check certificate status |
| [`/api/v1/domains/get_domain_usage`](https://docs.dashlink.ai/api-reference/branded-links/get-domain-usage) | `GET` | Count links using a domain |
| [`/api/v1/domains/mark_default`](https://docs.dashlink.ai/api-reference/branded-links/mark-default) | `POST` | Set the default domain |
| [`/api/v1/domains/get_platform_domain_parents`](https://docs.dashlink.ai/api-reference/branded-links/get-platform-domain-parents) | `GET` | List available platform domains |
| [`/api/v1/domains/check_platform_subdomain_availability`](https://docs.dashlink.ai/api-reference/branded-links/check-platform-subdomain-availability) | `GET` | Check subdomain availability |
| [`/api/v1/domains/create_platform_subdomain`](https://docs.dashlink.ai/api-reference/branded-links/create-platform-subdomain) | `POST` | Claim a platform subdomain |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.