Tool

get_pin

Get pinRead-only

Description

Get everything about one pin, by its key: files, discovery, gotchas, repro, approach, done-when, links, sightings and history. Call this before starting work on a pin. File lines are as of each file's commit; if they no longer match the code, find the place by its symbol or snippet.

Parameters

idstringrequired

Pin key (e.g. ACME-42) or id. Picks the workspace: the key's prefix.

at least 1 characters

Response

An example. The result sits in the same envelope as every tool's; see Responses.

JSON

{
  "workspace": {
    "slug": "acme",
    "name": "Acme"
  },
  "result": {
    "key": "ACME-42",
    "url": "https://laterbase.dev/dashboard/pins/ACME-42",
    "title": "Session refresh races when two tabs refresh at once",
    "status": "open",
    "summary": "Two tabs refreshing an expired session at the same moment both rotate the refresh token; the loser is signed out.",
    "repo": "acme/api",
    "kind": "bug",
    "areas": [
      "auth"
    ],
    "risk": "high",
    "payoff": "high",
    "scope": "small",
    "leverage": "high",
    "priority": "critical",
    "claimed_by": null,
    "sightings": 2,
    "created_at": "2026-10-01T14:03:11.000Z",
    "status_changed_at": "2026-10-01T14:03:11.000Z",
    "files": [
      {
        "path": "src/auth/session.ts",
        "lines": "40-58",
        "symbol": "refreshSession",
        "snippet": "const next = await rotate(token);",
        "commit": "3f9c2a1"
      }
    ],
    "commit": "3f9c2a1",
    "confidence": "confirmed",
    "discovery": "Seen while fixing logout: two tabs left open overnight, one signed out on wake.",
    "gotchas": [
      {
        "text": "The mobile app refreshes on resume too.",
        "by": "Sam",
        "at": "2026-10-01T14:03:11.000Z"
      }
    ],
    "repro": "Open two tabs, expire the session, focus both within a second.",
    "approach": "Make rotation idempotent for a short grace window, keyed by the old token.",
    "done_when": "Both tabs stay signed in; a test covers concurrent refresh.",
    "links": [
      {
        "relation": "found_in",
        "artifact": "acme/api#212",
        "kind": "pr",
        "url": "https://github.com/acme/api/pull/212",
        "by": "Sam"
      }
    ],
    "priority_reasons": [
      "high risk",
      "high leverage",
      "seen 3 times"
    ],
    "claimed_at": null,
    "resolution": null,
    "created_by": "Sam",
    "updated_at": "2026-10-02T09:12:40.000Z",
    "history": [
      {
        "type": "created",
        "by": "Sam",
        "via": "claude-code",
        "at": "2026-10-01T14:03:11.000Z"
      },
      {
        "type": "sighting",
        "by": "Alex",
        "via": "cursor",
        "at": "2026-10-02T09:12:40.000Z",
        "note": "Hit it in the mobile app."
      }
    ]
  }
}

Input schema

Exactly what tools/list sends your agent.

JSON

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Pin key (e.g. ACME-42) or id. Picks the workspace: the key's prefix."
    }
  },
  "required": [
    "id"
  ]
}