digitalpublic-com Google Tag Manager API

openapi: 3.2.0
info:
  title: DigitalPublic Agent Google Tag Manager API
  version: 2026-09-10-trial-active-projects-v1
  description: API for external AI agents to interact with DigitalPublic projects. Provides discovery, project context, Google Ads, Meta Ads, LinkedIn organic and LinkedIn Ads, Merchant Center, SEO, AEO, Search Console, WordPress, Analytics, Tag Manager, Business Profile, mailings, CRM, comments, reports, and scheduling.
  contact:
    email: soporte@digitalpublic.com
servers:
- url: https://platform.digitalpublic.com
  description: Production
security:
- bearerAuth: []
tags:
- name: Google Tag Manager
paths:
  /api/google-tag-manager/agent-query:
    post:
      summary: Google Tag Manager query tools
      description: Query and audit the Google Tag Manager container assigned to the project.
      tags:
      - Google Tag Manager
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentResponse'
      x-tools:
      - name: gtm_status
        description: Container assignment, public ID, account, and summary counts.
        params: {}
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_workspaces
        description: List GTM workspaces.
        params: {}
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: get_workspace_status
        description: Find modified/conflicting entities in a workspace.
        params:
          workspaceId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_tags
        description: List tags in a workspace.
        params:
          workspaceId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: get_tag
        description: Get one tag by tagId or path.
        params:
          workspaceId:
            type: string
          tagId:
            type: string
          path:
            type: string
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_triggers
        description: List triggers in a workspace.
        params:
          workspaceId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: get_trigger
        description: Get one trigger by triggerId or path.
        params:
          workspaceId:
            type: string
          triggerId:
            type: string
          path:
            type: string
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_variables
        description: List variables in a workspace.
        params:
          workspaceId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: get_variable
        description: Get one variable by variableId or path.
        params:
          workspaceId:
            type: string
          variableId:
            type: string
          path:
            type: string
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_folders
        description: List folders in a workspace.
        params:
          workspaceId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_templates
        description: List templates in a workspace.
        params:
          workspaceId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_environments
        description: List GTM environments.
        params: {}
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_versions
        description: List GTM container versions.
        params: {}
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: quick_preview
        description: Create a quick preview for a workspace.
        params:
          workspaceId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: check_mutation_status
        description: Check one pending GTM mutation.
        params:
          mutationId:
            type: string
            required: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_pending_mutations
        description: List pending GTM mutations.
        params:
          limit:
            type: number
            default: 20
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: list_mutation_history
        description: List GTM mutation history.
        params:
          status:
            type: string
            default: all
          limit:
            type: number
            default: 20
          resource:
            type: string
            optional: true
        x-mcp:
          channel: gtm
          effect: read
          requiredScope: read
          approval: none
          requestShape: tool_params
          workload:
            executionMode: INLINE
            resourceClass: LIGHT
            priority: INTERACTIVE
            costModel: FIXED
            idempotencyMode: READ_BEFORE_WRITE
      - name: update_pending_mutation
        description: Update a pending GTM mutation.
        params:
          mutationId:
            type: string
            required: true
          agent_note:
            type: string
            optional: true
          data:
            type: array
            optional: true
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: none
          requestShape: tool_params
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - name: cancel_pending_mutation
        description: Cancel a pending GTM mutation.
        params:
          mutationId:
            type: string
            required: true
          reason:
            type: string
            optional: true
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: none
          requestShape: tool_params
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      operationId: postApiGoogleTagManagerAgentQuery
      x-operation-id-source: derived
  /api/google-tag-manager/agent-mutate:
    post:
      summary: Google Tag Manager mutations
      description: Link an existing GTM container to a project or queue workspace, tag, trigger, variable, template, environment, and version changes for admin approval. Requires write scope.
      tags:
      - Google Tag Manager
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentRequest'
      responses:
        '200':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentResponse'
      x-tools:
      - name: queue_gtm_mutation
        description: Link an existing GTM container or queue a GTM API mutation scoped to the project's assigned container.
        params:
          resource:
            type: string
            required: true
            description: gtm_container | gtm_workspaces | gtm_tags | gtm_triggers | gtm_variables | gtm_built_in_variables | gtm_folders | gtm_templates | gtm_clients | gtm_zones | gtm_transformations | gtm_environments | gtm_versions
          operation:
            type: string
            required: true
            description: link | create | update | delete | revert | sync | import_from_gallery | move_entities_to_folder | reauthorize | publish | set_latest | undelete
          workspaceId:
            type: string
            optional: true
          data:
            type: array
            required: true
          validate_only:
            type: boolean
            default: false
          agent_note:
            type: string
            optional: true
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      x-resources:
      - resource: gtm_container
        operations:
        - link
        description: Validate an existing GTM container against the Google API and link it to the selected project. Shared containers are allowed; no GTM content is changed.
        operationParams:
          link:
            data:
              type: array
              required: true
              minItems: 1
              maxItems: 1
              description: One object with publicId, or containerPath, or accountId/accountPath plus containerId.
              items:
                type: object
                properties:
                  publicId:
                    type: string
                    description: Public GTM ID, for example GTM-PLRNJP6R.
                  containerPath:
                    type: string
                    description: GTM API path, for example accounts/1/containers/2.
                  accountId:
                    type: string
                  accountPath:
                    type: string
                  containerId:
                    type: string
                  accountName:
                    type: string
                  name:
                    type: string
                  domainName:
                    type: string
            agent_note:
              type: string
              required: true
              description: Audit note explaining why this existing container is linked to the project.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_workspaces
        operations:
        - create
        - update
        - delete
        - sync
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_tags
        operations:
        - create
        - update
        - delete
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        operationParams:
          create:
            workspaceId:
              type: string
              optional: true
              description: Workspace ID or full workspace path. Required unless every data item includes parent.
            data:
              type: array
              required: true
              description: GTM tag objects. Each item must resolve its workspace from top-level workspaceId or parent.
              items:
                type: object
                properties:
                  parent:
                    type: string
                    optional: true
                    description: 'Full workspace path: accounts/{accountId}/containers/{containerId}/workspaces/{workspaceId}.'
            validate_only:
              type: boolean
              default: false
              description: Validates the workspace parent and payload structure without queuing a mutation.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_triggers
        operations:
        - create
        - update
        - delete
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_variables
        operations:
        - create
        - update
        - delete
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_built_in_variables
        operations:
        - create
        - delete
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_folders
        operations:
        - create
        - update
        - delete
        - move_entities_to_folder
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_templates
        operations:
        - create
        - update
        - delete
        - import_from_gallery
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_clients
        operations:
        - create
        - update
        - delete
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_zones
        operations:
        - create
        - update
        - delete
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_transformations
        operations:
        - create
        - update
        - delete
        - revert
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_environments
        operations:
        - create
        - update
        - delete
        - reauthorize
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      - resource: gtm_versions
        operations:
        - create
        - publish
        - set_latest
        - delete
        - undelete
        description: Queue a GTM API mutation scoped to the project's assigned container.
        x-mcp:
          channel: gtm
          effect: write
          requiredScope: write
          approval: auto_approval_possible
          requestShape: resource_operation
          workload:
            executionMode: AUTO
            resourceClass: STANDARD
            priority: NORMAL
            costModel: ITEMS
            idempotencyMode: READ_BEFORE_WRITE
      operationId: postApiGoogleTagManagerAgentMutate
      x-operation-id-source: derived
