ConfigUpdate a tag assignment

Update a tag assignment

Partial update — only the fields you pass change. Accepts enabled, params, trigger_rules. Agency key (ak_) required. Rebuilds the edge config — check kv_sync.

curl -X PATCH "https://mythic-analytics.gulp.workers.dev/client/v1/config/tags/meta-pixel?location_id=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "enabled": true,
  "params": {},
  "trigger_rules": {
    "url_contains": "/checkout"
  }
}'
{
  "success": true,
  "data": {
    "tenant_key": "loc_abc123",
    "tag_id": "meta-pixel",
    "enabled": true,
    "params": {
      "pixel_id": "1234567890"
    },
    "trigger_rules": {
      "url_contains": "/checkout"
    }
  },
  "kv_sync": "synced"
}
PATCH
/client/v1/config/tags/{tagId}
PATCH
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.

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.
path
tagIdstring
Required

The tag template id of the assignment.

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
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.

Path Parameters

tagIdstring
Required

The tag template id of the assignment.

Example:
meta-pixel

Query Parameters

location_idstring

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

Body

application/json
trigger_rulesobject

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

Example:
{"url_contains":"/checkout"}

Responses

successboolean
dataobject
kv_syncstring

Outcome of the inline edge-config rebuild that follows every write. synced means the location's CFG KV entry was rebuilt from database truth and the SDK will pick the change up; failed: \<reason\> means the database write landed but the edge is still serving the previous config — retry the write (any successful write re-syncs everything) or rebuild via the admin API. This field exists because tenant-config KV sync is not trigger-driven; a write the SDK never sees is the failure mode, so a failed sync is reported instead of silent.