Create issue claim

Atomically claim this issue. Succeeds when the issue is unclaimed, its lease expired, or the caller already holds it (renew extends the lease and bumps the epoch). A live claim held by another actor answers 409 with the holder and expiry — do not steal.

POST/workspaces/{organizationId}/issues/{id}/claim

Path parameters

organizationIdstringrequired

idstringrequired

Request body

application/json

actorIdstring

agentIdstring

leaseSecondsinteger

Responses

200

Issue claimed (or lease renewed)

issueIdstringrequired

claimedBystringrequired

leaseExpiresAtstringrequired

epochnumberrequired

404

Issue not found

409

Issue already claimed — details carry claimedBy and leaseExpiresAt

Try it

Server

Custom base URLOverrides the selected server when set.

Parameters

organizationIdpath*idpath*

Bodyapplication/json

actorIdstringagentIdstringleaseSecondsinteger

Request

curl -X POST '/workspaces/string/issues/string/claim' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "actorId": "string",
  "agentId": "string",
  "leaseSeconds": 0
}'

const response = await fetch("/workspaces/string/issues/string/claim", {
  method: "POST",
  headers: {
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"actorId\": \"string\",\n  \"agentId\": \"string\",\n  \"leaseSeconds\": 0\n}"
});

import requests

response = requests.post(
    "/workspaces/string/issues/string/claim",
    headers={
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"actorId\": \"string\",\n  \"agentId\": \"string\",\n  \"leaseSeconds\": 0\n}",
)

Response

{
  "issueId": "string",
  "claimedBy": "string",
  "leaseExpiresAt": "string",
  "epoch": 0
}