components:
  schemas:
    AgentRequest:
      type: object
      required:
      - tool
      properties:
        tool:
          type: string
          description: Tool name to execute
        params:
          type: object
          description: Tool-specific parameters
          default: {}
        projectId:
          type: string
          description: Required when using a dpa_ global agent token. dpk_ project API keys infer the project automatically.
    AgentResponse:
      type: object
      properties:
        ok:
          type: boolean
        status:
          type: string
          description: executed, queued, pending_approval, or a domain-specific status
        operationId:
          type: string
          description: Persistent operation id when work continues in the background.
        resourceClass:
          type: string
          enum:
          - LIGHT
          - STANDARD
          - HEAVY
        retryAfterSeconds:
          type: integer
        data:
          type: object
        error:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Project API key starting with dpk_ or global agent token starting with dpa_. dpa_ requests must include projectId or X-DigitalPublic-Project-Id for project-scoped endpoints.
x-commercial-channels:
- key: google_ads
  label:
    es: Google Ads
    en: Google Ads
  commercialModule: google_ads
  services:
  - googleAds
  mcpChannels:
  - google_ads
  public: true
  availability: generally_available
  access: read_write
  requiresConnection: true
  acceptedAliases:
  - google-ads
- key: wordpress
  label:
    es: WordPress
    en: WordPress
  commercialModule: seo_aeo
  services:
  - wordpressSeo
  mcpChannels:
  - wordpress
  public: true
  availability: generally_available
  access: read_write
  requiresConnection: true
  acceptedAliases:
  - wordpress-seo
