Create a tag template

Create a template owned by this location. Only this location can see, edit, delete or assign it. It does nothing until assigned with POST /client/v1/config/tags, so there is no edge rebuild and no kv_sync. Agency key (ak_) or an mcp_ key with tags:write required.

curl -X POST "https://mythic-analytics.gulp.workers.dev/client/v1/config/tag-templates?location_id=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "name": "Hotjar",
  "type": "url",
  "src": "https://static.hotjar.com/c/hotjar-1234567.js?sv=6",
  "code": "example_string",
  "description": "example_string",
  "trigger_rules": {
    "version": 1,
    "operator": "AND",
    "rules": [
      {
        "type": "url_pattern",
        "operator": "contains",
        "value": "/checkout"
      }
    ]
  }
}'

import requests
import json

url = "https://mythic-analytics.gulp.workers.dev/client/v1/config/tag-templates?location_id=example_string"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
  "name": "Hotjar",
  "type": "url",
  "src": "https://static.hotjar.com/c/hotjar-1234567.js?sv=6",
  "code": "example_string",
  "description": "example_string",
  "trigger_rules": {
    "version": 1,
    "operator": "AND",
    "rules": [
      {
        "type": "url_pattern",
        "operator": "contains",
        "value": "/checkout"
      }
    ]
  }
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://mythic-analytics.gulp.workers.dev/client/v1/config/tag-templates?location_id=example_string", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
},
  body: JSON.stringify({
  "name": "Hotjar",
  "type": "url",
  "src": "https://static.hotjar.com/c/hotjar-1234567.js?sv=6",
  "code": "example_string",
  "description": "example_string",
  "trigger_rules": {
    "version": 1,
    "operator": "AND",
    "rules": [
      {
        "type": "url_pattern",
        "operator": "contains",
        "value": "/checkout"
      }
    ]
  }
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "name": "Hotjar",
  "type": "url",
  "src": "https://static.hotjar.com/c/hotjar-1234567.js?sv=6",
  "code": "example_string",
  "description": "example_string",
  "trigger_rules": {
    "version": 1,
    "operator": "AND",
    "rules": [
      {
        "type": "url_pattern",
        "operator": "contains",
        "value": "/checkout"
      }
    ]
  }
}`)

    req, err := http.NewRequest("POST", "https://mythic-analytics.gulp.workers.dev/client/v1/config/tag-templates?location_id=example_string", 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://mythic-analytics.gulp.workers.dev/client/v1/config/tag-templates?location_id=example_string')
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 = '{
  "name": "Hotjar",
  "type": "url",
  "src": "https://static.hotjar.com/c/hotjar-1234567.js?sv=6",
  "code": "example_string",
  "description": "example_string",
  "trigger_rules": {
    "version": 1,
    "operator": "AND",
    "rules": [
      {
        "type": "url_pattern",
        "operator": "contains",
        "value": "/checkout"
      }
    ]
  }
}'

response = http.request(request)
puts response.body

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "owner": "mythic",
    "managed": true,
    "name": "Hotjar",
    "type": "url",
    "src": "https://static.hotjar.com/c/hotjar-1234567.js?sv=6",
    "code": "example_string",
    "description": "example_string",
    "trigger_rules": {
      "version": 1,
      "operator": "AND",
      "rules": [
        {
          "type": "url_pattern",
          "operator": "contains",
          "value": "/checkout"
        }
      ]
    },
    "created_at": "2024-12-25T10:00:00Z",
    "updated_at": "2024-12-25T10:00:00Z"
  }
}

{
  "error": "Bad Request",
  "message": "The request contains invalid parameters or malformed data",
  "code": 400,
  "details": [
    {
      "field": "email",
      "message": "Invalid email format"
    }
  ]
}

POST

/client/v1/config/tag-templates

POST

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

Bearer Tokenstring

Required

Agency key (ak_) or location secret key (sk_). Writes require an agency key. Keys are server-side credentials — this surface serves no CORS headers on purpose. Scoped keys (mcp_) are accepted too and need the tags, snippets or transformers family the route belongs to. See Using an mcp_ key over HTTP.

query

location_idstring

Location to scope to. Required for ak_ keys (or send the X-Location-Id header); ignored for sk_.

Content-Typestring

Required

The media type of the request body

Options: application/json

Max length: 200

Options: url, inline

Absolute https URL, loaded as an async script.

codestring

JavaScript run as a <script> body. Not HTML.

Max length: 65536

descriptionstring

Max length: 2000

trigger_rulesobject

Optional page/condition rules controlling where the tag or snippet fires. Omitted or null means everywhere.

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token. Agency key (ak_) or location secret key (sk_). Writes require an agency key. Keys are server-side credentials — this surface serves no CORS headers on purpose. Scoped keys (mcp_) are accepted too and need the tags, snippets or transformers family the route belongs to. See Using an mcp_ key over HTTP.