Matomo · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Matomo Reporting API for plugin Tag Manager API

48 actions 48 updates phrasing extends openapi/matomo-tag-manager-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Matomo's API. It is a proposal applied on top of the contract, not a document Matomo publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 48 · first 16 shown; the file carries all of them

$.info
$.paths['/index.php?module=API&method=TagManager.getAvailableContexts'].get
$.paths['/index.php?module=API&method=TagManager.getAvailableEnvironments'].get
$.paths['/index.php?module=API&method=TagManager.getAvailableEnvironmentsWithPublishCapability'].get
$.paths['/index.php?module=API&method=TagManager.getAvailableTagFireLimits'].get
$.paths['/index.php?module=API&method=TagManager.getAvailableComparisons'].get
$.paths['/index.php?module=API&method=TagManager.getAvailableTagTypesInContext'].get
$.paths['/index.php?module=API&method=TagManager.getAvailableTriggerTypesInContext'].get
$.paths['/index.php?module=API&method=TagManager.getAvailableVariableTypesInContext'].get
$.paths['/index.php?module=API&method=TagManager.getContainerEmbedCode'].get
$.paths['/index.php?module=API&method=TagManager.getContainerInstallInstructions'].get
$.paths['/index.php?module=API&method=TagManager.getContainerTags'].get
$.paths['/index.php?module=API&method=TagManager.createDefaultContainerForSite'].get
$.paths['/index.php?module=API&method=TagManager.addContainerTag'].get
$.paths['/index.php?module=API&method=TagManager.updateContainerTag'].get
$.paths['/index.php?module=API&method=TagManager.deleteContainerTag'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Matomo Reporting API for plugin Tag Manager API
  version: 1.0.0
extends: openapi/matomo-tag-manager-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 47
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableContexts'].get
  update:
    x-apievangelist-phrasing:
      intent: List contexts that support tag types
      effect: read
      questions:
      - Which container contexts, like web or Android, does Tag Manager currently support?
      - What contexts can I choose from when I set up a new container?
      instructions:
      - text: List the Tag Manager contexts that expose at least one tag type.
      - text: Show me which container contexts I can pick from.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableEnvironments'].get
  update:
    x-apievangelist-phrasing:
      intent: List environments for container releases
      effect: read
      questions:
      - Which release environments exist for publishing Tag Manager containers?
      - Is there a staging environment I can release a container to besides live?
      instructions:
      - text: List every environment a container release can go to.
      - text: Show the available container release environments across the instance.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableEnvironmentsWithPublishCapability'].get
  update:
    x-apievangelist-phrasing:
      intent: List environments I can publish to for a site
      effect: read
      questions:
      - Which environments am I personally allowed to publish containers to on this site?
      - Can my user account release to the live environment for a given website?
      instructions:
      - text: List the environments I have permission to publish to on site {idSite}.
        slots:
          idSite: query.idSite
      - text: Check which release environments my user can publish containers to for website {idSite}.
        slots:
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableTagFireLimits'].get
  update:
    x-apievangelist-phrasing:
      intent: List the fire limit options for tags
      effect: read
      questions:
      - What fire limit options can I set so a tag only fires once per page or once ever?
      - Which values are valid for a tag's fire limit?
      instructions:
      - text: List the supported tag fire limit options.
      - text: Show me the choices for limiting how often a tag fires.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableComparisons'].get
  update:
    x-apievangelist-phrasing:
      intent: List comparison operators for trigger conditions
      effect: read
      questions:
      - Which comparison operators, like contains or starts with, can trigger conditions use?
      - What matching options are available for variable lookup tables?
      instructions:
      - text: List the comparison operators available for trigger conditions and lookup tables.
      - text: Show the matching operators I can use in a trigger condition.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableTagTypesInContext'].get
  update:
    x-apievangelist-phrasing:
      intent: List tag templates for a context
      effect: read
      questions:
      - What tag types can I add to a web container?
      - Which tag templates are supported in a particular container context?
      instructions:
      - text: List the tag templates supported in context {idContext}.
        slots:
          idContext: query.idContext
      - text: Show which kinds of tags I can create for the {idContext} context.
        slots:
          idContext: query.idContext
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableTriggerTypesInContext'].get
  update:
    x-apievangelist-phrasing:
      intent: List trigger templates for a context
      effect: read
      questions:
      - What trigger types, like page view or click, are available in a web container?
      - Which trigger templates does a given container context support?
      instructions:
      - text: List the trigger templates available in context {idContext}.
        slots:
          idContext: query.idContext
      - text: Show the trigger types I can set up for a {idContext} container.
        slots:
          idContext: query.idContext
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableVariableTypesInContext'].get
  update:
    x-apievangelist-phrasing:
      intent: List variable templates for a context
      effect: read
      questions:
      - Which variable types can I create manually in a web container?
      - What variable templates does a given context let me add by hand?
      instructions:
      - text: List the manually creatable variable templates for context {idContext}.
        slots:
          idContext: query.idContext
      - text: Show the variable types I can define myself in the {idContext} context.
        slots:
          idContext: query.idContext
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerEmbedCode'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the embed code for a container
      effect: read
      questions:
      - Where do I get the snippet to paste into my site so a Matomo Tag Manager container loads?
      - Is the container embed code different for each release environment?
      instructions:
      - text: Get the embed code for container {idContainer} on site {idSite} in the {environment} environment.
        slots:
          idContainer: query.idContainer
          idSite: query.idSite
          environment: query.environment
      - text: Give me the script snippet that loads container {idContainer} live on website {idSite}.
        slots:
          idContainer: query.idContainer
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerInstallInstructions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get install instructions for a container
      effect: read
      questions:
      - Are there step-by-step instructions for installing a container in a JavaScript framework like React?
      - How should I install a container release on a single-page app?
      instructions:
      - text: Get installation instructions for container {idContainer} on site {idSite} for the {environment} environment.
        slots:
          idContainer: query.idContainer
          idSite: query.idSite
          environment: query.environment
      - text: Show how to install container {idContainer} in a {jsFramework} app for site {idSite}.
        slots:
          idContainer: query.idContainer
          jsFramework: query.jsFramework
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerTags'].get
  update:
    x-apievangelist-phrasing:
      intent: List tags in a container version
      effect: read
      questions:
      - Which tags are configured in my container's current version?
      - Can I see every tag set up in a specific container version at once?
      instructions:
      - text: List all tags in version {idContainerVersion} of container {idContainer} on site {idSite}.
        slots:
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Show every configured tag in container {idContainer}, version {idContainerVersion}.
        slots:
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.createDefaultContainerForSite'].get
  update:
    x-apievangelist-phrasing:
      intent: Create a default web container for a site
      effect: write
      questions:
      - Can I generate a ready-made container with the standard Matomo tracking already set up?
      - What's the quickest way to get a working web container on a new site?
      instructions:
      - text: Create the default web container with standard tracking for site {idSite}.
        slots:
          idSite: query.idSite
      - text: Set up a starter Tag Manager container for website {idSite}.
        slots:
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.addContainerTag'].get
  update:
    x-apievangelist-phrasing:
      intent: Add a tag to a container version
      effect: write
      questions:
      - How do I add a new tag to a Tag Manager container?
      - Can a new tag be scheduled to only run between a start and end date?
      - Can I attach fire and block triggers when I create a tag?
      instructions:
      - text: Add a {type} tag named {name} to version {idContainerVersion} of container {idContainer} on site {idSite}.
        slots:
          type: query.type
          name: query.name
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Create tag {name} of type {type} in container {idContainer} that fires on triggers {fireTriggerIds}.
        slots:
          name: query.name
          type: query.type
          idContainer: query.idContainer
          fireTriggerIds: query.fireTriggerIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.updateContainerTag'].get
  update:
    x-apievangelist-phrasing:
      intent: Update an existing tag
      effect: write
      questions:
      - How do I change the triggers on a tag that already exists?
      - Can I adjust an existing tag's fire delay or priority?
      instructions:
      - text: Rename tag {idTag} in container {idContainer} version {idContainerVersion} to {name}.
        slots:
          idTag: query.idTag
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          name: query.name
      - text: Change the fire limit of existing tag {idTag} to {fireLimit}.
        slots:
          idTag: query.idTag
          fireLimit: query.fireLimit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.deleteContainerTag'].get
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag from a container
      effect: destructive
      questions:
      - How do I remove a tag from a container version entirely?
      - Is deleting a tag different from pausing it?
      instructions:
      - text: Delete tag {idTag} from version {idContainerVersion} of container {idContainer} on site {idSite}.
        slots:
          idTag: query.idTag
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Remove tag {idTag} from container {idContainer} for good.
        slots:
          idTag: query.idTag
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.pauseContainerTag'].get
  update:
    x-apievangelist-phrasing:
      intent: Pause a tag
      effect: write
      questions:
      - Can I temporarily stop a tag from firing without deleting it?
      - How do I disable a single tag in a container for now?
      instructions:
      - text: Pause tag {idTag} in container {idContainer} version {idContainerVersion}.
        slots:
          idTag: query.idTag
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Stop tag {idTag} from firing on site {idSite} without removing it.
        slots:
          idTag: query.idTag
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.resumeContainerTag'].get
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused tag
      effect: write
      questions:
      - How do I turn a paused tag back on?
      - Can a tag I paused earlier start firing again?
      instructions:
      - text: Resume paused tag {idTag} in container {idContainer} version {idContainerVersion}.
        slots:
          idTag: query.idTag
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Re-enable tag {idTag} on site {idSite} so it fires again.
        slots:
          idTag: query.idTag
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerTag'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one tag's configuration
      effect: read
      questions:
      - What triggers and parameters does a specific tag use?
      - Can I look up the full settings of one tag by its ID?
      instructions:
      - text: Show the configuration of tag {idTag} in container {idContainer} version {idContainerVersion}.
        slots:
          idTag: query.idTag
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Fetch the settings for tag {idTag} on site {idSite}.
        slots:
          idTag: query.idTag
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerTriggerReferences'].get
  update:
    x-apievangelist-phrasing:
      intent: Find where a trigger is used
      effect: read
      questions:
      - Which tags depend on a trigger before I delete it?
      - Where is a particular trigger referenced inside a container version?
      instructions:
      - text: Find every place trigger {idTrigger} is referenced in container {idContainer} version {idContainerVersion}.
        slots:
          idTrigger: query.idTrigger
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Show which tags use trigger {idTrigger} on site {idSite}.
        slots:
          idTrigger: query.idTrigger
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerTriggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List triggers in a container version
      effect: read
      questions:
      - What triggers are configured in a container version?
      - Can I get every trigger defined in my container in one call?
      instructions:
      - text: List all triggers in version {idContainerVersion} of container {idContainer} on site {idSite}.
        slots:
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Show every configured trigger in container {idContainer}.
        slots:
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.addContainerTrigger'].get
  update:
    x-apievangelist-phrasing:
      intent: Add a trigger to a container version
      effect: write
      questions:
      - How do I create a trigger that fires on a click or page view?
      - Can a new trigger include conditions such as a URL that contains a value?
      instructions:
      - text: Add a {type} trigger named {name} to container {idContainer} version {idContainerVersion} on site {idSite}.
        slots:
          type: query.type
          name: query.name
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          idSite: query.idSite
      - text: Create trigger {name} of type {type} with conditions {conditions} in container {idContainer}.
        slots:
          name: query.name
          type: query.type
          conditions: query.conditions
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.updateContainerTrigger'].get
  update:
    x-apievangelist-phrasing:
      intent: Update an existing trigger
      effect: write
      questions:
      - How do I change the conditions on a trigger I already created?
      - Can I rename an existing trigger in a container version?
      instructions:
      - text: Rename trigger {idTrigger} in container {idContainer} version {idContainerVersion} to {name}.
        slots:
          idTrigger: query.idTrigger
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          name: query.name
      - text: Replace the conditions on existing trigger {idTrigger} with {conditions}.
        slots:
          idTrigger: query.idTrigger
          conditions: query.conditions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.deleteContainerTrigger'].get
  update:
    x-apievangelist-phrasing:
      intent: Delete a trigger from a container
      effect: destructive
      questions:
      - How do I remove a trigger I no longer need from a container?
      - Can I delete a trigger out of a specific container version?
      instructions:
      - text: Delete trigger {idTrigger} from container {idContainer} version {idContainerVersion} on site {idSite}.
        slots:
          idTrigger: query.idTrigger
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          idSite: query.idSite
      - text: Remove trigger {idTrigger} from container {idContainer}.
        slots:
          idTrigger: query.idTrigger
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerTrigger'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one trigger's configuration
      effect: read
      questions:
      - What conditions does a specific trigger check?
      - Can I look up a single trigger's settings by its ID?
      instructions:
      - text: Show the configuration of trigger {idTrigger} in container {idContainer} version {idContainerVersion}.
        slots:
          idTrigger: query.idTrigger
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Fetch trigger {idTrigger} details for site {idSite}.
        slots:
          idTrigger: query.idTrigger
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerVariableReferences'].get
  update:
    x-apievangelist-phrasing:
      intent: Find where a variable is used
      effect: read
      questions:
      - Which tags or triggers reference a variable before I change it?
      - Where is a particular variable used inside a container version?
      instructions:
      - text: Find every reference to variable {idVariable} in container {idContainer} version {idContainerVersion}.
        slots:
          idVariable: query.idVariable
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Show what depends on variable {idVariable} on site {idSite}.
        slots:
          idVariable: query.idVariable
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerVariables'].get
  update:
    x-apievangelist-phrasing:
      intent: List manually configured variables
      effect: read
      questions:
      - Which variables have I created myself in a container version?
      - Can I list only my custom variables, not the built-in ones?
      instructions:
      - text: List the manually configured variables in container {idContainer} version {idContainerVersion} on site {idSite}.
        slots:
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          idSite: query.idSite
      - text: Show the custom variables I defined in container {idContainer}.
        slots:
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getAvailableContainerVariables'].get
  update:
    x-apievangelist-phrasing:
      intent: List manual and preconfigured variables
      effect: read
      questions:
      - What built-in variables like page URL can I reference alongside my own?
      - Which variables, preconfigured and manual, are usable in a container version?
      instructions:
      - text: List all usable variables, built-in and manual, in container {idContainer} version {idContainerVersion}.
        slots:
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Show the preconfigured variables available for container {idContainer} on site {idSite}.
        slots:
          idContainer: query.idContainer
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.addContainerVariable'].get
  update:
    x-apievangelist-phrasing:
      intent: Add a variable to a container version
      effect: write
      questions:
      - How do I create a custom variable in Tag Manager?
      - Can a new variable have a default value or a lookup table?
      instructions:
      - text: Add a {type} variable named {name} to container {idContainer} version {idContainerVersion} on site {idSite}.
        slots:
          type: query.type
          name: query.name
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          idSite: query.idSite
      - text: Create variable {name} of type {type} with default value {defaultValue}.
        slots:
          name: query.name
          type: query.type
          defaultValue: query.defaultValue
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.updateContainerVariable'].get
  update:
    x-apievangelist-phrasing:
      intent: Update an existing variable
      effect: write
      questions:
      - How do I change the lookup table on a variable I already made?
      - Can I rename an existing variable in my container?
      instructions:
      - text: Rename variable {idVariable} in container {idContainer} version {idContainerVersion} to {name}.
        slots:
          idVariable: query.idVariable
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          name: query.name
      - text: Set the default value of existing variable {idVariable} to {defaultValue}.
        slots:
          idVariable: query.idVariable
          defaultValue: query.defaultValue
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.deleteContainerVariable'].get
  update:
    x-apievangelist-phrasing:
      intent: Delete a variable from a container
      effect: destructive
      questions:
      - How do I remove a variable I don't use anymore?
      - Can I delete a custom variable from a container version?
      instructions:
      - text: Delete variable {idVariable} from container {idContainer} version {idContainerVersion} on site {idSite}.
        slots:
          idVariable: query.idVariable
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
          idSite: query.idSite
      - text: Remove variable {idVariable} from container {idContainer}.
        slots:
          idVariable: query.idVariable
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerVariable'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one variable's configuration
      effect: read
      questions:
      - What type and default value does a particular variable have?
      - Can I look up a single variable's settings by its ID?
      instructions:
      - text: Show the configuration of variable {idVariable} in container {idContainer} version {idContainerVersion}.
        slots:
          idVariable: query.idVariable
          idContainer: query.idContainer
          idContainerVersion: query.idContainerVersion
      - text: Fetch variable {idVariable} details for site {idSite}.
        slots:
          idVariable: query.idVariable
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainers'].get
  update:
    x-apievangelist-phrasing:
      intent: List containers for a site
      effect: read
      questions:
      - Which Tag Manager containers exist for my website?
      - Can I see all containers set up on one site?
      instructions:
      - text: List all containers for site {idSite}.
        slots:
          idSite: query.idSite
      - text: Show me the Tag Manager containers on website {idSite}.
        slots:
          idSite: query.idSite
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.addContainer'].get
  update:
    x-apievangelist-phrasing:
      intent: Create a new container
      effect: write
      questions:
      - How do I create a new container for a website from scratch?
      - Can a new container ignore or sync the GTM data layer?
      instructions:
      - text: Create a {context} container named {name} on site {idSite}.
        slots:
          context: query.context
          name: query.name
          idSite: query.idSite
      - text: Add container {name} for site {idSite} with description {description}.
        slots:
          name: query.name
          idSite: query.idSite
          description: query.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.updateContainer'].get
  update:
    x-apievangelist-phrasing:
      intent: Update a container's settings
      effect: write
      questions:
      - How do I rename a container or change its description?
      - Can I turn on GTM data layer syncing for a container that already exists?
      instructions:
      - text: Rename container {idContainer} on site {idSite} to {name}.
        slots:
          idContainer: query.idContainer
          idSite: query.idSite
          name: query.name
      - text: Set activelySyncGtmDataLayer to {activelySyncGtmDataLayer} on existing container {idContainer}.
        slots:
          activelySyncGtmDataLayer: query.activelySyncGtmDataLayer
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.createContainerVersion'].get
  update:
    x-apievangelist-phrasing:
      intent: Save a new container version
      effect: write
      questions:
      - How do I snapshot my current draft into a named container version?
      - Can I create a new version based on an older container version instead of the draft?
      instructions:
      - text: Create version {name} from the current draft of container {idContainer} on site {idSite}.
        slots:
          name: query.name
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Make a new version called {name} copied from version {idContainerVersion} of container {idContainer}.
        slots:
          name: query.name
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.updateContainerVersion'].get
  update:
    x-apievangelist-phrasing:
      intent: Rename or describe a container version
      effect: write
      questions:
      - Can I change the name or description of a saved container version?
      - How do I relabel a container version after creating it?
      instructions:
      - text: Rename version {idContainerVersion} of container {idContainer} to {name}.
        slots:
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
          name: query.name
      - text: Update the description of container version {idContainerVersion} on site {idSite} to {description}.
        slots:
          idContainerVersion: query.idContainerVersion
          idSite: query.idSite
          description: query.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a container
      effect: read
      questions:
      - What versions have been saved for a container?
      - Can I see a container's version history?
      instructions:
      - text: List all versions of container {idContainer} on site {idSite}.
        slots:
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Show the version history for container {idContainer}.
        slots:
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.getContainerVersion'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a container version
      effect: read
      questions:
      - What's in a specific container version and where is it released?
      - Can I get the details of one container version by its ID?
      instructions:
      - text: Get details for version {idContainerVersion} of container {idContainer} on site {idSite}.
        slots:
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Look up container version {idContainerVersion}.
        slots:
          idContainerVersion: query.idContainerVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=TagManager.deleteContainerVersion'].get
  update:
    x-apievangelist-phrasing:
      intent: Delete a container version
      effect: destructive
      questions:
      - How do I delete an old container version I no longer need?
      - Can I remove a single version without deleting the whole container?
      instructions:
      - text: Delete version {idContainerVersion} of container {idContainer} on site {idSite}.
        slots:
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
          idSite: query.idSite
      - text: Remove container version {idContainerVersion} but keep container {idContainer}.
        slots:
          idContainerVersion: query.idContainerVersion
          idContainer: query.idContainer
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/overlays/matomo-tag-manager-api-phrasing-overlay.yaml