Create a snippet

Create a custom code snippet injected by the SDK. code is required. Agency key (ak_) required. Rebuilds the edge config — check kv_sync.

curl -X POST "https://mythic-analytics.gulp.workers.dev/client/v1/config/snippets?location_id=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "code": "console.log('hello from mythic');",
  "description": "Debug logger",
  "enabled": true,
  "trigger_rules": {
    "url_contains": "/checkout"
  }
}'

import requests
import json

url = "https://mythic-analytics.gulp.workers.dev/client/v1/config/snippets?location_id=example_string"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
  "code": "console.log('hello from mythic');",
  "description": "Debug logger",
  "enabled": true,
  "trigger_rules": {
    "url_contains": "/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/snippets?location_id=example_string", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
},
  body: JSON.stringify({
  "code": "console.log('hello from mythic');",
  "description": "Debug logger",
  "enabled": true,
  "trigger_rules": {
    "url_contains": "/checkout"
  }
})
});

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

package main

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

func main() {
    data := []byte(`{
  "code": "console.log('hello from mythic');",
  "description": "Debug logger",
  "enabled": true,
  "trigger_rules": {
    "url_contains": "/checkout"
  }
}`)

    req, err := http.NewRequest("POST", "https://mythic-analytics.gulp.workers.dev/client/v1/config/snippets?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/snippets?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 = '{
  "code": "console.log('hello from mythic');",
  "description": "Debug logger",
  "enabled": true,
  "trigger_rules": {
    "url_contains": "/checkout"
  }
}'

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

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "tenant_key": "loc_abc123",
    "description": "Debug logger",
    "enabled": true,
    "trigger_rules": {
      "url_contains": "/checkout"
    },
    "created_at": "2024-12-25T10:00:00Z",
    "updated_at": "2024-12-25T10:00:00Z",
    "code": "console.log('hello from mythic');"
  },
  "kv_sync": "synced"
}

{
  "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/snippets

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

codestring

Required

JavaScript executed by the SDK on matching pages.

descriptionstring

enabledboolean

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.