Execute Maintenance Action

Executes a maintenance action using a previously generated token. Two action types are supported:

  • UNLOCK_STUCK: Unlocks all stuck distributions, allowing them to be retried or cleaned up. Returns a report listing the stuck distributions and whether they were unlocked.
  • STOP_ALL: Force-stops all in-progress distributions across the cluster, aborts all non-final trackers in the database, and flushes the task queue. Returns a report with affected tracker counts and queue flush status.

The dryRun query parameter (defaults to true) allows previewing what would be affected without actually performing the action.

Requires admin permissions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

The type of maintenance action to execute

Allowed:
Query Params
boolean
Defaults to true

If true (default), simulates the action without executing it. Set to false to actually perform the action.

Body Params

The encrypted execution token obtained from the generate_token endpoint

Responses

Language
Credentials
:
URL
LoadingLoading…
Response
Choose an example:
application/json