Overview
Client Links API
Create and manage short links with click analytics, webhook notifications, and uptime monitoring via the Client Links API.
Overview
The Client Links API provides short link management with built-in analytics. Create branded short URLs, track click performance, set up webhook notifications for link events, and monitor destination URL availability.
Base URL
All endpoints share the same base URL and version prefix.
https://api.mythic-analytics.com/api/v1
Response envelope
All endpoints return a JSON envelope.
successboolean
RequiredWhether the request succeeded.
dataobject|array|null
Resource payload. Shape depends on the endpoint.
countinteger
Total number of matching resources. Present on list endpoints.
errorstring|null
Error message on failed requests.
Key concepts
| Concept | Description |
|---|---|
| Short Link | A branded URL that redirects to a destination and tracks clicks |
| Analytics | Per-link click stats including referrers, geography, and devices |
| Webhook | HTTP callback subscriptions for link events (clicks, uptime alerts) |
| Uptime Monitoring | Automated availability checks for link destination URLs |
Error handling
| Status | Meaning |
|---|---|
400 | Invalid JSON, missing required fields, or validation error |
401 | Admin key missing or invalid |
404 | Link or webhook not found |
409 | Conflict — duplicate slug |
500 | Internal server error |
Check both the HTTP status code and the error field in the response body for programmatic error handling.
Was this page helpful?
Built with Documentation.AI
Last updated today