Skip to main content
POST
/
v1
/
tag
/
{uid}
/
experiment
/tag/:uid/experiment
curl --request POST \
  --url https://api.tagdeliver.com/v1/tag/{uid}/experiment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "audience_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "browser_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "description": "<string>",
  "device_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "geo_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "region_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "subject": [
    {
      "allocation": 123,
      "config_id": 123
    }
  ],
  "title": "<string>",
  "url_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "viewport_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "os_filter": {
    "matches": [
      "<string>"
    ],
    "type": "<string>"
  },
  "end": "2023-12-25",
  "start": "2023-12-25"
}'
{
  "results": {
    "id": 583,
    "uid": 18620,
    "title": "Test Experiment",
    "start": "2025-11-01",
    "end": "2025-11-30",
    "auto_activate": false,
    "subject": [
      {
        "allocation": 50,
        "config_id": 8388
      },
      {
        "allocation": 50,
        "config_id": 8389
      }
    ],
    "url_filter": {
      "matches": [],
      "type": "include"
    },
    "device_filter": {
      "matches": [],
      "type": "include"
    },
    "geo_filter": {
      "matches": [],
      "type": "include"
    },
    "audience_filter": {
      "matches": [],
      "type": "include"
    },
    "browser_filter": {
      "matches": [],
      "type": "include"
    },
    "viewport_filter": {
      "matches": [],
      "type": "include"
    },
    "region_filter": {
      "matches": [],
      "type": "include"
    },
    "status": 1,
    "description": "",
    "os_filter": {
      "matches": [],
      "type": "include"
    }
  },
  "success": true
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

uid
integer
required

Publisher ID

Body

application/json
audience_filter
object
browser_filter
object
description
string
device_filter
object
geo_filter
object
region_filter
object
subject
object[]
title
string
url_filter
object
viewport_filter
object
os_filter
object
end
string<date>
start
string<date>

Response

200 - application/json
results
object
required
success
boolean
required