CDPGuidesSupport

Tag Managers

Manage pixel-scoped tag manager containers — the parent of tags, triggers, variables, and folders. Create a tag manager, edit its display name and data-layer override, or delete the container (which cascade-deletes its children).

Tag managers are pixel-scoped containers that hold tags, triggers, variables, and folders. Create a tag manager to get a pixel token, then drop the install snippet on your site so the SDK can load and evaluate tags.

A new tag manager is seeded with three default triggers (Initialization, PageView, DomReady) and one OursInitTag so the container is immediately usable. Child entities are managed via the sibling resources:

Deleting a tag manager cascades to every child it owns.

GET/rest/v1/tag-managers

GET
/rest/v1/tag-managers
AuthorizationBearer <token>

Ours Privacy API key

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/rest/v1/tag-managers"
{  "entities": [    {      "id": "string",      "accountId": "string",      "name": "string",      "pixel": "string",      "dataLayerName": "string",      "createdAt": "string",      "updatedAt": "string"    }  ]}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

POST/rest/v1/tag-managers

POST
/rest/v1/tag-managers
*object
AuthorizationBearer <token>

Ours Privacy API key

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/rest/v1/tag-managers" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "id": "string",  "accountId": "string",  "name": "string",  "pixel": "string",  "dataLayerName": "string",  "createdAt": "string",  "updatedAt": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

GET/rest/v1/tag-managers/{id}

GET
/rest/v1/tag-managers/{id}
AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/rest/v1/tag-managers/string"
{  "id": "string",  "accountId": "string",  "name": "string",  "pixel": "string",  "dataLayerName": "string",  "createdAt": "string",  "updatedAt": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

PATCH/rest/v1/tag-managers/{id}

PATCH
/rest/v1/tag-managers/{id}
*object
AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/rest/v1/tag-managers/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "string",  "accountId": "string",  "name": "string",  "pixel": "string",  "dataLayerName": "string",  "createdAt": "string",  "updatedAt": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

DELETE/rest/v1/tag-managers/{id}

DELETE
/rest/v1/tag-managers/{id}
AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/rest/v1/tag-managers/string"
{  "id": "string",  "deleted": true}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

How is this guide?