- key: crm
  label:
    es: CRM
    en: CRM
  commercialModule: crm
  services:
  - crm
  mcpChannels:
  - crm
  public: true
  availability: generally_available
  access: read_write
  requiresConnection: true
  acceptedAliases: []
- key: websites
  label:
    es: Sitios web
    en: Websites
  commercialModule: content_web
  services:
  - landingPages
  mcpChannels:
  - landing_pages
  public: true
  availability: generally_available
  access: read_write
  requiresConnection: true
  acceptedAliases:
  - landing-pages
  - landing_pages
  - sites-web
  - sites_web
- key: social
  label:
    es: Redes sociales
    en: Social media
  commercialModule: social
  services:
  - socialOrganic
  - socialX
  - socialLinkedIn
  mcpChannels:
  - social
  public: true
  availability: generally_available
  access: read_write
  requiresConnection: true
  acceptedAliases: []
- key: blog
  label:
    es: Blog
    en: Blog
  commercialModule: content_web
  services:
  - blog
  mcpChannels:
  - blog
  public: true
  availability: generally_available
  access: read_write
  requiresConnection: true
  acceptedAliases: []
- key: meta_ads
  label:
    es: Meta Ads
    en: Meta Ads
  commercialModule: meta_ads
  services:
  - metaAds
  mcpChannels:
  - meta_ads
  public: true
  availability: limited
  access: read_write
  requiresConnection: true
  acceptedAliases:
  - meta-ads
  - meta
- key: linkedin_ads
  label:
    es: LinkedIn Ads
    en: LinkedIn Ads
  commercialModule: linkedin_ads
  services:
  - linkedinAds
  mcpChannels:
  - linkedin_ads
  public: true
  availability: limited
  access: read_write
  requiresConnection: true
  acceptedAliases:
  - linkedin-ads
  - linkedin
- key: seo
  label:
    es: SEO y AEO
    en: SEO and AEO
  commercialModule: seo_aeo
  services:
  - seo
  - aeo
  mcpChannels:
  - seo_tools
  - aeo
  public: true
  availability: limited
  access: read_write
  requiresConnection: false
  acceptedAliases: []
- key: analytics
  label:
    es: Analítica
    en: Analytics
  commercialModule: analytics
  services:
  - analytics
  mcpChannels:
  - analytics
  public: true
  availability: limited
  access: read
  requiresConnection: true
  acceptedAliases: []
- key: search_console
  label:
    es: Search Console
    en: Search Console
  commercialModule: search_console
  services:
  - searchConsole
  mcpChannels:
  - search_console
  public: true
  availability: limited
  access: read_write
  requiresConnection: true
  acceptedAliases:
  - search-console
- key: email
  label:
    es: Email y newsletters
    en: Email and newsletters
  commercialModule: email_marketing
  services:
  - mailings
  mcpChannels:
  - mailings
  public: true
  availability: limited
  access: read_write
  requiresConnection: true
  acceptedAliases:
  - brevo