Claims and work

List claims

A repository's claims, newest first, up to 100: active ones unless state says released, expired or handed_off, and issue for one issue's.

GET/repos/{owner}/{name}/claims

Anyone who can read the repository may.

Authentication: Optional. Public data can be read without a token; send one to see what is private.
MCP tool: issue with action list_claims, and the same inputs
Scope: An access token needs issues:read.

Path parameters

Name	Type	Required	Description
`owner`	string	Yes	The workspace that owns the repository.
`name`	string	Yes	The repository’s name.

Query parameters

Name	Type	Required	Description
`state`	string	No	Claims in this state; active if left out. One of `active`, `released`, `expired`, `handed_off`.
`issue`	integer	No	Only claims on this issue.

Example request

curl "https://api.g1t.sh/repos/flagon-io/hello/claims?state=active" \
  -H "Authorization: Bearer $G1T_TOKEN"

Example response

A successful request answers 200 with:

[
  {
    "id": "clm_01m4b3d5f7h9k1m3p5r7t9w1y3",
    "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
    "issue": 12,
    "session_id": "ses_01m4b2c3d4e5f6g7h8j9k0m1n2",
    "actor": {
      "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
      "username": "syntaqx"
    },
    "harness": "claude_code",
    "note": "Taking the argument parsing first.",
    "state": "active",
    "created_at": "2026-10-12T14:03:02.771Z",
    "expires_at": "2026-10-12T15:01:40.518Z",
    "ended_at": null,
    "end_reason": null,
    "handoff_to": null
  },
  {
    "id": "clm_01m4b2a4c6e8g0j2l4n6q8s0u2",
    "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
    "issue": 12,
    "session_id": null,
    "actor": {
      "id": "usr_01kkp2v7d4fh8m3q6t9w2z5c8e",
      "username": "ana"
    },
    "harness": null,
    "note": "Looking at the tests.",
    "state": "active",
    "created_at": "2026-10-12T13:50:12.000Z",
    "expires_at": "2026-10-12T14:20:12.000Z",
    "ended_at": null,
    "end_reason": null,
    "handoff_to": null
  }
]

Errors

A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.

Status	Code	When
401	`unauthenticated`	A token is required, or the one sent is not valid.
403	`forbidden`	The token is valid but not allowed to do this, such as a member-only change, or a token without the scope it needs.
404	`not_found`	It does not exist, or you cannot see it.
422	`invalid`	The input is not valid. `message` says which field and why.