LinksCreate link
Links

Create link

Create a new short link for a client tenant. The link is assigned a unique slug and tracks click analytics automatically.

curl -X POST "https://api.mythic-analytics.com/api/v1/clients/example_string/links" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "destination_url": "https://acme-retail.com/summer-sale",
  "slug": "summer-sale",
  "title": "Summer Sale Campaign",
  "metadata": {
    "campaign": "summer-2024"
  }
}'
{
  "success": true,
  "data": {
    "id": "lnk_9xP3qLmN",
    "client_id": "acme-retail",
    "destination_url": "https://acme-retail.com/summer-sale",
    "short_url": "https://go.mythic-analytics.com/summer-sale",
    "slug": "summer-sale",
    "title": "Summer Sale Campaign",
    "clicks": 1247,
    "metadata": {},
    "created_at": "2024-06-01T12:00:00.000Z",
    "updated_at": "2024-06-15T08:30:00.000Z"
  }
}
POST
/clients/{id}/links
POST
Security Scheme
Bearer Tokenstring
Required

Admin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY

Admin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY
path
idstring
Required

Client identifier.

Pattern: ^[a-zA-Z0-9_-]{1,255}$
Content-Typestring
Required

The media type of the request body

Options: application/json
destination_urlstring
Required

Target URL the short link redirects to.

Format: uri
slugstring

Custom slug for the short link. Auto-generated if omitted.

titlestring

Human-readable title for the link.

metadataobject

Arbitrary JSON metadata attached to the link.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Admin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY

Path Parameters

idstring
Required

Client identifier.

Body

application/json
destination_urlstring
Required

Target URL the short link redirects to.

slugstring

Custom slug for the short link. Auto-generated if omitted.

titlestring

Human-readable title for the link.

metadataobject

Arbitrary JSON metadata attached to the link.

Responses