---
title: "Claim Handoff Token"
method: GET
path: "/handoff/{token}"
---

# Claim Handoff Token

`GET /handoff/{token}`

Claim a handoff token and return the session identity + tail.

Args:
    token: Opaque urlsafe token presented by the dashboard.
    request: FastAPI request (used to resolve the workdir).

Returns:
    JSON envelope with ``session_id``, ``task_id``,
    ``source_surface``, ``claimed_at``, ``note`` and ``tail`` (a
    list of recent stream entries).

Raises:
    HTTPException: ``404`` for unknown tokens, ``410`` for expired
    or already-claimed tokens.

## Path parameters

- `token` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 15 revisions in range; 7 could not be searched.

- **2026-07-26** `2a1299ef19fa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/changes/handoff/:token/get.md)

---

[API](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/revisions/7f4871ff054a/schema)