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"
}
}'
import requests
import json
url = "https://api.mythic-analytics.com/api/v1/clients/example_string/links"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"destination_url": "https://acme-retail.com/summer-sale",
"slug": "summer-sale",
"title": "Summer Sale Campaign",
"metadata": {
"campaign": "summer-2024"
}
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api.mythic-analytics.com/api/v1/clients/example_string/links", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"destination_url": "https://acme-retail.com/summer-sale",
"slug": "summer-sale",
"title": "Summer Sale Campaign",
"metadata": {
"campaign": "summer-2024"
}
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"destination_url": "https://acme-retail.com/summer-sale",
"slug": "summer-sale",
"title": "Summer Sale Campaign",
"metadata": {
"campaign": "summer-2024"
}
}`)
req, err := http.NewRequest("POST", "https://api.mythic-analytics.com/api/v1/clients/example_string/links", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.mythic-analytics.com/api/v1/clients/example_string/links')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"destination_url": "https://acme-retail.com/summer-sale",
"slug": "summer-sale",
"title": "Summer Sale Campaign",
"metadata": {
"campaign": "summer-2024"
}
}'
response = http.request(request)
puts response.body
{
"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"
}
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
/clients/{id}/linksAdmin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY
Bearer YOUR_ADMIN_KEYClient identifier.
The media type of the request body
Target URL the short link redirects to.
Custom slug for the short link. Auto-generated if omitted.
Human-readable title for the link.
Arbitrary JSON metadata attached to the link.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Admin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY
Path Parameters
Client identifier.
Body
Target URL the short link redirects to.
Custom slug for the short link. Auto-generated if omitted.
Human-readable title for the link.
Arbitrary JSON metadata attached to the link.
Responses
Last updated 4 days ago