For AI agents: visit https://developers.piwik.pro/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI. Append .md to any documentation page URL to get its markdown version.
Some actions result in asynchronous operations. In such cases, the API will return a 202 status code with operation ID
in relationships object.
The operation status can be checked by sending a GET request to /api/tag/v1/{app_id}/operations/{operation_id} URL.
An operation can be in one of the following states:
created - The operation has been created but not yet started.
started - The operation is in progress.
completed - The operation finished successfully, and the result is available.
failed - The operation encountered an error and did not complete successfully.
Operations can be identified by the operation_type attribute.
There can only be 1 operation of a given type (in state started or created) for a given resource (app) at a time.