Watch programs: pause, replay, resume, rotate

Reference for Watch, one group of Watch programs.

Watch.pauseCopy Anchor Link

Pause stops a Watch delivering while its Events keep queuing; the platform pauses a Watch whose deliveries fail for three days. Verb page.

do: return await $.Watch.pause(input)

Emits Watch.paused.

Inputs

Returns

Refuses when

Example

{
  "name": "do",
  "arguments": {
    "code": "return await $.Watch.pause({ watch: 'watch_9o4vCuR17L' })"
  }
}

Watch.replayCopy Anchor Link

Replay redelivers a Watch’s Events from a chosen point, signed as they were the first time. Verb page.

do: return await $.Watch.replay(input)

Emits Watch.replayed.

Inputs

Returns

Refuses when

Example

{
  "name": "do",
  "arguments": {
    "code": "return await $.Watch.replay({ watch: 'watch_9o4vCuR17L', from: '2026-10-22T12:00:00Z' })"
  }
}

Watch.resumeCopy Anchor Link

Resume restarts a paused Watch and delivers the Events it held, oldest first. Verb page.

do: return await $.Watch.resume(input)

Emits Watch.resumed.

Inputs

Returns

Refuses when

Example

{
  "name": "do",
  "arguments": {
    "code": "return await $.Watch.resume({ watch: 'watch_9o4vCuR17L' })"
  }
}

Watch.rotateCopy Anchor Link

Rotate issues a new signing secret for a Watch and signs with both secrets until the old one expires. Verb page.

do: return await $.Watch.rotate(input)

Emits Watch.rotated.

Inputs

Returns

Refuses when

Example

{
  "name": "do",
  "arguments": {
    "code": "return await $.Watch.rotate({ watch: 'watch_9o4vCuR17L' })"
  }
}