Tag Manager Tags API - Ours Privacy

Manage the tags that fire inside a tag manager. Tags reference one or more triggers — when a trigger matches, the tag's parameters are evaluated and the tag fires (with optional block triggers that suppress it).

Tags are the actions a tag manager performs — fire a Google Analytics event, drop a Meta pixel call, run a custom snippet, etc. Every tag belongs to exactly one tag manager and references trigger ids that decide when it fires.

fireTriggerIds — when any of these triggers match, the tag fires.
blockTriggerIds — if any of these triggers match in the same evaluation, the tag is suppressed (evaluated after fire triggers).
parameters — type-specific JSON. Call GET /rest/v1/tag-manager-tags/types for the supported type values and the exact shape parameters must take.
folderId is read-only on this endpoint. To move a tag into a folder, use the GraphQL assignTagManagerAssetToFolder mutation.

Tags cannot move between tag managers; omit tagManagerId on PATCH.

Discovering supported tag types

Call GET /rest/v1/tag-manager-tags/types to list the supported type values and the per-type parameters schema. Each field entry tells you whether the value is required, what validators apply, and (for fields with a fixed set of choices) the allowed availableValues. Sending an unknown type or a parameters payload that violates one of those constraints returns HTTP 400.

Authorization

apiKey

AuthorizationBearer <token>

Ours Privacy API key

In: header

Query Parameters

limit?|

Maximum number of tags to return. Defaults to 25; values below 1 are clamped to 1 and values above 1000 are clamped to 1000. The web-app passes 1000 to render the full workspace in one request.

cursor?string

Opaque pagination cursor from pagination.nextCursor in the previous response. Do not decode or modify it. Malformed cursors return 400 Bad Request.

tagManagerId*string

Parent tag manager whose tags should be returned.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://app.oursprivacy.com/rest/v1/tag-manager-tags?tagManagerId=string"

{
  "entities": [
    {
      "id": "string",
      "tagManagerId": "string",
      "accountId": "string",
      "name": "string",
      "type": "string",
      "Tag": "string",
      "parameters": {},
      "fireTriggerIds": [
        "string"
      ],
      "blockTriggerIds": [
        "string"
      ],
      "priority": 0,
      "enabled": true,
      "folderId": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

Authorization

apiKey

AuthorizationBearer <token>

Ours Privacy API key

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tagManagerId*string

Parent tag manager that will own the new tag.

Length1 <= length

name*string

Human-readable tag name.

type*string

Tag type discriminator. Pick from GET /tag-manager-tags/types for the canonical set (e.g. OursTrackTag, OursInitTag, CustomHtmlTag). Names like GA4Event are not valid ids.

Tag*string

Must equal type — send the same string in both fields. The server rejects any divergent value.

parameters*

Type-specific JSON configuration. Send {} for a placeholder.

fireTriggerIds*array<>

Trigger ids that cause this tag to fire. Use [] only for placeholder tags.

blockTriggerIds?array<>|

Optional trigger ids that block this tag when they match.

priority?|

Defaults to 0.

enabled?|

Defaults to true.

Response Body

`application/json`

curl -X POST "https://app.oursprivacy.com/rest/v1/tag-manager-tags" \  -H "Content-Type: application/json" \  -d '{    "tagManagerId": "string",    "name": "string",    "type": "string",    "Tag": "string",    "parameters": {},    "fireTriggerIds": [      "string"    ]  }'

{
  "id": "string",
  "tagManagerId": "string",
  "accountId": "string",
  "name": "string",
  "type": "string",
  "Tag": "string",
  "parameters": {},
  "fireTriggerIds": [
    "string"
  ],
  "blockTriggerIds": [
    "string"
  ],
  "priority": 0,
  "enabled": true,
  "folderId": "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"
}

Authorization

apiKey

AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Response Body

`application/json`

curl -X GET "https://app.oursprivacy.com/rest/v1/tag-manager-tags/string"

{
  "id": "string",
  "tagManagerId": "string",
  "accountId": "string",
  "name": "string",
  "type": "string",
  "Tag": "string",
  "parameters": {},
  "fireTriggerIds": [
    "string"
  ],
  "blockTriggerIds": [
    "string"
  ],
  "priority": 0,
  "enabled": true,
  "folderId": "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"
}

Authorization

apiKey

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.

name?string

Updated tag name.

type?string

Updated tag type. Pick from GET /tag-manager-tags/types. When changing type, send the new value in Tag as well (they must match).

Tag?string

Must equal type. Omit both fields, or send both with the same value — the server rejects any divergence.

parameters?

Updated type-specific JSON configuration.

fireTriggerIds?array<>

Replaces the fire trigger list wholesale.

blockTriggerIds?array<>|

Replaces the block trigger list wholesale. Send null to clear.

priority?|

Updated priority.

enabled?|

Pause/resume the tag without changing other fields.

Response Body

`application/json`

curl -X PATCH "https://app.oursprivacy.com/rest/v1/tag-manager-tags/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "id": "string",
  "tagManagerId": "string",
  "accountId": "string",
  "name": "string",
  "type": "string",
  "Tag": "string",
  "parameters": {},
  "fireTriggerIds": [
    "string"
  ],
  "blockTriggerIds": [
    "string"
  ],
  "priority": 0,
  "enabled": true,
  "folderId": "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"
}

Authorization

apiKey

AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Response Body

`application/json`

curl -X DELETE "https://app.oursprivacy.com/rest/v1/tag-manager-tags/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"
}

Authorization

apiKey

AuthorizationBearer <token>

Ours Privacy API key

In: header

Response Body

`application/json`

curl -X GET "https://app.oursprivacy.com/rest/v1/tag-manager-tags/types"

{
  "entities": [
    {
      "id": "string",
      "name": "string",
      "category": "string",
      "description": "string",
      "fields": [
        {
          "id": "string",
          "type": "STRING",
          "title": "string",
          "description": "string",
          "required": true,
          "default": {},
          "availableValues": [
            {
              "value": "string",
              "label": "string"
            }
          ],
          "allowedKeys": [
            "string"
          ],
          "validators": [
            {
              "type": "NotEmpty",
              "min": 0,
              "max": 0
            }
          ]
        }
      ]
    }
  ]
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

{
  "error": "string",
  "details": "string"
}

Tag Manager Tags

Discovering supported tag types

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`