Oko
Oko/Docs

Command reference

oko-cli routines run

Submits one manual occurrence without changing the clock schedule.

Invocation#

Command
oko-cli routines run SCHEDULE_ID --retry-token RETAINED_TOKEN [--json]

Inputs and options#

  • Retain the retry token before sending. Reuse it after a timeout or lost response; a new token requests new work.

Output and state effect#

  • Returns schedule_id, retry_token, job_id and run_id. This is submission evidence, not completion.
  • The host records an execution claim before acting. Completed receipts can be delivered again; interrupted or failed execution claims never automatically repeat effects.

Refusals and safe exits#

  • An empty token, invalid definition, foreign or deleted schedule fails. An unknown prior execution requires inspection rather than a blind rerun.

CLI reference#