STstudio-saelix
Scheduled Tasks

Toggle task enabled/disabled

Changed on

Flips the enabled state of a scheduled task. Requires admin role.

patch/api/scheduled-tasks/{id}/toggle

Request

  • Base URL
    https://localhost:1852
  • URL
    https://localhost:1852/api/scheduled-tasks/{id}/toggle
  • Auth
    HTTP bearer

Path parameters

idinteger required

Numeric resource ID.

Response

Task toggled. Returns updated task.

idinteger required
namestring required
target_type'stack' | 'fleet' | 'system' | 'container' required
target_idstring nullable

Stack or container name (when target_type is stack or container).

node_idinteger nullable

Target node ID (when target_type is stack or container).

action'restart' | 'snapshot' | 'prune' required
cron_expressionstring required

Standard cron expression (5 fields).

enabled0 | 1 required
created_bystring required
created_atinteger required

Unix timestamp (seconds).

updated_atinteger required

Unix timestamp (seconds).

last_run_atinteger nullable
next_run_atinteger nullable
last_statusstring nullable
last_errorstring nullable
prune_targetsstring nullable

JSON-stringified array of prune targets (containers, images, networks, volumes).

target_servicesstring nullable

JSON-stringified array of service names to restart.

prune_label_filterstring nullable

Docker label filter for prune operations.

Example response

{
  "cron_expression": "0 3 * * *"
}

Changes

  • c02adce28613Revision changes
    • warning

      added the new container enum value to the response property for the response status

  • d58cf9d6195bRevision changes
    • info

      removed the ADMIRAL_REQUIRED enum value from the response property for the response status

    • info

      removed the ADMIRAL_REQUIRED enum value from the response property for the response status

    • info

      removed the ADMIRAL_REQUIRED enum value from the response property for the response status

    • info

      removed the ADMIRAL_REQUIRED enum value from the response property for the response status