get_timer

Fetch one timer by UUID through its owning user, team, or repo scope.

Scope and access

User-scoped timers are private to the authenticated user.
Team-scoped timers can only be listed or managed by a team owner.
Repo-scoped timers can be listed and fetched by users with repo read access; creating, updating, or deleting one requires maintainer access.
A timer UUID is only reachable through its owning user, team, or repo scope.

Tool

get_timer

Authenticated

Input

{
  "timer_uuid": "8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6",
  "repo": "teams/platform/website"
}

Omit both team and repo for your own timer. A timer addressed through the wrong scope returns Timer not found.

Timer result

{
  "uuid": "8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6",
  "message": "Review the release checklist",
  "scope": "user",
  "schedule_kind": "interval",
  "schedule": "Mon, Tue, Wed, Thu, Fri at 09:00 (America/New_York)",
  "status": "active",
  "timezone": "America/New_York",
  "next_run_at": "2026-08-24T13:00:00+00:00",
  "last_run_at": null,
  "run_count": 0
}