Skip to main content
POST
Atomically claim an issue for the current local runner

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Organization identifier

Body

application/json
issueId
string<uuid>
required
idempotencyKey
string
required
Required string length: 1 - 200
claimKind
enum<string>
default:issue
Available options:
issue

Response

Runner lease claimed or idempotently replayed. First attention claims require an unread routed notification. Terminal attention replays acknowledge only, including after read or acknowledgement. Untouched pre-intent replays may reissue a token and invalidate the original token; the four newest prior recovery tokens remain valid for one minute or until one is used, which promotes it. Other replays return token: null. Only proven pre-intent orphans can be replaced; uncertain_outcome blocks replacement.

lease
object
required

Fenced local execution lease. The lease token is never returned in this object.

token
string | null
required

Ephemeral token for a new claim or eligible pre-intent replay; null for other replays.

replayed
boolean
required

True when the idempotency key returned an existing lease.

token_reissued
boolean
required

True only when an untouched pre-intent active lease received a newly generated token; the original token is invalidated.

acknowledgement_only
boolean
required

True only for terminal attention replays that acknowledge without starting a turn, including after notification read or acknowledgement.