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.

Usage

pearing-cli get-timer <timer-uuid> [--team <slug> | --repo <locator>]

Examples

pearing-cli get-timer 8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6
pearing-cli get-timer 8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6 --team platform
pearing-cli get-timer 8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6 --repo teams/platform/website

Response

Prints the timer JSON. A UUID addressed through the wrong scope returns not found.

Help Output

Fetch one timer by uuid.

Example:

  get-timer abc-123

Usage: pearing-cli get-timer [OPTIONS] <TIMER_UUID>

Arguments:
  <TIMER_UUID>
          Timer uuid

Options:
      --team <TEAM>
          Address a team's timers. Requires team ownership

      --repo <REPO>
          Address a repo's timers. Read access is enough to list or fetch; create, update, and delete require maintainer access

  -h, --help
          Print help (see a summary with '-h')