Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Use Cases for Triggering Snapshots Automatically

It’s easy enough to go to a Confluence page and click “Take New Snapshot”, but that requires a manual, human, action.

...

The following two parameters are required, and are unique for each Jira Snapshot macro:

  1. A MACRO-SPECIFIC-UELURL

  2. An API-KEY.

Retrieve these parameters from the macro configuration window, on the “Automation tab”

...

(info) Once enabled, the macro SAVE the macro configuration to make this change effective.(info) Copy the API Key- as there is only one opportunity to do that. If you loose the API Key you’ll need to regenerate a new one. The API Key itself is not saved by Jira Snapshot and hence cannot be retrieved again.

(info) Once enabled, SAVE the macro configuration to make this change effective.

This is the REST CALL syntax to trigger a new Snapshot for an existing, configured, Jira Snapshot macro:

...

  • jira-snapshots-api-key: <API-KEY>

Here is how it looks with a curl call/on CURL:

Code Block
breakoutModewide
curl --location --request POST '<MACRO-SPECIFIC-URL>' \
--header 'jira-snapshots-api-key: <API-KEY>'

...

To remove the possibility for all existing automation to trigger one of the Snapshot macros, you may:

  1. Regenerate the API Key. This will make all existing automation automations invalid (until they are updated with the new key).

  2. Disable the automation for this specific macro.

...

A Confluence administrator can also revoke all enabled automations.

...