Skip to content
Speccy

The handoffs of a bundle, newest first (REQ-136).

GET
/docs/{docId}/handoff
curl --request GET \
  --url https://example.com/api/v1/docs/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/handoff

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
docId
required
string format: uuid

The ID of one spec doc.

Responses

Section titled “ Responses ”

200

Section titled “200”

The handoffs.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string format: uuid
version_number
required
integer format: int64
verdict
required

The verdict when the builder took the packet.

string
acknowledged
required

True when the builder took the packet although the verdict did not allow it.

boolean
label
string
taken_by
required
string
stale
required

True when the bundle has a newer version than the one this handoff took.

boolean
created_at
required
string format: date-time
Examplegenerated
{
  "items": [
    {
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "version_number": 1,
      "verdict": "example",
      "acknowledged": true,
      "label": "example",
      "taken_by": "example",
      "stale": true,
      "created_at": "2026-04-15T12:00:00Z"
    }
  ]
}

default

Section titled “default”

An error.

Media typeapplication/problem+json

RFC 9457 problem details with a stable code.

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
code
required

A stable machine-readable error code.

string
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "code": "example"
}