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"
}
}'
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
}
POST
/clients/{id}/linksPOST
Security Scheme
Bearer Tokenstring
RequiredAdmin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY
Admin API key as bearer token. Format:
Bearer YOUR_ADMIN_KEYpath
idstring
RequiredClient identifier.
Pattern: ^[a-zA-Z0-9_-]{1,255}$
Content-Typestring
RequiredThe media type of the request body
Options: application/json
destination_urlstring
RequiredTarget 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
RequiredBearer token. Admin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY
Path Parameters
idstring
RequiredClient identifier.
Body
application/json
destination_urlstring
RequiredTarget 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
Was this page helpful?
Built with Documentation.AI
Last updated today