Skip to content
Sign in

flagon-io/g1t

public
0
7,959 linesCodeBlameRaw

Pick any line to see why it is the way it is: the commit, the pull request and issue it came from, and what the agent was thinking.

Merge branch 'worktree-agent-ab2e39e11a6493412'1{
2 "device_code": {
3 "request": {
4 "client_name": "Claude Code"
5 },
6 "response": {
7 "device_code": "Gm3k…",
8 "user_code": "WDJB-MJHT",
9 "verification_uri": "https://g1t.sh/device",
10 "verification_uri_complete": "https://g1t.sh/device?code=WDJB-MJHT",
11 "expires_in": 900,
12 "interval": 5
13 }
14 },
15 "device_token": {
16 "request": {
17 "device_code": "Gm3k…"
18 },
19 "response": {
20 "status": "approved",
21 "token": "g1t_…",
22 "username": "syntaqx",
23 "verified": true
24 }
25 },
26 "whoami": {
27 "response": {
28 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
29 "username": "syntaqx",
30 "kind": "user",
31 "verified": true,
32 "workspaces": [
33 {
34 "slug": "acme",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look35 "role": "member",
36 "base_permission": "write"
Merge branch 'worktree-agent-ab2e39e11a6493412'37 },
38 {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look39 "slug": "flagon-io",
40 "role": "owner",
41 "base_permission": "write"
Merge branch 'worktree-agent-ab2e39e11a6493412'42 }
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step43 ],
44 "token": {
45 "token_id": "tok_01kkntd3p2v8x6ym5r0c1q7a9e",
API: pinned projects over REST and MCP46 "scopes": [
47 "repo:read",
48 "issues:read",
49 "issues:write",
50 "pull_requests:read",
51 "pull_requests:write"
52 ]
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step53 }
Merge branch 'worktree-agent-ab2e39e11a6493412'54 },
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step55 "notes": "`token` is what the access token you called with may do: its `scopes` (left out for full access) and `legacy` when it was made before tokens had scopes. A token reaches every workspace and repository whoever it acts as can; its scopes say what it may do there. See [Scopes](/guides/authentication/#scopes). `kind` is `user`, `workspace` for a [workspace access token](/guides/workspaces/#workspace-access-tokens), or `agent` for the token a g1t agent works with. For a workspace token, `username` is the workspace's slug and `workspaces` holds only that workspace. Each workspace carries its `base_permission`: what a member gets on each of its repositories (owners have Admin). Roles given on single repositories are in `grants`, each with `repo_id`, `workspace` and `role`; it is left out when there are none. See [Access and roles](/guides/access-and-roles/)."
Merge branch 'worktree-agent-ab2e39e11a6493412'56 },
57 "create_workspace": {
58 "request": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look59 "slug": "acme-labs",
60 "name": "Acme Labs"
Merge branch 'worktree-agent-ab2e39e11a6493412'61 },
62 "response": {
63 "id": "wsp_01m43teqa9em6bje0bhvdj4jkb",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look64 "slug": "acme-labs",
65 "name": "Acme Labs",
Merge branch 'worktree-agent-ab2e39e11a6493412'66 "description": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API67 "created_at": "2026-10-04T16:02:51.337Z",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look68 "member_count": 1,
Owners choose who can create teams69 "base_permission": "write",
70 "team_creation": "members"
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look71 },
Owners choose who can create teams72 "notes": "`base_permission` is what every member gets on each of its repositories: `write` until an owner changes it with `PATCH /workspaces/{workspace}` or `PUT /workspaces/{workspace}/base_permission`. See [Access and roles](/guides/access-and-roles/). `team_creation` is who may create its teams: `members` (any member) until an owner sets `owners` with `PATCH /workspaces/{workspace}`."
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look73 },
Owners choose who can create teams74 "get_workspace": {
75 "params": {
76 "workspace": "acme-labs"
77 },
78 "response": {
79 "id": "wsp_01m43teqa9em6bje0bhvdj4jkb",
80 "slug": "acme-labs",
81 "name": "Acme Labs",
82 "description": "Rockets, and the software that flies them.",
83 "created_at": "2026-10-04T16:02:51.337Z",
84 "member_count": 3,
85 "base_permission": "write",
86 "team_creation": "members"
87 },
88 "notes": "`team_creation` is who may create its teams: `members` (any member, the default) or `owners`. Change it, and the rest, with [`PATCH /workspaces/{workspace}`](/reference/api/workspaces/update-workspace/). `404` for anyone who is not a member. See [Workspaces](/guides/workspaces/)."
89 },
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily90 "update_workspace": {
91 "params": {
92 "workspace": "acme-labs"
93 },
94 "request": {
95 "name": "Acme Labs",
Owners choose who can create teams96 "description": "Rockets, and the software that flies them.",
97 "team_creation": "owners"
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily98 },
99 "response": {
100 "id": "wsp_01m43teqa9em6bje0bhvdj4jkb",
101 "slug": "acme-labs",
102 "name": "Acme Labs",
103 "description": "Rockets, and the software that flies them.",
104 "created_at": "2026-10-04T16:02:51.337Z",
105 "member_count": 3,
Owners choose who can create teams106 "base_permission": "write",
107 "team_creation": "owners"
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily108 },
Owners choose who can create teams109 "notes": "Only the fields given change. `name` is the display name; the slug, the first part of the workspace's addresses, stays as it is. `base_permission` needs the `access:admin` scope as well as `workspace:admin`; [`set_base_permission`](/reference/api/access/set-base-permission/) sets it alone. `team_creation` is `members` (any member may create a team, the default) or `owners`; teams already made stay. Refused with `403` for anyone but an owner signed in as a person. Recorded in the [audit log](/guides/audit-log/). See [Workspaces](/guides/workspaces/)."
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily110 },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look111 "delete_workspace": {
112 "request": {
113 "confirm": "acme-labs"
114 },
115 "response": true,
Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member116 "notes": "Refused with `402` while billing cannot settle it, with a message that says what to do, and with `403` for anyone but an owner signed in as a person, or for a protected workspace. Its repositories, projects and apps go with it; g1t's support can restore it for 30 days. See [Delete a workspace](/guides/workspaces/#delete-a-workspace)."
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look117 },
118 "list_emails": {
119 "response": {
120 "emails": [
121 {
122 "email": "ada@example.com",
123 "verified": true,
124 "primary": true,
125 "backup": false,
126 "created_at": "2026-09-01T10:00:00.000Z",
127 "verified_at": "2026-09-01T10:02:11.000Z"
128 },
129 {
130 "email": "ada@acme.com",
131 "verified": true,
132 "primary": false,
133 "backup": true,
134 "created_at": "2026-10-02T09:30:00.000Z",
135 "verified_at": "2026-10-02T09:31:40.000Z"
136 },
137 {
138 "email": "ada.l@example.org",
139 "verified": false,
140 "primary": false,
141 "backup": false,
142 "created_at": "2026-10-05T14:12:03.000Z",
143 "verified_at": null
144 }
145 ],
146 "private_email": true,
147 "block_private_pushes": false,
148 "noreply": "6c1d0efg+ada@users.noreply.g1t.sh",
149 "commit_email": "6c1d0efg+ada@users.noreply.g1t.sh",
150 "limit": 10
151 },
152 "notes": "Your primary address comes first, then confirmed addresses, then unconfirmed ones. Any confirmed address signs you in, can reset your password and attributes commits to you. See [Email addresses](/guides/authentication/#email-addresses)."
153 },
154 "add_email": {
155 "request": {
156 "email": "ada.l@example.org",
157 "password": "…"
158 },
159 "response": {
160 "emails": [
161 {
162 "email": "ada@example.com",
163 "verified": true,
164 "primary": true,
165 "backup": false,
166 "created_at": "2026-09-01T10:00:00.000Z",
167 "verified_at": "2026-09-01T10:02:11.000Z"
168 },
169 {
170 "email": "ada@acme.com",
171 "verified": true,
172 "primary": false,
173 "backup": true,
174 "created_at": "2026-10-02T09:30:00.000Z",
175 "verified_at": "2026-10-02T09:31:40.000Z"
176 },
177 {
178 "email": "ada.l@example.org",
179 "verified": false,
180 "primary": false,
181 "backup": false,
182 "created_at": "2026-10-05T14:12:03.000Z",
183 "verified_at": null
184 }
185 ],
186 "private_email": true,
187 "block_private_pushes": false,
188 "noreply": "6c1d0efg+ada@users.noreply.g1t.sh",
189 "commit_email": "6c1d0efg+ada@users.noreply.g1t.sh",
190 "limit": 10
191 },
192 "notes": "Answers `403` with code `reauth_required` when `password` is missing or wrong, and `409` when another account has confirmed the address. The new address stays unconfirmed until its link is followed."
193 },
194 "remove_email": {
195 "request": {
196 "password": "…"
197 },
198 "response": {
199 "emails": [
200 {
201 "email": "ada@example.com",
202 "verified": true,
203 "primary": true,
204 "backup": false,
205 "created_at": "2026-09-01T10:00:00.000Z",
206 "verified_at": "2026-09-01T10:02:11.000Z"
207 },
208 {
209 "email": "ada@acme.com",
210 "verified": true,
211 "primary": false,
212 "backup": true,
213 "created_at": "2026-10-02T09:30:00.000Z",
214 "verified_at": "2026-10-02T09:31:40.000Z"
215 },
216 {
217 "email": "ada.l@example.org",
218 "verified": false,
219 "primary": false,
220 "backup": false,
221 "created_at": "2026-10-05T14:12:03.000Z",
222 "verified_at": null
223 }
224 ],
225 "private_email": true,
226 "block_private_pushes": false,
227 "noreply": "6c1d0efg+ada@users.noreply.g1t.sh",
228 "commit_email": "6c1d0efg+ada@users.noreply.g1t.sh",
229 "limit": 10
230 },
231 "notes": "Give the address in the path, URL-encoded: `DELETE /user/emails/ada.l%40example.org`. Answers `409` for your primary address or your last confirmed one."
232 },
233 "update_email_settings": {
234 "request": {
235 "primary": "ada@acme.com",
236 "password": "…"
237 },
238 "response": {
239 "emails": [
240 {
241 "email": "ada@example.com",
242 "verified": true,
243 "primary": true,
244 "backup": false,
245 "created_at": "2026-09-01T10:00:00.000Z",
246 "verified_at": "2026-09-01T10:02:11.000Z"
247 },
248 {
249 "email": "ada@acme.com",
250 "verified": true,
251 "primary": false,
252 "backup": true,
253 "created_at": "2026-10-02T09:30:00.000Z",
254 "verified_at": "2026-10-02T09:31:40.000Z"
255 },
256 {
257 "email": "ada.l@example.org",
258 "verified": false,
259 "primary": false,
260 "backup": false,
261 "created_at": "2026-10-05T14:12:03.000Z",
262 "verified_at": null
263 }
264 ],
265 "private_email": true,
266 "block_private_pushes": false,
267 "noreply": "6c1d0efg+ada@users.noreply.g1t.sh",
268 "commit_email": "6c1d0efg+ada@users.noreply.g1t.sh",
269 "limit": 10
270 },
271 "notes": "Only the fields given change. `primary` and `backup` need `password`; `private_email` and `block_private_pushes` do not."
272 },
273 "list_invites": {
274 "response": {
275 "mode": "invite",
276 "allowance": {
277 "limit": 5,
278 "used": 2,
279 "remaining": 3
280 },
281 "workspaces": [
282 {
283 "slug": "acme-labs",
284 "allowance": {
285 "limit": 20,
286 "used": 4,
287 "remaining": 16
288 }
289 }
290 ],
291 "invites": [
292 {
293 "id": "inv_01kp2x7m8n9q0r1s2t3v4w5x6y",
294 "code": "g1t-k7m2-q9xd-4hpw-…",
295 "hint": "g1t-k7m2",
296 "email": "ada@example.com",
297 "kind": "account",
298 "workspace": null,
299 "status": "pending",
300 "charged_to": "user",
301 "invited_by": "syntaqx",
302 "redeemed_by": null,
303 "created_at": "2026-10-05T17:00:00.000Z",
304 "expires_at": "2026-11-04T17:00:00.000Z",
305 "redeemed_at": null,
306 "revoked_at": null
307 },
308 {
309 "id": "inv_01kp1v3c4d5e6f7g8h9j0k1m2n",
310 "code": null,
311 "hint": "g1t-p3rt",
312 "email": null,
313 "kind": "account",
314 "workspace": null,
315 "status": "redeemed",
316 "charged_to": "user",
317 "invited_by": "syntaqx",
318 "redeemed_by": "grace",
319 "created_at": "2026-10-02T09:12:40.000Z",
320 "expires_at": "2026-11-01T09:12:40.000Z",
321 "redeemed_at": "2026-10-02T11:30:05.000Z",
322 "revoked_at": null
323 }
324 ]
325 },
326 "notes": "`allowance.limit` and `allowance.remaining` are null when you have no limit. A revoked or expired invite that was never used is not counted. Ask for more at hey@flagon.io with the subject `[g1t Invites]`. See [Invites](/guides/authentication/#invites)."
327 },
328 "create_invite": {
329 "request": {
330 "email": "ada@example.com"
331 },
332 "response": {
333 "id": "inv_01kp2x7m8n9q0r1s2t3v4w5x6y",
334 "code": "g1t-k7m2-q9xd-4hpw-…",
335 "hint": "g1t-k7m2",
336 "email": "ada@example.com",
337 "kind": "account",
338 "workspace": null,
339 "status": "pending",
340 "charged_to": "user",
341 "invited_by": "syntaqx",
342 "redeemed_by": null,
343 "created_at": "2026-10-05T17:00:00.000Z",
344 "expires_at": "2026-11-04T17:00:00.000Z",
345 "redeemed_at": null,
346 "revoked_at": null
347 },
348 "notes": "Refused with `402` (`limit`) when you have no invites left, with `409` when you already have a pending invite for that address or it already has a g1t account, and with `403` for an agent's or a workspace's token. The code is returned in full; send people the link `https://g1t.sh/invite/<code>`."
349 },
350 "revoke_invite": {
351 "response": {
352 "id": "inv_01kp2x7m8n9q0r1s2t3v4w5x6y",
353 "code": null,
354 "hint": "g1t-k7m2",
355 "email": "ada@example.com",
356 "kind": "account",
357 "workspace": null,
358 "status": "revoked",
359 "charged_to": "user",
360 "invited_by": "syntaqx",
361 "redeemed_by": null,
362 "created_at": "2026-10-05T17:00:00.000Z",
363 "expires_at": "2026-11-04T17:00:00.000Z",
364 "redeemed_at": null,
365 "revoked_at": "2026-10-06T08:00:00.000Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'366 }
367 },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look368 "list_workspace_invites": {
369 "response": [
370 {
371 "id": "inv_01kp2x7m8n9q0r1s2t3v4w5x6y",
372 "code": "g1t-k7m2-q9xd-4hpw-…",
373 "hint": "g1t-k7m2",
374 "email": "ada@example.com",
375 "kind": "account",
376 "workspace": "acme-labs",
377 "status": "pending",
378 "charged_to": "workspace",
379 "invited_by": "syntaqx",
380 "redeemed_by": null,
381 "created_at": "2026-10-05T17:00:00.000Z",
382 "expires_at": "2026-11-04T17:00:00.000Z",
383 "redeemed_at": null,
384 "revoked_at": null
385 },
386 {
387 "id": "inv_01kp1z9y8x7w6v5t4s3r2q1p0n",
388 "code": "g1t-k7m2-q9xd-4hpw-…",
389 "hint": "g1t-w2vb",
390 "email": "linus@example.com",
391 "kind": "workspace",
392 "workspace": "acme-labs",
393 "status": "pending",
394 "charged_to": "none",
395 "invited_by": "syntaqx",
396 "redeemed_by": null,
397 "created_at": "2026-10-05T17:00:00.000Z",
398 "expires_at": "2026-11-04T17:00:00.000Z",
399 "redeemed_at": null,
400 "revoked_at": null
401 }
402 ]
403 },
404 "invite_member": {
405 "request": {
406 "email": "ada@example.com"
407 },
408 "response": {
409 "id": "inv_01kp2x7m8n9q0r1s2t3v4w5x6y",
410 "code": "g1t-k7m2-q9xd-4hpw-…",
411 "hint": "g1t-k7m2",
412 "email": "ada@example.com",
413 "kind": "account",
414 "workspace": "acme-labs",
415 "status": "pending",
416 "charged_to": "workspace",
417 "invited_by": "syntaqx",
418 "redeemed_by": null,
419 "created_at": "2026-10-05T17:00:00.000Z",
420 "expires_at": "2026-11-04T17:00:00.000Z",
421 "redeemed_at": null,
422 "revoked_at": null
423 },
424 "notes": "`kind` is `workspace` when the address already has a g1t account (`charged_to` is then `none`), and `account` when accepting makes one. Both answers look alike to the caller on purpose: the invite is emailed either way."
425 },
426 "revoke_workspace_invite": {
427 "response": {
428 "id": "inv_01kp2x7m8n9q0r1s2t3v4w5x6y",
429 "code": null,
430 "hint": "g1t-k7m2",
431 "email": "ada@example.com",
432 "kind": "account",
433 "workspace": "acme-labs",
434 "status": "revoked",
435 "charged_to": "workspace",
436 "invited_by": "syntaqx",
437 "redeemed_by": null,
438 "created_at": "2026-10-05T17:00:00.000Z",
439 "expires_at": "2026-11-04T17:00:00.000Z",
440 "redeemed_at": null,
441 "revoked_at": "2026-10-06T08:00:00.000Z"
442 }
443 },
Merge branch 'worktree-agent-ab2e39e11a6493412'444 "list_repos": {
445 "query": {
446 "q": "hello"
447 },
448 "response": [
449 {
450 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look451 "namespace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'452 "name": "hello",
453 "description": "A tiny service that says hello.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API454 "is_private": false,
455 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
456 "default_branch": "main",
457 "fork_of": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'458 "protected": true,
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look459 "created_at": "2026-09-28T14:11:52.640Z",
460 "website": "https://hello.g1t.page",
461 "archived_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'462 }
463 ],
464 "notes": "Returns at most 50 repositories, newest first. Forks made for pull requests are left out."
465 },
466 "create_repo": {
467 "request": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look468 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'469 "name": "hello-cli",
470 "description": "Command-line client for hello.",
471 "private": false
472 },
473 "response": {
474 "id": "rep_01m43tk1jhehztx23drs87f5fc",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look475 "namespace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'476 "name": "hello-cli",
477 "description": "Command-line client for hello.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API478 "is_private": false,
479 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
480 "default_branch": "main",
481 "fork_of": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'482 "protected": false,
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look483 "created_at": "2026-10-04T16:05:12.913Z",
484 "website": "https://hello.g1t.page",
485 "archived_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'486 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API487 "notes": "`owner_id` is the id of the person who created the repository. With `import_url`, `default_branch` is the default branch of the repository copied."
Merge branch 'worktree-agent-ab2e39e11a6493412'488 },
489 "get_repo": {
490 "response": {
491 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look492 "namespace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'493 "name": "hello",
494 "description": "A tiny service that says hello.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API495 "is_private": false,
496 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
497 "default_branch": "main",
498 "fork_of": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'499 "protected": true,
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look500 "created_at": "2026-09-28T14:11:52.640Z",
501 "website": "https://hello.g1t.page",
502 "archived_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'503 }
504 },
505 "update_repo": {
506 "request": {
507 "description": "Says hello, politely.",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look508 "website": "hello.g1t.page",
509 "default_branch": "trunk",
Merge branch 'worktree-agent-ab2e39e11a6493412'510 "protected": true
511 },
512 "response": {
513 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look514 "namespace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'515 "name": "hello",
516 "description": "Says hello, politely.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API517 "is_private": false,
518 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look519 "default_branch": "trunk",
520 "fork_of": null,
521 "protected": true,
522 "created_at": "2026-09-28T14:11:52.640Z",
523 "topics": [
524 "http",
525 "example"
526 ],
527 "website": "https://hello.g1t.page",
528 "archived_at": null
529 },
530 "notes": "Only the fields given change. `website` gets `https://` when no scheme is given; an empty string clears it. `default_branch` must name a branch that exists (`422` otherwise); it is changed after the other fields. `description`, `website`, `topics` and `protected` need the Maintain role or higher, and `private` and `default_branch` the Admin role (`403` otherwise, saying which role). Changing `private` here needs no confirmation; `POST /repos/{owner}/{name}/visibility` asks for one. Making it private is refused with `402` when a free workspace's private storage has no room for it. See [Managing a repository](/guides/managing-repositories/) and [Access and roles](/guides/access-and-roles/)."
531 },
532 "transfer_repo": {
533 "request": {
534 "to": "flagon-io"
535 },
536 "response": {
537 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
538 "namespace": "flagon-io",
539 "name": "hello",
540 "description": "A tiny service that says hello.",
541 "is_private": false,
542 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API543 "default_branch": "main",
544 "fork_of": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'545 "protected": true,
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look546 "created_at": "2026-09-28T14:11:52.640Z",
547 "website": "https://hello.g1t.page",
548 "archived_at": null
549 },
550 "notes": "The repository at its new address. Refused with `409` when the destination already has a repository of that name, `403` unless you own both workspaces, and `402` when a free destination has no room for a private repository. The old address redirects. See [Transferring a repository](/guides/transferring-repositories/)."
Merge branch 'worktree-agent-ab2e39e11a6493412'551 },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look552 "rename_repo": {
553 "request": {
554 "name": "greeter"
555 },
556 "response": {
557 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
558 "namespace": "flagon-io",
559 "name": "greeter",
560 "description": "A tiny service that says hello.",
561 "is_private": false,
562 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
563 "default_branch": "main",
564 "fork_of": null,
565 "protected": true,
566 "created_at": "2026-09-28T14:11:52.640Z",
567 "topics": [
568 "http",
569 "example"
570 ],
571 "website": "https://hello.g1t.page",
572 "archived_at": null
573 },
574 "notes": "The repository under its new name. Needs the Admin role (`403` otherwise). Refused with `409` when the workspace already has a repository of that name, a recently deleted one included, and with `422` when the name is not valid. The old address redirects. See [Rename a repository](/guides/managing-repositories/#rename-a-repository)."
575 },
576 "rename_branch": {
577 "params": {
578 "owner": "flagon-io",
579 "name": "hello",
580 "branch": "feature/login"
581 },
582 "request": {
583 "new_name": "feature/sign-in"
584 },
585 "response": {
586 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
587 "namespace": "flagon-io",
588 "name": "hello",
589 "description": "A tiny service that says hello.",
590 "is_private": false,
591 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
592 "default_branch": "main",
593 "fork_of": null,
594 "protected": true,
595 "created_at": "2026-09-28T14:11:52.640Z",
596 "topics": [
597 "http",
598 "example"
599 ],
600 "website": "https://hello.g1t.page",
601 "archived_at": null
602 },
603 "notes": "The repository after the rename; renaming the default branch changes `default_branch`. Send a branch name with slashes URL-encoded, as one path segment. Refused with `404` when there is no such branch, `409` when a branch named `new_name` exists, `422` when `new_name` is not a valid branch name, and `403` without the Write role, or without the Admin role for the default branch. See [Rename a branch](/guides/managing-repositories/#rename-a-branch)."
604 },
605 "set_repo_visibility": {
606 "request": {
607 "private": true,
608 "confirm": "flagon-io/hello"
609 },
610 "response": {
611 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
612 "namespace": "flagon-io",
613 "name": "hello",
614 "description": "A tiny service that says hello.",
615 "is_private": true,
616 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
617 "default_branch": "main",
618 "fork_of": null,
619 "protected": true,
620 "created_at": "2026-09-28T14:11:52.640Z",
621 "topics": [
622 "http",
623 "example"
624 ],
625 "website": "https://hello.g1t.page",
626 "archived_at": null
627 },
628 "notes": "Needs the Admin role (`403` otherwise). Refused with `422` when `confirm` is not the repository's full name, and with `402` when a free workspace's private storage has no room for it. See [Change who can see a repository](/guides/managing-repositories/#change-who-can-see-a-repository)."
629 },
630 "archive_repo": {
631 "response": {
632 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
633 "namespace": "flagon-io",
634 "name": "hello",
635 "description": "A tiny service that says hello.",
636 "is_private": false,
637 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
638 "default_branch": "main",
639 "fork_of": null,
640 "protected": true,
641 "created_at": "2026-09-28T14:11:52.640Z",
642 "topics": [
643 "http",
644 "example"
645 ],
646 "website": "https://hello.g1t.page",
647 "archived_at": "2026-10-05T09:30:00.000Z"
648 },
649 "notes": "The repository, with `archived_at` set. Needs the Admin role (`403` otherwise). See [Archive a repository](/guides/managing-repositories/#archive-a-repository)."
650 },
651 "unarchive_repo": {
652 "response": {
653 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
654 "namespace": "flagon-io",
655 "name": "hello",
656 "description": "A tiny service that says hello.",
657 "is_private": false,
658 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
659 "default_branch": "main",
660 "fork_of": null,
661 "protected": true,
662 "created_at": "2026-09-28T14:11:52.640Z",
663 "topics": [
664 "http",
665 "example"
666 ],
667 "website": "https://hello.g1t.page",
668 "archived_at": null
669 },
670 "notes": "The repository, with `archived_at` null. Needs the Admin role (`403` otherwise)."
671 },
672 "delete_repo": {
673 "request": {
674 "confirm": "flagon-io/hello"
675 },
676 "response": {
677 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
678 "namespace": "flagon-io",
679 "name": "hello",
680 "description": "A tiny service that says hello.",
681 "is_private": false,
682 "deleted_at": "2026-10-05T09:30:00.000Z",
683 "deleted_by": "syntaqx",
684 "purge_after": "2026-11-04T09:30:00.000Z"
685 },
686 "notes": "The deleted repository and when it will be purged, 30 days on. Owners of the workspace only (`403`), whatever their role on the repository. Refused with `422` when `confirm` is not its full name. Its name stays taken until it is purged. See [Delete a repository](/guides/managing-repositories/#delete-a-repository)."
687 },
688 "list_deleted_repos": {
689 "params": {
690 "workspace": "flagon-io"
691 },
692 "response": [
693 {
694 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
695 "namespace": "flagon-io",
696 "name": "hello",
697 "description": "A tiny service that says hello.",
698 "is_private": false,
699 "deleted_at": "2026-10-05T09:30:00.000Z",
700 "deleted_by": "syntaqx",
701 "purge_after": "2026-11-04T09:30:00.000Z"
702 }
703 ],
704 "notes": "Newest first. Empty for anyone who is not an owner of the workspace."
705 },
706 "restore_repo": {
707 "response": {
708 "id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
709 "namespace": "flagon-io",
710 "name": "hello",
711 "description": "A tiny service that says hello.",
712 "is_private": false,
713 "owner_id": "usr_01kkntcg1eeb98j62xjm7eh09p",
714 "default_branch": "main",
715 "fork_of": null,
716 "protected": true,
717 "created_at": "2026-09-28T14:11:52.640Z",
718 "topics": [
719 "http",
720 "example"
721 ],
722 "website": "https://hello.g1t.page",
723 "archived_at": null
724 },
725 "notes": "The repository, back at its address. Name it by the path it had. Owners only (`403`); `404` when no deleted repository had that path, or it has been purged. See [Restore a repository](/guides/managing-repositories/#restore-a-repository)."
726 },
727 "purge_repo": {
728 "request": {
729 "confirm": "flagon-io/hello"
730 },
731 "response": true,
732 "notes": "Permanent: it cannot be restored afterwards, and its name is free again. Only a deleted repository can be purged (`404` otherwise). Owners only (`403`); `422` when `confirm` is not its full name."
733 },
Merge branch 'worktree-agent-ab2e39e11a6493412'734 "get_repo_settings": {
735 "response": {
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API736 "auto_merge": false,
Fast pages, required checks on the branch, self-hosted runners, honest incidents737 "required_checks": [
738 "CI"
739 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API740 "require_up_to_date": false,
741 "required_approvals": 0,
742 "count_agent_approvals": true,
743 "allow_ignoring_checks": true,
744 "agent_review": true,
745 "max_revisions": 2,
746 "merge_queue": false,
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step747 "hold_low_confidence": true,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar748 "require_code_owner_review": false,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API749 "updated_by": null,
750 "updated_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'751 }
752 },
753 "update_repo_settings": {
754 "request": {
Fast pages, required checks on the branch, self-hosted runners, honest incidents755 "required_checks": [
756 "CI",
757 "g1t / deploy"
758 ],
Merge branch 'worktree-agent-ab2e39e11a6493412'759 "required_approvals": 1,
760 "count_agent_approvals": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar761 "merge_queue": true,
762 "require_code_owner_review": true
Merge branch 'worktree-agent-ab2e39e11a6493412'763 },
764 "response": {
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API765 "auto_merge": false,
Fast pages, required checks on the branch, self-hosted runners, honest incidents766 "required_checks": [
767 "CI",
768 "g1t / deploy"
769 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API770 "require_up_to_date": false,
771 "required_approvals": 1,
772 "count_agent_approvals": false,
773 "allow_ignoring_checks": true,
774 "agent_review": true,
775 "max_revisions": 2,
776 "merge_queue": true,
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step777 "hold_low_confidence": true,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar778 "require_code_owner_review": true,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API779 "updated_by": "syntaqx",
780 "updated_at": "2026-10-04T16:20:37.508Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'781 },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar782 "notes": "`required_checks` replaces the whole list: at most 20 names, each a workflow's name or another status's context, as [`list_check_names`](/reference/api/repositories/list-check-names/) gives them. A pull request merges only once each passes on its head; one nothing has reported holds it too. With the merge queue on, each must also pass on the queued state, so the workflows behind them need `merge_group` in their `on:`. `required_approvals` is at most 6 and `max_revisions` at most 5. See [what a repository can ask for](/guides/working-with-g1t/#what-a-repository-can-ask-for). `hold_low_confidence` is on unless turned off: see [confidence](/guides/working-with-g1t/#how-sure-the-agent-is). With `require_code_owner_review`, a pull request into the default branch merges only once the code owners of every file it changes have approved it, as many as each section of its CODEOWNERS file asks: see [Code owners](/guides/codeowners/)."
Merge branch 'worktree-agent-ab2e39e11a6493412'783 },
Fast pages, required checks on the branch, self-hosted runners, honest incidents784 "list_check_names": {
785 "response": [
786 {
787 "name": "CI",
788 "events": [
789 "pull_request",
790 "merge_group",
791 "push"
792 ],
793 "last_seen": "2026-10-06T09:14:02.118Z"
794 },
795 {
796 "name": "g1t / deploy",
797 "events": [],
798 "last_seen": "2026-10-06T08:51:40.006Z"
799 }
800 ],
801 "notes": "The names reported on the repository's commits in the last 30 days, most recent first. A workflow reports a check named after it (`CI`), for each event it ran for; another tool, such as a deployment, reports its own name (`g1t / deploy`). Empty until something has reported on a commit: add a workflow in `.g1t/workflows` first."
802 },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar803 "get_codeowners_errors": {
804 "params": {
805 "owner": "flagon-io",
806 "name": "hello"
807 },
808 "query": {
809 "ref": "main"
810 },
811 "response": {
812 "path": ".github/CODEOWNERS",
813 "ref": "main",
814 "size": 412,
815 "rules": 9,
816 "sections": [
817 "Docs"
818 ],
819 "errors": [
820 {
821 "line": 4,
822 "kind": "unknown_team",
823 "token": "@flagon-io/platform",
824 "message": "@flagon-io/platform is not a team of flagon-io."
825 },
826 {
827 "line": 7,
828 "kind": "negation",
829 "token": "!docs/internal/",
830 "message": "!docs/internal/ starts with !, and negation is not supported; this line is skipped. Give the path a later rule with no owners instead."
831 }
832 ]
833 },
834 "notes": "The file is the first of `.g1t/CODEOWNERS`, `.github/CODEOWNERS`, `CODEOWNERS`, `docs/CODEOWNERS` and `.gitlab/CODEOWNERS` found on `ref` (the default branch when left out); `path` is null when there is none, with no errors. Each error has its `line` (0 for the file as a whole), the `token` at fault, a `message`, and a `kind`:\n\n| `kind` | |\n| --- | --- |\n| `too_large` | The file is over 3 MB and was ignored. |\n| `negation` | A pattern starting with `!`; the line was skipped. |\n| `character_range` | A pattern with `[` or `]`; the line was skipped. |\n| `bad_pattern` | A pattern that names no path; the line was skipped. |\n| `bad_owner` | An owner that is not `@user`, `@workspace/team` or an email address. |\n| `bad_section` | A section header that could not be read. |\n| `unknown_user` | No account has that username. |\n| `unknown_team` | The workspace has no team of that slug. |\n| `unknown_email` | No account has confirmed that address. |\n| `no_write_access` | The person cannot write to the repository. |\n| `team_no_access` | The team has no write access to the repository. |\n\nSee [Code owners](/guides/codeowners/)."
835 },
Merge branch 'worktree-agent-ab2e39e11a6493412'836 "list_events": {
837 "query": {
838 "before": "evt_01m43t2a6c9e3g7j1m5q9t3x7b"
839 },
840 "response": [
841 {
842 "id": "evt_01m43smh3ve52vkcna207vqctf",
843 "type": "pull.opened",
844 "source": "work",
845 "time": "2026-10-01T18:20:02.117Z",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API846 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'847 "actor": "usr_01kkntcg1eeb98j62xjm7eh09p",
848 "data": {
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API849 "pull_id": "pr_01m43smh3vexsr5pmp60qwv0vs",
850 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'851 "number": 14,
852 "issue": 12,
853 "agent": "claude-code"
854 }
855 },
856 {
857 "id": "evt_01m43shrzpf2vt5rxbb02z0xjt",
858 "type": "issue.opened",
859 "source": "work",
860 "time": "2026-10-01T18:04:11.482Z",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API861 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'862 "actor": "usr_01kkntcg1eeb98j62xjm7eh09p",
863 "data": {
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API864 "issue_id": "iss_01m43shrzpfe49x74ga7sj1c6v",
865 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'866 "number": 12,
867 "title": "Greeting should name the caller"
868 }
869 }
870 ],
871 "notes": "Returns 50 events a page. To page back, send the `id` of the last event you have as `before`. `actor` is a user id, and `data` depends on `type`."
872 },
873 "list_issues": {
874 "query": {
875 "state": "open",
876 "label": "feature"
877 },
878 "response": [
879 {
880 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API881 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'882 "number": 12,
883 "title": "Greeting should name the caller",
884 "body": "Take a name from the first argument; fall back to world.",
885 "labels": [
886 "feature"
887 ],
888 "state": "open",
889 "reason": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API890 "resolved_by": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'891 "author": {
892 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
893 "username": "syntaqx",
894 "kind": "user",
895 "verified": false,
896 "workspaces": []
897 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights898 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API899 "created_at": "2026-10-01T18:04:11.482Z",
900 "updated_at": "2026-10-01T18:04:11.482Z",
901 "closed_at": null,
902 "pull_count": 1,
903 "comment_count": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'904 "assignees": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API905 "blocked_by": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'906 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar907 "agent": "claude-code",
908 "milestone": null
Merge branch 'worktree-agent-ab2e39e11a6493412'909 }
910 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API911 "notes": "Returns at most 100 issues, newest first. `comment_count` counts comments, not events such as \"opened #14 for this\"."
Merge branch 'worktree-agent-ab2e39e11a6493412'912 },
913 "create_issue": {
914 "request": {
915 "title": "Greeting should name the caller",
916 "body": "Take a name from the first argument; fall back to world.",
917 "labels": [
918 "feature"
919 ]
920 },
921 "response": {
922 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API923 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'924 "number": 12,
925 "title": "Greeting should name the caller",
926 "body": "Take a name from the first argument; fall back to world.",
927 "labels": [
928 "feature"
929 ],
930 "state": "open",
931 "reason": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API932 "resolved_by": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'933 "author": {
934 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
935 "username": "syntaqx",
936 "kind": "user",
937 "verified": false,
938 "workspaces": []
939 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights940 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API941 "created_at": "2026-10-01T18:04:11.482Z",
942 "updated_at": "2026-10-01T18:04:11.482Z",
943 "closed_at": null,
944 "pull_count": 0,
945 "comment_count": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'946 "assignees": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API947 "blocked_by": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'948 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar949 "agent": null,
950 "milestone": null
Merge branch 'worktree-agent-ab2e39e11a6493412'951 },
952 "notes": "Labels are lowercased. A label not used before is created."
953 },
954 "get_issue": {
955 "response": {
956 "issue": {
957 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API958 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'959 "number": 12,
960 "title": "Greeting should name the caller",
961 "body": "Take a name from the first argument; fall back to world.",
962 "labels": [
963 "feature"
964 ],
965 "state": "closed",
966 "reason": "completed",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API967 "resolved_by": 14,
Merge branch 'worktree-agent-ab2e39e11a6493412'968 "author": {
969 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
970 "username": "syntaqx",
971 "kind": "user",
972 "verified": false,
973 "workspaces": []
974 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights975 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API976 "created_at": "2026-10-01T18:04:11.482Z",
977 "updated_at": "2026-10-01T18:52:17.093Z",
978 "closed_at": "2026-10-01T18:52:17.093Z",
979 "pull_count": 2,
980 "comment_count": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'981 "assignees": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API982 "blocked_by": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'983 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar984 "agent": null,
985 "milestone": null
Merge branch 'worktree-agent-ab2e39e11a6493412'986 },
987 "pulls": [
988 {
989 "id": "pr_01m43sjq8tcz5rbm2a7k4d9e6w",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API990 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'991 "number": 13,
992 "issue": 12,
993 "title": "Greeting should name the caller",
994 "body": null,
995 "agent": "claude-code",
996 "runtime": "external",
997 "status": "closed",
998 "fork": {
999 "namespace": "pulls",
1000 "name": "pr_01m43sjq8tcz5rbm2a7k4d9e6w"
1001 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1002 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'1003 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1004 "head_commit": null,
1005 "merge_base": null,
1006 "merged_by": null,
1007 "merged_at": null,
1008 "superseded_by": 14,
1009 "check_status": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1010 "files": [],
1011 "assignees": [],
1012 "reviewers": [],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1013 "labels": [],
1014 "milestone": null,
1015 "base": "main",
Merge branch 'worktree-agent-ab2e39e11a6493412'1016 "author": {
1017 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1018 "username": "syntaqx",
1019 "kind": "user",
1020 "verified": false,
1021 "workspaces": []
1022 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1023 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1024 "created_at": "2026-10-01T18:20:02.117Z",
1025 "updated_at": "2026-10-01T18:20:02.117Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1026 },
1027 {
1028 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1029 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1030 "number": 14,
1031 "issue": 12,
1032 "title": "Greeting should name the caller",
1033 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
1034 "agent": "claude-code",
1035 "runtime": "external",
1036 "status": "merged",
1037 "fork": {
1038 "namespace": "pulls",
1039 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
1040 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1041 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'1042 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1043 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
1044 "merge_base": "3a7e9c1b5d2f4a6c8e0b2d4f6a8c0e2b4d6f8a1c",
1045 "merged_by": "syntaqx",
1046 "merged_at": "2026-10-01T18:52:17.093Z",
1047 "superseded_by": null,
1048 "check_status": "passed",
Merge branch 'worktree-agent-ab2e39e11a6493412'1049 "files": [
1050 {
1051 "path": "src/main.rs",
1052 "additions": 6,
1053 "deletions": 2
1054 }
1055 ],
1056 "assignees": [],
1057 "reviewers": [
1058 "ana"
1059 ],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1060 "labels": [],
1061 "milestone": null,
1062 "base": "main",
Merge branch 'worktree-agent-ab2e39e11a6493412'1063 "author": {
1064 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1065 "username": "syntaqx",
1066 "kind": "user",
1067 "verified": false,
1068 "workspaces": []
1069 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1070 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1071 "created_at": "2026-10-01T18:20:02.117Z",
1072 "updated_at": "2026-10-01T18:52:17.093Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1073 }
1074 ],
1075 "comments": [
1076 {
1077 "id": "cmt_01m43sr2b7d5f0j6k3n8p1q4v9",
1078 "kind": "event",
1079 "author": {
1080 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1081 "username": "syntaqx",
1082 "kind": "user",
1083 "verified": false,
1084 "workspaces": []
1085 },
1086 "body": "opened #14 for this",
1087 "path": null,
1088 "line": null,
1089 "verdict": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1090 "created_at": "2026-10-01T18:20:02.141Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1091 }
1092 ]
1093 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1094 "notes": "A closed issue says how it was closed: `reason` is `completed` or `not_planned`, and `resolved_by` is the number of the pull request whose merge closed it. Each pull request made for it is listed; one closed because another was merged has `superseded_by` set."
Merge branch 'worktree-agent-ab2e39e11a6493412'1095 },
1096 "update_issue": {
1097 "request": {
1098 "labels": [
1099 "feature",
1100 "good first issue"
1101 ],
1102 "assignees": [
1103 "syntaqx"
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1104 ],
1105 "milestone": 3
Merge branch 'worktree-agent-ab2e39e11a6493412'1106 },
1107 "response": {
1108 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1109 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1110 "number": 12,
1111 "title": "Greeting should name the caller",
1112 "body": "Take a name from the first argument; fall back to world.",
1113 "labels": [
1114 "feature",
1115 "good first issue"
1116 ],
1117 "state": "open",
1118 "reason": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1119 "resolved_by": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1120 "author": {
1121 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1122 "username": "syntaqx",
1123 "kind": "user",
1124 "verified": false,
1125 "workspaces": []
1126 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1127 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1128 "created_at": "2026-10-01T18:04:11.482Z",
1129 "updated_at": "2026-10-01T18:09:47.305Z",
1130 "closed_at": null,
1131 "pull_count": 0,
1132 "comment_count": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'1133 "assignees": [
1134 "syntaqx"
1135 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1136 "blocked_by": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'1137 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1138 "agent": null,
1139 "milestone": {
1140 "number": 3,
1141 "title": "Launch"
1142 }
Merge branch 'worktree-agent-ab2e39e11a6493412'1143 }
1144 },
1145 "close_issue": {
1146 "request": {
1147 "reason": "not_planned"
1148 },
1149 "response": {
1150 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1151 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1152 "number": 12,
1153 "title": "Greeting should name the caller",
1154 "body": "Take a name from the first argument; fall back to world.",
1155 "labels": [
1156 "feature"
1157 ],
1158 "state": "closed",
1159 "reason": "not_planned",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1160 "resolved_by": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1161 "author": {
1162 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1163 "username": "syntaqx",
1164 "kind": "user",
1165 "verified": false,
1166 "workspaces": []
1167 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1168 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1169 "created_at": "2026-10-01T18:04:11.482Z",
1170 "updated_at": "2026-10-01T19:30:00.214Z",
1171 "closed_at": "2026-10-01T19:30:00.214Z",
1172 "pull_count": 0,
1173 "comment_count": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'1174 "assignees": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1175 "blocked_by": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'1176 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1177 "agent": null,
1178 "milestone": null
Merge branch 'worktree-agent-ab2e39e11a6493412'1179 }
1180 },
1181 "reopen_issue": {
1182 "response": {
1183 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1184 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1185 "number": 12,
1186 "title": "Greeting should name the caller",
1187 "body": "Take a name from the first argument; fall back to world.",
1188 "labels": [
1189 "feature"
1190 ],
1191 "state": "open",
1192 "reason": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1193 "resolved_by": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1194 "author": {
1195 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1196 "username": "syntaqx",
1197 "kind": "user",
1198 "verified": false,
1199 "workspaces": []
1200 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1201 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1202 "created_at": "2026-10-01T18:04:11.482Z",
1203 "updated_at": "2026-10-01T19:41:52.830Z",
1204 "closed_at": null,
1205 "pull_count": 0,
1206 "comment_count": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'1207 "assignees": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1208 "blocked_by": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'1209 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1210 "agent": null,
1211 "milestone": null
Merge branch 'worktree-agent-ab2e39e11a6493412'1212 }
1213 },
1214 "assign_issue": {
1215 "request": {
1216 "instructions": "Keep the change to src/main.rs."
1217 },
1218 "response": {
1219 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1220 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1221 "number": 14,
1222 "issue": 12,
1223 "title": "Greeting should name the caller",
1224 "body": null,
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent1225 "agent": "g1t",
Merge branch 'worktree-agent-ab2e39e11a6493412'1226 "runtime": "hosted",
1227 "status": "draft",
1228 "fork": {
1229 "namespace": "pulls",
1230 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
1231 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1232 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'1233 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1234 "head_commit": null,
1235 "merge_base": null,
1236 "merged_by": null,
1237 "merged_at": null,
1238 "superseded_by": null,
1239 "check_status": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1240 "files": [],
1241 "assignees": [],
1242 "reviewers": [],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1243 "labels": [],
1244 "milestone": null,
1245 "base": "main",
Merge branch 'worktree-agent-ab2e39e11a6493412'1246 "author": {
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1247 "id": "usr_g1t_agent",
1248 "username": "g1t",
1249 "kind": "agent",
1250 "verified": false,
1251 "workspaces": []
1252 },
1253 "requested_by": {
Merge branch 'worktree-agent-ab2e39e11a6493412'1254 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1255 "username": "syntaqx",
1256 "kind": "user",
1257 "verified": false,
1258 "workspaces": []
1259 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1260 "created_at": "2026-10-01T18:20:02.117Z",
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1261 "updated_at": "2026-10-01T18:20:02.117Z",
1262 "confidence": null
Merge branch 'worktree-agent-ab2e39e11a6493412'1263 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1264 "notes": "The response is the pull request g1t opened, still a draft. g1t is its `author` and you are its `requested_by`: you may manage it as if you had opened it, and cannot approve it yourself. Follow it with [get a pull request](/reference/api/pull-requests/get-pull-request/): `lifecycle` says what the agent is doing."
Merge branch 'worktree-agent-ab2e39e11a6493412'1265 },
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1266 "delegate": {
1267 "request": {
1268 "title": "Retry webhooks with exponential backoff",
Fast pages, required checks on the branch, self-hosted runners, honest incidents1269 "body": "Deliveries that fail are dropped today. Retry them with exponential backoff, up to six times, then mark the delivery failed.\n\n## Definition of done\n\n- A delivery that fails is retried after 1, 2, 4, 8, 16 and 32 seconds.\n- After the sixth failure it is marked failed and shows on the webhook's page."
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1270 },
1271 "response": {
1272 "issue": {
1273 "id": "iss_01m4a2c8v1t7k3q9x5n0r2w6yd",
1274 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
1275 "number": 41,
1276 "title": "Retry webhooks with exponential backoff",
1277 "body": "Deliveries that fail are dropped today. Retry them with exponential backoff, up to six times, then mark the delivery failed.",
1278 "labels": [],
1279 "state": "open",
1280 "reason": null,
1281 "resolved_by": null,
1282 "author": {
1283 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1284 "username": "syntaqx",
1285 "kind": "user",
1286 "verified": false,
1287 "workspaces": []
1288 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1289 "requested_by": null,
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1290 "created_at": "2026-10-05T14:02:11.204Z",
1291 "updated_at": "2026-10-05T14:02:11.204Z",
1292 "closed_at": null,
1293 "pull_count": 1,
1294 "comment_count": 0,
1295 "assignees": [],
1296 "blocked_by": [],
1297 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1298 "agent": "g1t",
1299 "milestone": null
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1300 },
1301 "pull": {
1302 "id": "pr_01m4a2c9b6e0h4m8q2t6x0a4d8",
1303 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
1304 "number": 42,
1305 "issue": 41,
1306 "title": "Retry webhooks with exponential backoff",
1307 "body": null,
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent1308 "agent": "g1t",
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1309 "runtime": "hosted",
1310 "status": "draft",
1311 "fork": {
1312 "namespace": "pulls",
1313 "name": "pr_01m4a2c9b6e0h4m8q2t6x0a4d8"
1314 },
1315 "fork_repo_id": "rep_01m4a2c9d2g6k0n4r8v2z6c0f4",
1316 "branch": null,
1317 "head_commit": null,
1318 "merge_base": null,
1319 "merged_by": null,
1320 "merged_at": null,
1321 "superseded_by": null,
1322 "check_status": null,
1323 "files": [],
1324 "assignees": [],
1325 "reviewers": [],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1326 "labels": [],
1327 "milestone": null,
1328 "base": "main",
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1329 "author": {
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1330 "id": "usr_g1t_agent",
1331 "username": "g1t",
1332 "kind": "agent",
1333 "verified": false,
1334 "workspaces": []
1335 },
1336 "requested_by": {
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1337 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1338 "username": "syntaqx",
1339 "kind": "user",
1340 "verified": false,
1341 "workspaces": []
1342 },
1343 "created_at": "2026-10-05T14:02:12.880Z",
1344 "updated_at": "2026-10-05T14:02:12.880Z",
1345 "confidence": null
1346 },
1347 "agent": {
1348 "status": "started",
1349 "code": null,
1350 "message": null,
1351 "fix_url": null
1352 }
1353 },
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent1354 "notes": "The issue is opened whatever becomes of the agent. When the workspace's plan does not let it start, `pull` is null and `agent` says why and where to fix it, for example `{ \"status\": \"not_started\", \"code\": \"not_paid\", \"message\": \"Agents need a paid workspace. Start the $20 plan or try it with $5 of free usage after a card check: /acme/-/billing\", \"fix_url\": \"https://g1t.sh/acme/-/billing\" }`. With every agent slot busy, `status` is `queued` and it starts by itself when one frees up. See [putting an agent on something](/guides/working-with-g1t/#put-an-agent-on-it-in-one-step)."
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1355 },
Merge branch 'worktree-agent-ab2e39e11a6493412'1356 "add_comment": {
1357 "request": {
1358 "body": "Should an empty name fall back to \"world\"?"
1359 },
1360 "response": {
1361 "id": "cmt_01m43sv4c8e2g6j0m4q8t2x6a1",
1362 "kind": "comment",
1363 "author": {
1364 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1365 "username": "syntaqx",
1366 "kind": "user",
1367 "verified": true,
1368 "workspaces": [
1369 {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look1370 "slug": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'1371 "role": "owner"
1372 }
1373 ]
1374 },
1375 "body": "Should an empty name fall back to \"world\"?",
1376 "path": null,
1377 "line": null,
1378 "verdict": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1379 "created_at": "2026-10-01T18:12:30.551Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1380 }
1381 },
1382 "list_labels": {
1383 "response": [
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1384 {
1385 "name": "bug",
1386 "color": "d73a4a",
1387 "description": "Something isn't working",
1388 "issues": 4,
1389 "pulls": 1
1390 },
1391 {
1392 "name": "dependencies",
1393 "color": "0366d6",
1394 "description": "Updates a dependency",
1395 "issues": 0,
1396 "pulls": 6
1397 },
1398 {
1399 "name": "good first issue",
1400 "color": "7057ff",
1401 "description": "Good for newcomers",
1402 "issues": 2,
1403 "pulls": 0
1404 }
Merge branch 'worktree-agent-ab2e39e11a6493412'1405 ],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1406 "notes": "By name. A new repository starts with the default labels; add_default_labels adds those an older one is missing."
Merge branch 'worktree-agent-ab2e39e11a6493412'1407 },
1408 "plan_work": {
1409 "request": {
1410 "brief": "Greet people by name, from the command line and the web page."
1411 },
1412 "response": {
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1413 "plan_id": "pln_01m43s9c4e8g2j6m0q4t8x2b6d"
Merge branch 'worktree-agent-ab2e39e11a6493412'1414 }
1415 },
1416 "get_plan": {
1417 "params": {
1418 "plan": "pln_01m43s9c4e8g2j6m0q4t8x2b6d"
1419 },
1420 "response": {
1421 "id": "pln_01m43s9c4e8g2j6m0q4t8x2b6d",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1422 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1423 "brief": "Greet people by name, from the command line and the web page.",
1424 "status": "ready",
1425 "summary": "Name parsing first, then the two places that print the greeting.",
1426 "issues": [
1427 {
1428 "title": "Greeting should name the caller",
1429 "body": "Accept an optional name in `greet()` and use it.",
1430 "labels": [
1431 "feature"
1432 ],
Fast pages, required checks on the branch, self-hosted runners, honest incidents1433 "done": [
1434 "`greet` prints \"Hello, ana!\" when given \"ana\", and \"Hello, world!\" with no argument."
Merge branch 'worktree-agent-ab2e39e11a6493412'1435 ],
1436 "files": [
1437 "src/greet.rs"
1438 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1439 "depends_on": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'1440 "number": null
1441 },
1442 {
1443 "title": "Show the caller's name on the web page",
1444 "body": "Read `?name=` and pass it to `greet()`.",
1445 "labels": [
1446 "feature"
1447 ],
Fast pages, required checks on the branch, self-hosted runners, honest incidents1448 "done": [
1449 "The page at / shows the name given in ?name=, escaped."
Merge branch 'worktree-agent-ab2e39e11a6493412'1450 ],
1451 "files": [
1452 "src/web.rs"
1453 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1454 "depends_on": [
Merge branch 'worktree-agent-ab2e39e11a6493412'1455 1
1456 ],
1457 "number": null
1458 }
1459 ],
1460 "error": null,
1461 "author": {
1462 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1463 "username": "syntaqx",
1464 "kind": "user",
1465 "verified": false,
1466 "workspaces": []
1467 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1468 "created_at": "2026-10-01T17:58:40.006Z",
1469 "finished_at": "2026-10-01T18:01:12.774Z",
Merge branch 'worktree-agent-ab2e39e11a6493412'1470 "progress": [],
1471 "exchanges": []
1472 },
1473 "notes": "A plan still `planning` after 20 minutes is reported as `failed`. `progress` follows each issue once the plan is applied."
1474 },
1475 "apply_plan": {
1476 "params": {
1477 "plan": "pln_01m43s9c4e8g2j6m0q4t8x2b6d"
1478 },
1479 "request": {
1480 "assign": true
1481 },
1482 "response": {
1483 "id": "pln_01m43s9c4e8g2j6m0q4t8x2b6d",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1484 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1485 "brief": "Greet people by name, from the command line and the web page.",
1486 "status": "applied",
1487 "summary": "Name parsing first, then the two places that print the greeting.",
1488 "issues": [
1489 {
1490 "title": "Greeting should name the caller",
1491 "body": "Accept an optional name in `greet()` and use it.",
1492 "labels": [
1493 "feature"
1494 ],
Fast pages, required checks on the branch, self-hosted runners, honest incidents1495 "done": [
1496 "`greet` prints \"Hello, ana!\" when given \"ana\", and \"Hello, world!\" with no argument."
Merge branch 'worktree-agent-ab2e39e11a6493412'1497 ],
1498 "files": [
1499 "src/greet.rs"
1500 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1501 "depends_on": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'1502 "number": 12
1503 },
1504 {
1505 "title": "Show the caller's name on the web page",
1506 "body": "Read `?name=` and pass it to `greet()`.",
1507 "labels": [
1508 "feature"
1509 ],
Fast pages, required checks on the branch, self-hosted runners, honest incidents1510 "done": [
1511 "The page at / shows the name given in ?name=, escaped."
Merge branch 'worktree-agent-ab2e39e11a6493412'1512 ],
1513 "files": [
1514 "src/web.rs"
1515 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1516 "depends_on": [
Merge branch 'worktree-agent-ab2e39e11a6493412'1517 1
1518 ],
1519 "number": 13
1520 }
1521 ],
1522 "error": null,
1523 "author": {
1524 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1525 "username": "syntaqx",
1526 "kind": "user",
1527 "verified": false,
1528 "workspaces": []
1529 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1530 "created_at": "2026-10-01T17:58:40.006Z",
1531 "finished_at": "2026-10-01T18:01:12.774Z",
Merge branch 'worktree-agent-ab2e39e11a6493412'1532 "progress": [],
1533 "exchanges": []
1534 },
1535 "notes": "Each opened issue's `number` is filled in. Issues left out with `keep` stay `null`."
1536 },
1537 "list_pull_requests": {
1538 "query": {
1539 "state": "open"
1540 },
1541 "response": [
1542 {
1543 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1544 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1545 "number": 14,
1546 "issue": 12,
1547 "title": "Greeting should name the caller",
1548 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
1549 "agent": "claude-code",
1550 "runtime": "external",
1551 "status": "open",
1552 "fork": {
1553 "namespace": "pulls",
1554 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
1555 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1556 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'1557 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1558 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
1559 "merge_base": null,
1560 "merged_by": null,
1561 "merged_at": null,
1562 "superseded_by": null,
1563 "check_status": "passed",
Merge branch 'worktree-agent-ab2e39e11a6493412'1564 "files": [
1565 {
1566 "path": "src/main.rs",
1567 "additions": 6,
1568 "deletions": 2
1569 }
1570 ],
1571 "assignees": [],
1572 "reviewers": [
1573 "ana"
1574 ],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1575 "team_reviewers": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'1576 "author": {
1577 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1578 "username": "syntaqx",
1579 "kind": "user",
1580 "verified": false,
1581 "workspaces": []
1582 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1583 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1584 "created_at": "2026-10-01T18:20:02.117Z",
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1585 "updated_at": "2026-10-01T18:35:44.902Z",
1586 "labels": [],
1587 "milestone": null,
1588 "base": "main"
Merge branch 'worktree-agent-ab2e39e11a6493412'1589 }
1590 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1591 "notes": "Returns at most 100 pull requests, newest first. `check_status` is `queued`, `running`, `passed`, `failed`, `errored`, or `null` when no checks have run against the head."
Merge branch 'worktree-agent-ab2e39e11a6493412'1592 },
1593 "create_pull_request": {
1594 "request": {
1595 "issue": 12,
1596 "agent": "claude-code"
1597 },
1598 "response": {
1599 "pull": {
1600 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1601 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1602 "number": 14,
1603 "issue": 12,
1604 "title": "Greeting should name the caller",
1605 "body": null,
1606 "agent": "claude-code",
1607 "runtime": "external",
1608 "status": "draft",
1609 "fork": {
1610 "namespace": "pulls",
1611 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
1612 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1613 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'1614 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1615 "head_commit": null,
1616 "merge_base": null,
1617 "merged_by": null,
1618 "merged_at": null,
1619 "superseded_by": null,
1620 "check_status": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1621 "files": [],
1622 "assignees": [],
1623 "reviewers": [],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1624 "labels": [],
1625 "milestone": null,
1626 "base": "main",
Merge branch 'worktree-agent-ab2e39e11a6493412'1627 "author": {
1628 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1629 "username": "syntaqx",
1630 "kind": "user",
1631 "verified": false,
1632 "workspaces": []
1633 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1634 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1635 "created_at": "2026-10-01T18:20:02.117Z",
1636 "updated_at": "2026-10-01T18:20:02.117Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1637 },
1638 "git": {
1639 "remote": "https://g1t.sh/pulls/pr_01m43smh3vexsr5pmp60qwv0vs.git",
1640 "username": "syntaqx",
1641 "password": "your g1t access token"
1642 }
1643 },
1644 "notes": "`title` defaults to the issue's title, and is required when there is no `issue`. Push to `git.remote` with your username and an access token as the password.\n\nSend `branch` to open the pull request from a branch already pushed to the repository. No fork is made, `fork` is `null`, `git.remote` is the repository itself, and the pull request is `open` at once."
1645 },
1646 "get_pull_request": {
1647 "response": {
1648 "pull": {
1649 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1650 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1651 "number": 14,
1652 "issue": 12,
1653 "title": "Greeting should name the caller",
1654 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
1655 "agent": "claude-code",
1656 "runtime": "external",
1657 "status": "open",
1658 "fork": {
1659 "namespace": "pulls",
1660 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
1661 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1662 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'1663 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1664 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
1665 "merge_base": null,
1666 "merged_by": null,
1667 "merged_at": null,
1668 "superseded_by": null,
1669 "check_status": "passed",
Merge branch 'worktree-agent-ab2e39e11a6493412'1670 "files": [
1671 {
1672 "path": "src/main.rs",
1673 "additions": 6,
1674 "deletions": 2
1675 }
1676 ],
1677 "assignees": [],
1678 "reviewers": [
1679 "ana"
1680 ],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1681 "team_reviewers": [
1682 "flagon-io/backend"
1683 ],
Merge branch 'worktree-agent-ab2e39e11a6493412'1684 "author": {
1685 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1686 "username": "syntaqx",
1687 "kind": "user",
1688 "verified": false,
1689 "workspaces": []
1690 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1691 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1692 "created_at": "2026-10-01T18:20:02.117Z",
Thirteen MCP tools and classic token scopes; agents rate their confidence and can be put on an issue in one step1693 "updated_at": "2026-10-01T18:35:44.902Z",
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1694 "confidence": null,
1695 "labels": [],
1696 "milestone": null,
1697 "base": "main"
Merge branch 'worktree-agent-ab2e39e11a6493412'1698 },
1699 "issue": {
1700 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1701 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1702 "number": 12,
1703 "title": "Greeting should name the caller",
1704 "body": "Take a name from the first argument; fall back to world.",
1705 "labels": [
1706 "feature"
1707 ],
1708 "state": "open",
1709 "reason": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1710 "resolved_by": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1711 "author": {
1712 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1713 "username": "syntaqx",
1714 "kind": "user",
1715 "verified": false,
1716 "workspaces": []
1717 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1718 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1719 "created_at": "2026-10-01T18:04:11.482Z",
1720 "updated_at": "2026-10-01T18:20:02.117Z",
1721 "closed_at": null,
1722 "pull_count": 1,
1723 "comment_count": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'1724 "assignees": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1725 "blocked_by": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'1726 "queued": false,
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1727 "agent": "claude-code",
1728 "milestone": null
Merge branch 'worktree-agent-ab2e39e11a6493412'1729 },
1730 "comments": [
1731 {
1732 "id": "cmt_01m43st6d0f4h8k2n6r0v4z8c2",
1733 "kind": "event",
1734 "author": {
1735 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1736 "username": "syntaqx",
1737 "kind": "user",
1738 "verified": false,
1739 "workspaces": []
1740 },
1741 "body": "marked this ready for review",
1742 "path": null,
1743 "line": null,
1744 "verdict": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1745 "created_at": "2026-10-01T18:33:10.420Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1746 }
1747 ],
Fast pages, required checks on the branch, self-hosted runners, honest incidents1748 "checks": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1749 "overlaps": [],
1750 "behind": false,
1751 "review_pending": false,
1752 "lifecycle": null,
1753 "landing": false,
1754 "stalled": null,
1755 "messages": [
1756 {
1757 "id": "msg_01m43tx5egeh4t3f9zcnjenqvz",
1758 "author": "syntaqx",
1759 "body": "Keep \"world\" as the default when no name is given.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1760 "created_at": "2026-10-01T18:25:00.310Z",
1761 "delivered_at": "2026-10-01T18:25:31.007Z",
Merge branch 'worktree-agent-ab2e39e11a6493412'1762 "kind": "message",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1763 "from_number": null,
1764 "to_number": 14,
Merge branch 'worktree-agent-ab2e39e11a6493412'1765 "answer": null,
1766 "declined": false
1767 }
1768 ],
Fast pages, required checks on the branch, self-hosted runners, honest incidents1769 "statuses": [
1770 {
1771 "context": "CI / pull_request",
1772 "state": "success",
1773 "description": "CI passed",
1774 "target_url": "https://g1t.sh/syntaqx/hello/actions/runs/run_01m43sw8e2g6j0m4q8t2x6a0c4",
1775 "updated_at": "2026-10-01T18:35:44.902Z"
1776 }
1777 ],
1778 "required_checks": [
1779 {
1780 "name": "CI",
1781 "state": "success",
1782 "description": "CI passed",
1783 "target_url": "https://g1t.sh/syntaqx/hello/actions/runs/run_01m43sw8e2g6j0m4q8t2x6a0c4"
1784 }
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1785 ],
1786 "code_owners": {
1787 "path": ".github/CODEOWNERS",
1788 "required": true,
1789 "reviews": [
1790 {
1791 "section": null,
1792 "line": 3,
1793 "pattern": "/src/",
1794 "owners": [
1795 "@flagon-io/backend"
1796 ],
1797 "files": [
1798 "src/main.rs"
1799 ],
1800 "optional": false,
1801 "required": 1,
1802 "approved_by": [],
1803 "changes_requested_by": [],
1804 "satisfied": false
1805 }
1806 ],
1807 "missing": "Code owners have not approved: @flagon-io/backend for /src/.",
1808 "errors": 0
1809 }
Merge branch 'worktree-agent-ab2e39e11a6493412'1810 },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1811 "notes": "| Field | |\n| --- | --- |\n| `pull.files` | The files it changes, with lines added and removed. |\n| `statuses` | Its checks: what each workflow run (or another tool, such as a deployment) reported on its head, as `pending`, `success`, `failure` or `error`, with a link to the run. |\n| `required_checks` | Each check the default branch requires (see [`update_repo_settings`](/reference/api/repositories/update-repo-settings/)), as it stands on the head: `success`, `failure`, `pending`, or `expected` when nothing has reported it yet. It merges only once all are `success`. |\n| `checks` | Set when the merge queue took it out, with why in `error`. Older pull requests may show a run of commands from their issue here, from before checks were workflows. |\n| `overlaps` | Other pull requests in progress that change the same files. |\n| `behind` | Whether the default branch has moved since it was made. |\n| `landing` | Whether it is being brought up to date to land. |\n| `lifecycle` | For a pull request g1t is seeing through: its stage, such as `working`, `checking`, `reviewing` or `needs_you`. |\n| `comments` | Comments, reviews and events, with `path`, `line` and `verdict`. |\n| `messages` | Messages sent to the agent working on it. |\n| `pull.reviewers`, `pull.team_reviewers` | The people asked to review it, `g1t` among them when a g1t agent was, and the teams, as `workspace/team`. Change them with [`request_reviewers`](/reference/api/pull-requests/request-reviewers/). |\n| `code_owners` | Present when the branch it merges into has a CODEOWNERS file: its `path`, whether code owners' approval is `required` there, `reviews` (one per section and rule that owns a changed file: `section`, `line`, `pattern`, `owners`, `files`, `optional`, the approvals `required`, `approved_by`, `changes_requested_by` and `satisfied`), what is still `missing`, as the merge box says it, and how many `errors` the file has; [`get_codeowners_errors`](/reference/api/repositories/get-codeowners-errors/) lists them. |\n| `mergeable` | Whether it merges cleanly into its target: `clean`, `conflicting`, `checking` (being worked out) or `unknown`. Worked out ahead of time whenever it or its target moves. |\n| `conflicts` | When `mergeable` is `conflicting`, the files that conflict. Resolve them by merging the target in, or have g1t do it. |\n| `earlier_checks` | Earlier records like `checks`, newest first. |\n\nChecks are the repository's workflows: they run on `pull_request` events when it is opened, marked ready and pushed to. Read why one failed with [`get_workflow_run`](/reference/api/actions/get-workflow-run/) and [`get_job_logs`](/reference/api/actions/get-job-logs/)."
Merge branch 'worktree-agent-ab2e39e11a6493412'1812 },
1813 "get_pull_request_changes": {
1814 "response": {
1815 "base": "3a7e9c1b5d2f4a6c8e0b2d4f6a8c0e2b4d6f8a1c",
1816 "head": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
1817 "files": [
1818 {
1819 "path": "src/main.rs",
1820 "status": "modified",
1821 "additions": 1,
1822 "deletions": 1,
1823 "binary": false,
1824 "hunks": [
1825 {
1826 "lines": [
1827 {
1828 "kind": "context",
1829 "old": 3,
1830 "new": 3,
1831 "text": "fn main() {"
1832 },
1833 {
1834 "kind": "delete",
1835 "old": 4,
1836 "new": null,
1837 "text": " println!(\"Hello, world!\");"
1838 },
1839 {
1840 "kind": "add",
1841 "old": null,
1842 "new": 4,
1843 "text": " println!(\"Hello, {}!\", std::env::args().nth(1).unwrap_or(\"world\".into()));"
1844 },
1845 {
1846 "kind": "context",
1847 "old": 5,
1848 "new": 5,
1849 "text": "}"
1850 }
1851 ]
1852 }
1853 ]
1854 }
1855 ],
1856 "truncated": false
1857 },
1858 "notes": "A file's `status` is `added`, `modified` or `deleted`. A binary file has no `hunks`. In a line, `old` is `null` when it was added and `new` is `null` when it was deleted."
1859 },
1860 "mark_pull_request_ready": {
1861 "request": {
1862 "summary": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\"."
1863 },
1864 "response": {
1865 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1866 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'1867 "number": 14,
1868 "issue": 12,
1869 "title": "Greeting should name the caller",
1870 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
1871 "agent": "claude-code",
1872 "runtime": "external",
1873 "status": "open",
1874 "fork": {
1875 "namespace": "pulls",
1876 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
1877 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1878 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'1879 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1880 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
1881 "merge_base": null,
1882 "merged_by": null,
1883 "merged_at": null,
1884 "superseded_by": null,
1885 "check_status": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'1886 "files": [
1887 {
1888 "path": "src/main.rs",
1889 "additions": 6,
1890 "deletions": 2
1891 }
1892 ],
1893 "assignees": [],
1894 "reviewers": [],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1895 "labels": [],
1896 "milestone": null,
1897 "base": "main",
Merge branch 'worktree-agent-ab2e39e11a6493412'1898 "author": {
1899 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1900 "username": "syntaqx",
1901 "kind": "user",
1902 "verified": false,
1903 "workspaces": []
1904 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights1905 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1906 "created_at": "2026-10-01T18:20:02.117Z",
1907 "updated_at": "2026-10-01T18:33:10.398Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1908 }
1909 },
1910 "review_pull_request": {
1911 "request": {
1912 "verdict": "request_changes",
1913 "body": "Trim the name before using it."
1914 },
1915 "response": {
1916 "id": "cmt_01m43sx9f3h7k1n5r9v3z7d1g5",
1917 "kind": "comment",
1918 "author": {
1919 "id": "usr_01kz9d3f7h1k5n9r3v7z1c5g9b",
1920 "username": "ana",
1921 "kind": "user",
1922 "verified": true,
1923 "workspaces": [
1924 {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look1925 "slug": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'1926 "role": "member"
1927 }
1928 ]
1929 },
1930 "body": "Trim the name before using it.",
1931 "path": null,
1932 "line": null,
1933 "verdict": "request_changes",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API1934 "created_at": "2026-10-01T18:40:05.019Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'1935 }
1936 },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar1937 "request_reviewers": {
1938 "params": {
1939 "owner": "flagon-io",
1940 "name": "hello",
1941 "number": 14
1942 },
1943 "request": {
1944 "reviewers": [
1945 "bo"
1946 ],
1947 "team_reviewers": [
1948 "backend"
1949 ]
1950 },
1951 "response": {
1952 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
1953 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
1954 "number": 14,
1955 "issue": 12,
1956 "title": "Greeting should name the caller",
1957 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
1958 "agent": "claude-code",
1959 "runtime": "external",
1960 "status": "open",
1961 "fork": {
1962 "namespace": "pulls",
1963 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
1964 },
1965 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
1966 "branch": null,
1967 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
1968 "merge_base": null,
1969 "merged_by": null,
1970 "merged_at": null,
1971 "superseded_by": null,
1972 "check_status": "passed",
1973 "files": [
1974 {
1975 "path": "src/main.rs",
1976 "additions": 6,
1977 "deletions": 2
1978 }
1979 ],
1980 "assignees": [],
1981 "reviewers": [
1982 "ana",
1983 "bo"
1984 ],
1985 "team_reviewers": [
1986 "flagon-io/backend"
1987 ],
1988 "author": {
1989 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
1990 "username": "syntaqx",
1991 "kind": "user",
1992 "verified": false,
1993 "workspaces": []
1994 },
1995 "requested_by": null,
1996 "created_at": "2026-10-01T18:20:02.117Z",
1997 "updated_at": "2026-10-01T18:40:12.331Z"
1998 },
1999 "notes": "Adds to who is asked: `reviewers` by username (`g1t` asks a g1t agent), `team_reviewers` as `workspace/team`, or a team's slug in the repository's workspace. A team with review assignment on has the people it picks added to `reviewers`, and stays in `team_reviewers`. Each is told in their inbox. Nobody is asked to review their own pull request. `422` for someone who is not an account, or a team that does not exist or that you cannot see. Whoever opened it, or the Triage role or higher, while it is open. See [Pull requests](/guides/pull-requests/) and [Teams](/guides/teams/)."
2000 },
2001 "remove_requested_reviewers": {
2002 "params": {
2003 "owner": "flagon-io",
2004 "name": "hello",
2005 "number": 14
2006 },
2007 "request": {
2008 "reviewers": [
2009 "bo"
2010 ],
2011 "team_reviewers": [
2012 "flagon-io/backend"
2013 ]
2014 },
2015 "response": {
2016 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
2017 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
2018 "number": 14,
2019 "issue": 12,
2020 "title": "Greeting should name the caller",
2021 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
2022 "agent": "claude-code",
2023 "runtime": "external",
2024 "status": "open",
2025 "fork": {
2026 "namespace": "pulls",
2027 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
2028 },
2029 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
2030 "branch": null,
2031 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2032 "merge_base": null,
2033 "merged_by": null,
2034 "merged_at": null,
2035 "superseded_by": null,
2036 "check_status": "passed",
2037 "files": [
2038 {
2039 "path": "src/main.rs",
2040 "additions": 6,
2041 "deletions": 2
2042 }
2043 ],
2044 "assignees": [],
2045 "reviewers": [
2046 "ana"
2047 ],
2048 "team_reviewers": [],
2049 "author": {
2050 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
2051 "username": "syntaqx",
2052 "kind": "user",
2053 "verified": false,
2054 "workspaces": []
2055 },
2056 "requested_by": null,
2057 "created_at": "2026-10-01T18:20:02.117Z",
2058 "updated_at": "2026-10-01T18:41:30.904Z"
2059 },
2060 "notes": "Takes them off who is asked; anyone not asked is ignored. Reviews they already gave stay, as do the people a team's review assignment picked: remove them by username."
2061 },
Merge branch 'worktree-agent-ab2e39e11a6493412'2062 "merge_pull_request": {
2063 "request": {
2064 "keep_issue_open": false
2065 },
2066 "response": {
2067 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2068 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'2069 "number": 14,
2070 "issue": 12,
2071 "title": "Greeting should name the caller",
2072 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
2073 "agent": "claude-code",
2074 "runtime": "external",
2075 "status": "merged",
2076 "fork": {
2077 "namespace": "pulls",
2078 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
2079 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2080 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'2081 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2082 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2083 "merge_base": "3a7e9c1b5d2f4a6c8e0b2d4f6a8c0e2b4d6f8a1c",
2084 "merged_by": "syntaqx",
2085 "merged_at": "2026-10-01T18:52:17.093Z",
2086 "superseded_by": null,
2087 "check_status": "passed",
Merge branch 'worktree-agent-ab2e39e11a6493412'2088 "files": [
2089 {
2090 "path": "src/main.rs",
2091 "additions": 6,
2092 "deletions": 2
2093 }
2094 ],
2095 "assignees": [],
2096 "reviewers": [
2097 "ana"
2098 ],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar2099 "labels": [],
2100 "milestone": null,
2101 "base": "main",
Merge branch 'worktree-agent-ab2e39e11a6493412'2102 "author": {
2103 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
2104 "username": "syntaqx",
2105 "kind": "user",
2106 "verified": false,
2107 "workspaces": []
2108 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights2109 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2110 "created_at": "2026-10-01T18:20:02.117Z",
2111 "updated_at": "2026-10-01T18:52:17.093Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2112 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2113 "notes": "A draft, or one whose checks have not passed, answers `409`. A pull request still `open` in the response has not landed yet: `landing` is true on it while it is brought up to date, and [get the merge queue](/reference/api/pull-requests/get-merge-queue/) shows it waiting in the [merge queue](/guides/merge-queue/). Merging records the pull request in the issue's `resolved_by` and sets `superseded_by` on the pull requests it closes."
Merge branch 'worktree-agent-ab2e39e11a6493412'2114 },
2115 "close_pull_request": {
2116 "response": {
2117 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2118 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
Merge branch 'worktree-agent-ab2e39e11a6493412'2119 "number": 14,
2120 "issue": 12,
2121 "title": "Greeting should name the caller",
2122 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
2123 "agent": "claude-code",
2124 "runtime": "external",
2125 "status": "closed",
2126 "fork": {
2127 "namespace": "pulls",
2128 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
2129 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2130 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
Merge branch 'worktree-agent-ab2e39e11a6493412'2131 "branch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2132 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2133 "merge_base": null,
2134 "merged_by": null,
2135 "merged_at": null,
2136 "superseded_by": null,
2137 "check_status": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'2138 "files": [
2139 {
2140 "path": "src/main.rs",
2141 "additions": 6,
2142 "deletions": 2
2143 }
2144 ],
2145 "assignees": [],
2146 "reviewers": [],
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar2147 "labels": [],
2148 "milestone": null,
2149 "base": "main",
Merge branch 'worktree-agent-ab2e39e11a6493412'2150 "author": {
2151 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
2152 "username": "syntaqx",
2153 "kind": "user",
2154 "verified": false,
2155 "workspaces": []
2156 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights2157 "requested_by": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2158 "created_at": "2026-10-01T18:20:02.117Z",
2159 "updated_at": "2026-10-01T19:02:48.760Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2160 }
2161 },
2162 "get_merge_queue": {
2163 "response": {
2164 "enabled": true,
2165 "active": [
2166 {
2167 "id": "qen_01m43rn0qsft1tpap1awkewzbb",
2168 "number": 14,
2169 "title": "Greeting should name the caller",
2170 "agent": "claude-code",
2171 "state": "testing",
2172 "ahead": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2173 "base_commit": "3a7e9c1b5d2f4a6c8e0b2d4f6a8c0e2b4d6f8a1c",
2174 "combined_commit": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'2175 "error": null,
2176 "results": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2177 "enqueued_by": "syntaqx",
2178 "created_at": "2026-10-04T15:31:20.441Z",
2179 "finished_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2180 }
2181 ],
2182 "recent": [
2183 {
2184 "id": "qen_01m43khqjmeb5a1magayrnk63z",
2185 "number": 11,
2186 "title": "Fix trailing newline in greeting",
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent2187 "agent": "g1t",
Merge branch 'worktree-agent-ab2e39e11a6493412'2188 "state": "landed",
2189 "ahead": [],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2190 "base_commit": "4b1d7e9c2a5f8e3d6c0b9a7e5d3c1b8a6f4e2d0c",
2191 "combined_commit": "c3e8a1f6d4b2097e5c3a1f8d6b4e2c0a9f7d5b3e",
Merge branch 'worktree-agent-ab2e39e11a6493412'2192 "error": null,
2193 "results": [
2194 {
2195 "command": "cargo test",
2196 "passed": true,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2197 "exit_code": 0,
Merge branch 'worktree-agent-ab2e39e11a6493412'2198 "output": "test result: ok. 12 passed; 0 failed\n",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2199 "duration_ms": 48211
Merge branch 'worktree-agent-ab2e39e11a6493412'2200 }
2201 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2202 "enqueued_by": "g1t",
2203 "created_at": "2026-10-04T14:02:09.876Z",
2204 "finished_at": "2026-10-04T14:09:55.102Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2205 }
2206 ]
2207 },
2208 "notes": "An entry's `state` is `waiting`, `testing`, `passed`, `failed`, `landed` or `removed`. `active` is in queue order; `recent` holds at most 20, newest first."
2209 },
2210 "message_agent": {
2211 "request": {
2212 "body": "Keep \"world\" as the default when no name is given."
2213 },
2214 "response": {
2215 "id": "msg_01m43tx5egeh4t3f9zcnjenqvz",
2216 "author": "syntaqx",
2217 "body": "Keep \"world\" as the default when no name is given.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2218 "created_at": "2026-10-01T18:25:00.310Z",
2219 "delivered_at": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'2220 "kind": "message",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2221 "from_number": null,
2222 "to_number": 14,
Merge branch 'worktree-agent-ab2e39e11a6493412'2223 "answer": null,
2224 "declined": false
2225 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2226 "notes": "The response is the message. `delivered_at` is set once the agent has read it."
Merge branch 'worktree-agent-ab2e39e11a6493412'2227 },
2228 "answer_message": {
2229 "params": {
2230 "id": "msg_01m43t66tde8hs2vpxhh3v8tqw"
2231 },
2232 "request": {
2233 "body": "No. greet() keeps its name; only greet_named() is added."
2234 },
2235 "response": {
2236 "id": "msg_01m43t66tde8hs2vpxhh3v8tqw",
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent2237 "author": "g1t",
Merge branch 'worktree-agent-ab2e39e11a6493412'2238 "body": "Are you renaming greet() in src/lib.rs? I need to call it from #16.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2239 "created_at": "2026-10-01T18:58:12.301Z",
2240 "delivered_at": "2026-10-01T18:58:40.117Z",
Merge branch 'worktree-agent-ab2e39e11a6493412'2241 "kind": "question",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2242 "from_number": 16,
2243 "to_number": 14,
Merge branch 'worktree-agent-ab2e39e11a6493412'2244 "answer": "No. greet() keeps its name; only greet_named() is added.",
2245 "declined": false
2246 },
2247 "notes": "The response is the question or handoff that was answered, with `answer` and `declined` filled in."
2248 },
2249 "take_messages": {
2250 "response": [
2251 {
2252 "id": "msg_01m43tx5egeh4t3f9zcnjenqvz",
2253 "author": "syntaqx",
2254 "body": "Keep \"world\" as the default when no name is given.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2255 "created_at": "2026-10-01T18:25:00.310Z",
2256 "delivered_at": "2026-10-01T18:25:31.007Z",
Merge branch 'worktree-agent-ab2e39e11a6493412'2257 "kind": "message",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2258 "from_number": null,
2259 "to_number": 14,
Merge branch 'worktree-agent-ab2e39e11a6493412'2260 "answer": null,
2261 "declined": false
2262 }
2263 ],
2264 "notes": "Only a g1t agent's token can take messages. They come oldest first, and each is marked delivered."
2265 },
2266 "read_session": {
2267 "query": {
2268 "after": 0
2269 },
2270 "response": [
2271 {
2272 "seq": 1,
2273 "kind": "prompt",
2274 "text": "Make the greeting name the caller (issue #12).",
2275 "tool": null,
2276 "commit": null,
2277 "at": "2026-10-01T18:21:00.004Z"
2278 },
2279 {
2280 "seq": 2,
2281 "kind": "tool_call",
2282 "text": "cargo test",
2283 "tool": "bash",
2284 "commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2285 "at": "2026-10-01T18:30:12.660Z"
2286 }
2287 ]
2288 },
2289 "record_session": {
2290 "request": {
2291 "entries": [
2292 {
2293 "kind": "message",
2294 "text": "Reading src/main.rs."
2295 },
2296 {
2297 "kind": "tool_call",
2298 "text": "cargo test",
2299 "tool": "bash"
2300 }
2301 ]
2302 },
2303 "response": {
2304 "count": 2
2305 },
2306 "notes": "Up to 200 entries can be appended per request. Each is recorded against the pull request's head commit at the time. See [sessions and why-blame](/guides/why-blame/)."
2307 },
2308 "list_workflows": {
2309 "response": [
2310 {
2311 "id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
2312 "path": ".g1t/workflows/ci.yml",
2313 "name": "CI",
2314 "events": [
2315 "push",
2316 "pull_request",
2317 "workflow_dispatch"
2318 ],
2319 "state": "active",
2320 "error": null,
2321 "notes": [
2322 {
2323 "severity": "unsupported",
2324 "job": "test",
2325 "message": "`services` containers (such as a database) are not started on g1t yet."
2326 }
2327 ],
2328 "dispatch": {
2329 "debug": {
2330 "description": "Verbose logs",
2331 "type": "boolean",
2332 "default": false
2333 }
2334 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2335 "last_run": {
Merge branch 'worktree-agent-ab2e39e11a6493412'2336 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2337 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2338 "path": ".g1t/workflows/ci.yml",
2339 "name": "CI",
2340 "title": "Greeting should name the caller",
2341 "number": 12,
2342 "attempt": 1,
2343 "event": "push",
2344 "ref": "refs/heads/main",
2345 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2346 "pull": null,
2347 "status": "completed",
2348 "conclusion": "success",
2349 "error": null,
2350 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2351 "created_at": "2026-10-04T15:42:07.318Z",
2352 "started_at": "2026-10-04T15:42:09.020Z",
2353 "finished_at": "2026-10-04T15:44:31.877Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2354 }
2355 },
2356 {
2357 "id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9nq",
2358 "path": ".g1t/workflows/nightly.yml",
2359 "name": "Nightly",
2360 "events": [
2361 "schedule"
2362 ],
2363 "state": "disabled",
2364 "error": null,
2365 "notes": [],
2366 "dispatch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2367 "last_run": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2368 }
2369 ],
2370 "notes": "`state` is `active` or `disabled`. `dispatch` holds the `workflow_dispatch` inputs, or is `null` when the workflow cannot be run by hand. See [GitHub Actions](/guides/actions/)."
2371 },
2372 "list_workflow_runs": {
2373 "query": {
2374 "workflow": "ci.yml",
2375 "branch": "main",
2376 "per_page": 20
2377 },
2378 "response": [
2379 {
2380 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2381 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2382 "path": ".g1t/workflows/ci.yml",
2383 "name": "CI",
2384 "title": "Greeting should name the caller",
2385 "number": 12,
2386 "attempt": 1,
2387 "event": "push",
2388 "ref": "refs/heads/main",
2389 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2390 "pull": null,
2391 "status": "completed",
2392 "conclusion": "success",
2393 "error": null,
2394 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2395 "created_at": "2026-10-04T15:42:07.318Z",
2396 "started_at": "2026-10-04T15:42:09.020Z",
2397 "finished_at": "2026-10-04T15:44:31.877Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2398 }
2399 ],
2400 "notes": "A run's `status` is `queued`, `pending` (waiting for its concurrency group), `in_progress` or `completed`; `conclusion` is set once it completes."
2401 },
2402 "list_runs_of_workflow": {
2403 "params": {
2404 "workflow": "ci.yml"
2405 },
2406 "query": {
2407 "branch": "main",
2408 "per_page": 20
2409 },
2410 "response": [
2411 {
2412 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2413 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2414 "path": ".g1t/workflows/ci.yml",
2415 "name": "CI",
2416 "title": "Greeting should name the caller",
2417 "number": 12,
2418 "attempt": 1,
2419 "event": "push",
2420 "ref": "refs/heads/main",
2421 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2422 "pull": null,
2423 "status": "completed",
2424 "conclusion": "success",
2425 "error": null,
2426 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2427 "created_at": "2026-10-04T15:42:07.318Z",
2428 "started_at": "2026-10-04T15:42:09.020Z",
2429 "finished_at": "2026-10-04T15:44:31.877Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2430 }
2431 ]
2432 },
2433 "get_workflow_run": {
2434 "params": {
2435 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr"
2436 },
2437 "response": {
2438 "run": {
2439 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2440 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2441 "path": ".g1t/workflows/ci.yml",
2442 "name": "CI",
2443 "title": "Greeting should name the caller",
2444 "number": 12,
2445 "attempt": 1,
2446 "event": "push",
2447 "ref": "refs/heads/main",
2448 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2449 "pull": null,
2450 "status": "completed",
2451 "conclusion": "failure",
2452 "error": null,
2453 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2454 "created_at": "2026-10-04T15:42:07.318Z",
2455 "started_at": "2026-10-04T15:42:09.020Z",
2456 "finished_at": "2026-10-04T15:44:31.877Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2457 },
2458 "jobs": [
2459 {
2460 "id": "job_01kpx7b3d0e4f8g2h6j0k4m8ns",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2461 "run_id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Merge branch 'worktree-agent-ab2e39e11a6493412'2462 "key": "test",
2463 "name": "test",
2464 "needs": [],
2465 "status": "completed",
2466 "conclusion": "failure",
2467 "steps": [
2468 {
2469 "number": 1,
2470 "name": "Run actions/checkout@v4",
2471 "status": "completed",
2472 "conclusion": "success",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2473 "started_at": "2026-10-04T15:42:10.101Z",
2474 "finished_at": "2026-10-04T15:42:12.433Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2475 },
2476 {
2477 "number": 2,
2478 "name": "Run cargo test",
2479 "status": "completed",
2480 "conclusion": "failure",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2481 "started_at": "2026-10-04T15:42:12.440Z",
2482 "finished_at": "2026-10-04T15:44:30.902Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2483 }
2484 ],
2485 "annotations": [
2486 {
2487 "level": "error",
2488 "message": "assertion failed: greeting names the caller",
2489 "title": "greet",
2490 "file": "src/main.rs",
2491 "line": 41
2492 }
2493 ],
2494 "reason": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2495 "started_at": "2026-10-04T15:42:09.020Z",
2496 "finished_at": "2026-10-04T15:44:31.002Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2497 },
2498 {
2499 "id": "job_01kpx7b3d0e4f8g2h6j0k4m8nt",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2500 "run_id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Merge branch 'worktree-agent-ab2e39e11a6493412'2501 "key": "deploy",
2502 "name": "deploy",
2503 "needs": [
2504 "test"
2505 ],
2506 "status": "completed",
2507 "conclusion": "skipped",
2508 "steps": [],
2509 "annotations": [],
2510 "reason": "A job it needs did not succeed.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2511 "started_at": null,
2512 "finished_at": "2026-10-04T15:44:31.877Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2513 }
2514 ],
2515 "notes": [
2516 {
2517 "severity": "unsupported",
2518 "job": "test",
2519 "message": "`services` containers (such as a database) are not started on g1t yet."
2520 }
2521 ]
2522 }
2523 },
2524 "get_job_logs": {
2525 "params": {
2526 "job": "job_01kpx7b3d0e4f8g2h6j0k4m8ns"
2527 },
2528 "query": {
2529 "after": 0
2530 },
2531 "response": {
2532 "chunks": [
2533 {
2534 "seq": 1,
2535 "step": 0,
2536 "text": "Preparing the sandbox\n"
2537 },
2538 {
2539 "seq": 2,
2540 "step": 2,
2541 "text": "> cargo test\ntest greet ... FAILED\n"
2542 }
2543 ],
2544 "done": true
2545 },
2546 "notes": "Returns at most 500 chunks. Step 0 is the job's setup. While `done` is false, call again with the last `seq` as `after`."
2547 },
2548 "dispatch_workflow": {
2549 "params": {
2550 "workflow": "ci.yml"
2551 },
2552 "request": {
2553 "ref": "main",
2554 "inputs": {
2555 "debug": true
2556 }
2557 },
2558 "response": {
2559 "id": "run_01kpx8d4e7f0g3h6j9k2m5n8pq",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2560 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2561 "path": ".g1t/workflows/ci.yml",
2562 "name": "CI",
2563 "title": "CI run by syntaqx",
2564 "number": 13,
2565 "attempt": 1,
2566 "event": "workflow_dispatch",
2567 "ref": "refs/heads/main",
2568 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2569 "pull": null,
2570 "status": "queued",
2571 "conclusion": null,
2572 "error": null,
2573 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2574 "created_at": "2026-10-04T16:30:00.512Z",
2575 "started_at": null,
2576 "finished_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2577 }
2578 },
2579 "cancel_workflow_run": {
2580 "params": {
2581 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr"
2582 },
2583 "response": {
2584 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2585 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2586 "path": ".g1t/workflows/ci.yml",
2587 "name": "CI",
2588 "title": "Greeting should name the caller",
2589 "number": 12,
2590 "attempt": 1,
2591 "event": "push",
2592 "ref": "refs/heads/main",
2593 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2594 "pull": null,
2595 "status": "completed",
2596 "conclusion": "cancelled",
2597 "error": null,
2598 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2599 "created_at": "2026-10-04T15:42:07.318Z",
2600 "started_at": "2026-10-04T15:42:09.020Z",
2601 "finished_at": "2026-10-04T15:44:31.877Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'2602 }
2603 },
2604 "rerun_workflow_run": {
2605 "params": {
2606 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr"
2607 },
2608 "request": {
2609 "failed_only": true
2610 },
2611 "response": {
2612 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2613 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2614 "path": ".g1t/workflows/ci.yml",
2615 "name": "CI",
2616 "title": "Greeting should name the caller",
2617 "number": 12,
2618 "attempt": 2,
2619 "event": "push",
2620 "ref": "refs/heads/main",
2621 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2622 "pull": null,
2623 "status": "queued",
2624 "conclusion": null,
2625 "error": null,
2626 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2627 "created_at": "2026-10-04T15:42:07.318Z",
2628 "started_at": null,
2629 "finished_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2630 },
2631 "notes": "The run keeps its id; `attempt` goes up by one."
2632 },
2633 "rerun_failed_jobs": {
2634 "params": {
2635 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr"
2636 },
2637 "response": {
2638 "id": "run_01kpx7b3c6d9e2f5g8h1j4k7mr",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2639 "workflow_id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9np",
Merge branch 'worktree-agent-ab2e39e11a6493412'2640 "path": ".g1t/workflows/ci.yml",
2641 "name": "CI",
2642 "title": "Greeting should name the caller",
2643 "number": 12,
2644 "attempt": 2,
2645 "event": "push",
2646 "ref": "refs/heads/main",
2647 "sha": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
2648 "pull": null,
2649 "status": "queued",
2650 "conclusion": null,
2651 "error": null,
2652 "actor": "syntaqx",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2653 "created_at": "2026-10-04T15:42:07.318Z",
2654 "started_at": null,
2655 "finished_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2656 }
2657 },
2658 "update_workflow": {
2659 "params": {
2660 "workflow": "nightly.yml"
2661 },
2662 "request": {
2663 "enabled": false
2664 },
2665 "response": {
2666 "id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9nq",
2667 "path": ".g1t/workflows/nightly.yml",
2668 "name": "Nightly",
2669 "events": [
2670 "schedule"
2671 ],
2672 "state": "disabled",
2673 "error": null,
2674 "notes": [],
2675 "dispatch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2676 "last_run": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2677 }
2678 },
2679 "enable_workflow": {
2680 "params": {
2681 "workflow": "nightly.yml"
2682 },
2683 "response": {
2684 "id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9nq",
2685 "path": ".g1t/workflows/nightly.yml",
2686 "name": "Nightly",
2687 "events": [
2688 "schedule"
2689 ],
2690 "state": "active",
2691 "error": null,
2692 "notes": [],
2693 "dispatch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2694 "last_run": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2695 }
2696 },
2697 "disable_workflow": {
2698 "params": {
2699 "workflow": "nightly.yml"
2700 },
2701 "response": {
2702 "id": "wfl_01kpw2c5d8e1f4g7h0j3k6m9nq",
2703 "path": ".g1t/workflows/nightly.yml",
2704 "name": "Nightly",
2705 "events": [
2706 "schedule"
2707 ],
2708 "state": "disabled",
2709 "error": null,
2710 "notes": [],
2711 "dispatch": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2712 "last_run": null
Merge branch 'worktree-agent-ab2e39e11a6493412'2713 }
2714 },
2715 "list_actions_secrets": {
2716 "response": [
2717 {
2718 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ab",
2719 "name": "NPM_TOKEN",
2720 "kind": "secret",
2721 "value": null,
2722 "scope": "workspace",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2723 "updated_at": "2026-10-01T09:12:44.020Z",
2724 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2725 "workflows"
2726 ],
2727 "environments": [],
API reference examples use projects2728 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2729 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2730 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2731 },
2732 {
2733 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ac",
2734 "name": "STRIPE_KEY",
2735 "kind": "secret",
2736 "value": null,
API reference examples use projects2737 "scope": "project",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2738 "updated_at": "2026-10-04T15:42:07.318Z",
2739 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2740 "workflows",
2741 "deployments"
2742 ],
2743 "environments": [
2744 "production"
2745 ],
API reference examples use projects2746 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2747 "note": "Rotate in the Stripe dashboard.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2748 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2749 }
2750 ],
2751 "notes": "Values are never returned. A repository's list includes the workspace's rows that reach it, with `scope` set to `workspace`. Empty `environments` means every environment."
2752 },
2753 "list_actions_secrets_for_workspace": {
2754 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look2755 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'2756 },
2757 "response": [
2758 {
2759 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ab",
2760 "name": "NPM_TOKEN",
2761 "kind": "secret",
2762 "value": null,
2763 "scope": "workspace",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2764 "updated_at": "2026-10-04T15:42:07.318Z",
2765 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2766 "workflows"
2767 ],
2768 "environments": [],
API reference examples use projects2769 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2770 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2771 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2772 }
2773 ],
2774 "notes": "Values are never returned. A repository's list includes the workspace's rows that reach it, with `scope` set to `workspace`. Empty `environments` means every environment."
2775 },
2776 "set_actions_secret": {
2777 "params": {
2778 "setting": "STRIPE_KEY"
2779 },
2780 "request": {
2781 "value": "sk_live_…",
2782 "available_to": [
2783 "workflows",
2784 "deployments"
2785 ],
2786 "environments": [
2787 "production"
2788 ]
2789 },
2790 "response": {
2791 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ac",
2792 "name": "STRIPE_KEY",
2793 "kind": "secret",
2794 "value": null,
API reference examples use projects2795 "scope": "project",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2796 "updated_at": "2026-10-04T15:42:07.318Z",
2797 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2798 "workflows",
2799 "deployments"
2800 ],
2801 "environments": [
2802 "production"
2803 ],
API reference examples use projects2804 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2805 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2806 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2807 },
2808 "notes": "Keys are uppercased. See [secrets and variables](/guides/secrets-and-variables/)."
2809 },
2810 "set_actions_secret_for_workspace": {
2811 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look2812 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'2813 "setting": "NPM_TOKEN"
2814 },
2815 "request": {
2816 "value": "npm_…",
API reference examples use projects2817 "projects": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2818 "hello"
2819 ]
2820 },
2821 "response": {
2822 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ac",
2823 "name": "NPM_TOKEN",
2824 "kind": "secret",
2825 "value": null,
2826 "scope": "workspace",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2827 "updated_at": "2026-10-04T15:42:07.318Z",
2828 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2829 "workflows"
2830 ],
2831 "environments": [],
API reference examples use projects2832 "projects": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2833 "hello"
2834 ],
2835 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2836 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2837 }
2838 },
2839 "delete_actions_secret": {
2840 "params": {
2841 "setting": "STRIPE_KEY"
2842 },
2843 "response": true
2844 },
2845 "delete_actions_secret_for_workspace": {
2846 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look2847 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'2848 "setting": "NPM_TOKEN"
2849 },
2850 "response": true
2851 },
2852 "list_actions_variables": {
2853 "response": [
2854 {
2855 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ad",
2856 "name": "NODE_VERSION",
2857 "kind": "variable",
2858 "value": "20",
API reference examples use projects2859 "scope": "project",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2860 "updated_at": "2026-10-04T15:42:07.318Z",
2861 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2862 "workflows",
2863 "deployments"
2864 ],
2865 "environments": [],
API reference examples use projects2866 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2867 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2868 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2869 }
2870 ],
2871 "notes": "A repository's list includes the workspace's rows that reach it, with `scope` set to `workspace`. Empty `environments` means every environment."
2872 },
2873 "list_actions_variables_for_workspace": {
2874 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look2875 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'2876 },
2877 "response": [
2878 {
2879 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ad",
2880 "name": "NODE_VERSION",
2881 "kind": "variable",
2882 "value": "20",
2883 "scope": "workspace",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2884 "updated_at": "2026-10-04T15:42:07.318Z",
2885 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2886 "workflows",
2887 "deployments"
2888 ],
2889 "environments": [],
API reference examples use projects2890 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2891 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2892 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2893 }
2894 ]
2895 },
2896 "set_actions_variable": {
2897 "request": {
2898 "setting": "NODE_VERSION",
2899 "value": "20"
2900 },
2901 "response": {
2902 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ad",
2903 "name": "NODE_VERSION",
2904 "kind": "variable",
2905 "value": "20",
API reference examples use projects2906 "scope": "project",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2907 "updated_at": "2026-10-04T15:42:07.318Z",
2908 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2909 "workflows",
2910 "deployments"
2911 ],
2912 "environments": [],
API reference examples use projects2913 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2914 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2915 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2916 },
2917 "notes": "GitHub's clients send the key as `name`; that is accepted too."
2918 },
2919 "set_actions_variable_for_workspace": {
2920 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look2921 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'2922 },
2923 "request": {
2924 "setting": "NODE_VERSION",
2925 "value": "20"
2926 },
2927 "response": {
2928 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ad",
2929 "name": "NODE_VERSION",
2930 "kind": "variable",
2931 "value": "20",
2932 "scope": "workspace",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2933 "updated_at": "2026-10-04T15:42:07.318Z",
2934 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2935 "workflows",
2936 "deployments"
2937 ],
2938 "environments": [],
API reference examples use projects2939 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2940 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2941 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2942 }
2943 },
2944 "update_actions_variable": {
2945 "params": {
2946 "setting": "NODE_VERSION"
2947 },
2948 "request": {
2949 "value": "22"
2950 },
2951 "response": {
2952 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ad",
2953 "name": "NODE_VERSION",
2954 "kind": "variable",
2955 "value": "22",
API reference examples use projects2956 "scope": "project",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2957 "updated_at": "2026-10-04T15:42:07.318Z",
2958 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2959 "workflows",
2960 "deployments"
2961 ],
2962 "environments": [],
API reference examples use projects2963 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2964 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2965 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2966 }
2967 },
2968 "update_actions_variable_for_workspace": {
2969 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look2970 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'2971 "setting": "NODE_VERSION"
2972 },
2973 "request": {
2974 "value": "22"
2975 },
2976 "response": {
2977 "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ad",
2978 "name": "NODE_VERSION",
2979 "kind": "variable",
2980 "value": "22",
2981 "scope": "workspace",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2982 "updated_at": "2026-10-04T15:42:07.318Z",
2983 "available_to": [
Merge branch 'worktree-agent-ab2e39e11a6493412'2984 "workflows",
2985 "deployments"
2986 ],
2987 "environments": [],
API reference examples use projects2988 "projects": [],
Merge branch 'worktree-agent-ab2e39e11a6493412'2989 "note": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API2990 "updated_by": "syntaqx"
Merge branch 'worktree-agent-ab2e39e11a6493412'2991 }
2992 },
2993 "delete_actions_variable": {
2994 "params": {
2995 "setting": "NODE_VERSION"
2996 },
2997 "response": true
2998 },
2999 "delete_actions_variable_for_workspace": {
3000 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3001 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3002 "setting": "NODE_VERSION"
3003 },
3004 "response": true
3005 },
Fast pages, required checks on the branch, self-hosted runners, honest incidents3006 "list_runners": {
3007 "response": [
3008 {
3009 "id": "rnr_01kq2m8v4c7f0h3k6n9q2t5w8z",
3010 "name": "build-01",
3011 "workspace": "flagon-io",
3012 "repo": null,
3013 "group": "Default",
3014 "labels": [
3015 "self-hosted",
3016 "linux",
3017 "x64",
3018 "gpu"
3019 ],
3020 "os": "linux",
3021 "arch": "x64",
3022 "version": "0.2.0",
3023 "ephemeral": false,
3024 "status": "busy",
3025 "work": {
3026 "kind": "workflow",
3027 "id": "job_01kq2m9b1d4g7j0m3p6s9v2y5b",
3028 "name": "test (linux, 24)",
3029 "repo": "flagon-io/hello",
3030 "run_id": "run_01kq2m9a8c1f4h7k0n3q6t9w2z",
3031 "started_at": "2026-10-06T14:02:11.000Z"
3032 },
3033 "last_seen_at": "2026-10-06T14:05:40.512Z",
3034 "created_at": "2026-10-02T09:30:00.000Z",
3035 "created_by": null
3036 },
3037 {
3038 "id": "rnr_01kq2m8v4c7f0h3k6n9q2t5w9a",
3039 "name": "mac-mini",
3040 "workspace": "flagon-io",
3041 "repo": null,
3042 "group": "Default",
3043 "labels": [
3044 "self-hosted",
3045 "macos",
3046 "arm64"
3047 ],
3048 "os": "macos",
3049 "arch": "arm64",
3050 "version": "0.2.0",
3051 "ephemeral": false,
3052 "status": "online",
3053 "work": null,
3054 "last_seen_at": "2026-10-06T14:05:40.512Z",
3055 "created_at": "2026-10-02T09:30:00.000Z",
3056 "created_by": null
3057 }
3058 ],
3059 "notes": "A repository's list holds its own runners (`repo` set) and the workspace's that its runner group lets it use. A runner is `offline` when it has not polled for 90 seconds."
3060 },
3061 "list_runners_for_workspace": {
3062 "params": {
3063 "workspace": "flagon-io"
3064 },
3065 "response": [
3066 {
3067 "id": "rnr_01kq2m8v4c7f0h3k6n9q2t5w8z",
3068 "name": "build-01",
3069 "workspace": "flagon-io",
3070 "repo": null,
3071 "group": "Default",
3072 "labels": [
3073 "self-hosted",
3074 "linux",
3075 "x64",
3076 "gpu"
3077 ],
3078 "os": "linux",
3079 "arch": "x64",
3080 "version": "0.2.0",
3081 "ephemeral": false,
3082 "status": "busy",
3083 "work": {
3084 "kind": "workflow",
3085 "id": "job_01kq2m9b1d4g7j0m3p6s9v2y5b",
3086 "name": "test (linux, 24)",
3087 "repo": "flagon-io/hello",
3088 "run_id": "run_01kq2m9a8c1f4h7k0n3q6t9w2z",
3089 "started_at": "2026-10-06T14:02:11.000Z"
3090 },
3091 "last_seen_at": "2026-10-06T14:05:40.512Z",
3092 "created_at": "2026-10-02T09:30:00.000Z",
3093 "created_by": null
3094 },
3095 {
3096 "id": "rnr_01kq2m8v4c7f0h3k6n9q2t5w9a",
3097 "name": "mac-mini",
3098 "workspace": "flagon-io",
3099 "repo": null,
3100 "group": "Default",
3101 "labels": [
3102 "self-hosted",
3103 "macos",
3104 "arm64"
3105 ],
3106 "os": "macos",
3107 "arch": "arm64",
3108 "version": "0.2.0",
3109 "ephemeral": false,
3110 "status": "online",
3111 "work": null,
3112 "last_seen_at": "2026-10-06T14:05:40.512Z",
3113 "created_at": "2026-10-02T09:30:00.000Z",
3114 "created_by": null
3115 }
3116 ]
3117 },
3118 "create_runner_registration_token": {
3119 "response": {
3120 "token": "g1trt_…",
3121 "expires_at": "2026-10-06T15:04:00.000Z",
3122 "workspace": "flagon-io",
3123 "repo": "flagon-io/hello",
3124 "group": null,
3125 "url": "https://g1t.sh"
3126 },
3127 "notes": "Pass it to `g1t-runner register --url https://g1t.sh --token …` within the hour. See [self-hosted runners](/guides/self-hosted-runners/)."
3128 },
3129 "create_runner_registration_token_for_workspace": {
3130 "params": {
3131 "workspace": "flagon-io"
3132 },
3133 "request": {
3134 "group": "Default"
3135 },
3136 "response": {
3137 "token": "g1trt_…",
3138 "expires_at": "2026-10-06T15:04:00.000Z",
3139 "workspace": "flagon-io",
3140 "repo": null,
3141 "group": "Default",
3142 "url": "https://g1t.sh"
3143 }
3144 },
3145 "remove_runner": {
3146 "params": {
3147 "id": "rnr_01kq2m8v4c7f0h3k6n9q2t5w8z"
3148 },
3149 "response": true
3150 },
3151 "remove_runner_for_workspace": {
3152 "params": {
3153 "workspace": "flagon-io",
3154 "id": "rnr_01kq2m8v4c7f0h3k6n9q2t5w8z"
3155 },
3156 "response": true
3157 },
3158 "get_runner_settings": {
3159 "response": {
3160 "agents_on_self_hosted": false,
3161 "agent_labels": [
3162 "self-hosted",
3163 "linux"
3164 ],
3165 "fork_pull_requests": false,
3166 "inherited": true
3167 }
3168 },
3169 "get_runner_settings_for_workspace": {
3170 "params": {
3171 "workspace": "flagon-io"
3172 },
3173 "response": {
3174 "agents_on_self_hosted": true,
3175 "agent_labels": [
3176 "self-hosted",
3177 "linux"
3178 ],
3179 "fork_pull_requests": false,
3180 "inherited": false
3181 }
3182 },
3183 "update_runner_settings": {
3184 "request": {
3185 "inherit": true
3186 },
3187 "response": {
3188 "agents_on_self_hosted": false,
3189 "agent_labels": [
3190 "self-hosted",
3191 "linux"
3192 ],
3193 "fork_pull_requests": false,
3194 "inherited": true
3195 }
3196 },
3197 "update_runner_settings_for_workspace": {
3198 "params": {
3199 "workspace": "flagon-io"
3200 },
3201 "request": {
3202 "agents_on_self_hosted": true,
3203 "agent_labels": [
3204 "linux"
3205 ]
3206 },
3207 "response": {
3208 "agents_on_self_hosted": true,
3209 "agent_labels": [
3210 "self-hosted",
3211 "linux"
3212 ],
3213 "fork_pull_requests": false,
3214 "inherited": false
3215 },
3216 "notes": "Agent work on your runners still uses g1t's model proxy, paid as before, unless the workspace has its own model provider."
3217 },
3218 "list_runner_groups": {
3219 "params": {
3220 "workspace": "flagon-io"
3221 },
3222 "response": [
3223 {
3224 "id": "rng_01kq2m7r2a5d8g1j4m7p0s3v6y",
3225 "name": "Default",
3226 "default": true,
3227 "repositories": [],
3228 "runners": 2,
3229 "updated_at": "2026-10-02T09:30:00.000Z"
3230 },
3231 {
3232 "id": "rng_01kq2m7r2a5d8g1j4m7p0s3v6z",
3233 "name": "GPU",
3234 "default": false,
3235 "repositories": [
3236 "hello",
3237 "models"
3238 ],
3239 "runners": 1,
3240 "updated_at": "2026-10-05T11:20:00.000Z"
3241 }
3242 ]
3243 },
3244 "create_runner_group": {
3245 "params": {
3246 "workspace": "flagon-io"
3247 },
3248 "request": {
3249 "name": "GPU",
3250 "repositories": [
3251 "hello",
3252 "models"
3253 ]
3254 },
3255 "response": {
3256 "id": "rng_01kq2m7r2a5d8g1j4m7p0s3v6z",
3257 "name": "GPU",
3258 "default": false,
3259 "repositories": [
3260 "hello",
3261 "models"
3262 ],
3263 "runners": 1,
3264 "updated_at": "2026-10-05T11:20:00.000Z"
3265 }
3266 },
3267 "update_runner_group": {
3268 "params": {
3269 "workspace": "flagon-io",
3270 "id": "rng_01kq2m7r2a5d8g1j4m7p0s3v6z"
3271 },
3272 "request": {
3273 "repositories": []
3274 },
3275 "response": {
3276 "id": "rng_01kq2m7r2a5d8g1j4m7p0s3v6z",
3277 "name": "GPU",
3278 "default": false,
3279 "repositories": [],
3280 "runners": 1,
3281 "updated_at": "2026-10-05T11:20:00.000Z"
3282 }
3283 },
3284 "delete_runner_group": {
3285 "params": {
3286 "workspace": "flagon-io",
3287 "id": "rng_01kq2m7r2a5d8g1j4m7p0s3v6z"
3288 },
3289 "response": true
3290 },
Merge branch 'worktree-agent-ab2e39e11a6493412'3291 "list_webhooks": {
3292 "response": [
3293 {
3294 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3295 "scope": "repo",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3296 "workspace": "flagon-io",
3297 "repo": "flagon-io/hello",
Merge branch 'worktree-agent-ab2e39e11a6493412'3298 "url": "https://hooks.example.com/g1t",
3299 "events": [
3300 "git.push",
3301 "pull.merged"
3302 ],
3303 "active": true,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3304 "secret_hint": "…9c2e",
3305 "created_by": "syntaqx",
3306 "created_at": "2026-10-04T15:42:07.318Z",
3307 "last_status": "delivered",
3308 "last_delivered_at": "2026-10-04T15:42:07.611Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3309 }
3310 ]
3311 },
3312 "list_webhooks_for_workspace": {
3313 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3314 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'3315 },
3316 "response": [
3317 {
3318 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3319 "scope": "workspace",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3320 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3321 "repo": null,
3322 "url": "https://hooks.example.com/g1t",
3323 "events": [
3324 "git.push",
3325 "pull.merged"
3326 ],
3327 "active": true,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3328 "secret_hint": "…9c2e",
3329 "created_by": "syntaqx",
3330 "created_at": "2026-10-04T15:42:07.318Z",
3331 "last_status": "delivered",
3332 "last_delivered_at": "2026-10-04T15:42:07.611Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3333 }
3334 ]
3335 },
3336 "create_webhook": {
3337 "request": {
3338 "url": "https://hooks.example.com/g1t",
3339 "events": [
3340 "git.push",
3341 "pull.merged"
3342 ]
3343 },
3344 "response": {
3345 "hook": {
3346 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3347 "scope": "repo",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3348 "workspace": "flagon-io",
3349 "repo": "flagon-io/hello",
Merge branch 'worktree-agent-ab2e39e11a6493412'3350 "url": "https://hooks.example.com/g1t",
3351 "events": [
3352 "git.push",
3353 "pull.merged"
3354 ],
3355 "active": true,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3356 "secret_hint": "…9c2e",
3357 "created_by": "syntaqx",
3358 "created_at": "2026-10-04T15:42:07.318Z",
3359 "last_status": "delivered",
3360 "last_delivered_at": "2026-10-04T15:42:07.611Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3361 },
API reference: no example reads as a real secret3362 "secret": "whsec_…"
Merge branch 'worktree-agent-ab2e39e11a6493412'3363 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3364 "notes": "A ping is sent before the response, so `last_status` is usually set already. When g1t made the signing secret, `secret` holds it: it is shown only this once. See [webhooks](/guides/webhooks/)."
Merge branch 'worktree-agent-ab2e39e11a6493412'3365 },
3366 "create_webhook_for_workspace": {
3367 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3368 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'3369 },
3370 "request": {
3371 "url": "https://hooks.example.com/g1t"
3372 },
3373 "response": {
3374 "hook": {
3375 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3376 "scope": "workspace",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3377 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3378 "repo": null,
3379 "url": "https://hooks.example.com/g1t",
3380 "events": [
3381 "*"
3382 ],
3383 "active": true,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3384 "secret_hint": "…9c2e",
3385 "created_by": "syntaqx",
3386 "created_at": "2026-10-04T15:42:07.318Z",
3387 "last_status": "delivered",
3388 "last_delivered_at": "2026-10-04T15:42:07.611Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3389 },
API reference: no example reads as a real secret3390 "secret": "whsec_…"
Merge branch 'worktree-agent-ab2e39e11a6493412'3391 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3392 "notes": "A ping is sent before the response, so `last_status` is usually set already. When g1t made the signing secret, `secret` holds it: it is shown only this once. See [webhooks](/guides/webhooks/)."
Merge branch 'worktree-agent-ab2e39e11a6493412'3393 },
3394 "update_webhook": {
3395 "params": {
3396 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3397 },
3398 "request": {
3399 "active": false
3400 },
3401 "response": {
3402 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3403 "scope": "repo",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3404 "workspace": "flagon-io",
3405 "repo": "flagon-io/hello",
Merge branch 'worktree-agent-ab2e39e11a6493412'3406 "url": "https://hooks.example.com/g1t",
3407 "events": [
3408 "git.push",
3409 "pull.merged"
3410 ],
3411 "active": false,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3412 "secret_hint": "…9c2e",
3413 "created_by": "syntaqx",
3414 "created_at": "2026-10-04T15:42:07.318Z",
3415 "last_status": "delivered",
3416 "last_delivered_at": "2026-10-04T15:42:07.611Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3417 }
3418 },
3419 "update_webhook_for_workspace": {
3420 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3421 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3422 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3423 },
3424 "request": {
3425 "active": false
3426 },
3427 "response": {
3428 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3429 "scope": "workspace",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3430 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3431 "repo": null,
3432 "url": "https://hooks.example.com/g1t",
3433 "events": [
3434 "git.push",
3435 "pull.merged"
3436 ],
3437 "active": false,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3438 "secret_hint": "…9c2e",
3439 "created_by": "syntaqx",
3440 "created_at": "2026-10-04T15:42:07.318Z",
3441 "last_status": "delivered",
3442 "last_delivered_at": "2026-10-04T15:42:07.611Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3443 }
3444 },
3445 "delete_webhook": {
3446 "params": {
3447 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3448 },
3449 "response": true
3450 },
3451 "delete_webhook_for_workspace": {
3452 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3453 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3454 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3455 },
3456 "response": true
3457 },
3458 "ping_webhook": {
3459 "params": {
3460 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3461 },
3462 "response": {
3463 "id": "dlv_01kpx5p9v2j7k3m8n4p5q6r7st",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3464 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3465 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3466 "event": "ping",
3467 "status": "delivered",
3468 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3469 "response_status": 200,
3470 "response_body": "ok",
Merge branch 'worktree-agent-ab2e39e11a6493412'3471 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3472 "duration_ms": 184,
Merge branch 'worktree-agent-ab2e39e11a6493412'3473 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3474 "created_at": "2026-10-04T16:01:12.440Z",
3475 "delivered_at": "2026-10-04T16:01:12.631Z",
3476 "next_attempt_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'3477 },
3478 "notes": "`payload` is the JSON that was sent, as a string."
3479 },
3480 "ping_webhook_for_workspace": {
3481 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3482 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3483 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3484 },
3485 "response": {
3486 "id": "dlv_01kpx5p9v2j7k3m8n4p5q6r7st",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3487 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3488 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3489 "event": "ping",
3490 "status": "delivered",
3491 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3492 "response_status": 200,
3493 "response_body": "ok",
Merge branch 'worktree-agent-ab2e39e11a6493412'3494 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3495 "duration_ms": 184,
Merge branch 'worktree-agent-ab2e39e11a6493412'3496 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3497 "created_at": "2026-10-04T16:01:12.440Z",
3498 "delivered_at": "2026-10-04T16:01:12.631Z",
3499 "next_attempt_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'3500 }
3501 },
3502 "list_webhook_deliveries": {
3503 "params": {
3504 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3505 },
3506 "response": [
3507 {
3508 "id": "dlv_01kpx6a2b3c4d5e6f7g8h9j0kz",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3509 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3510 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3511 "event": "ping",
3512 "status": "pending",
3513 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3514 "response_status": 503,
3515 "response_body": "Service Unavailable",
Merge branch 'worktree-agent-ab2e39e11a6493412'3516 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3517 "duration_ms": 212,
Merge branch 'worktree-agent-ab2e39e11a6493412'3518 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3519 "created_at": "2026-10-04T16:20:03.100Z",
3520 "delivered_at": null,
3521 "next_attempt_at": "2026-10-04T16:21:03.312Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3522 },
3523 {
3524 "id": "dlv_01kpx5p9v2j7k3m8n4p5q6r7st",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3525 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3526 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3527 "event": "ping",
3528 "status": "delivered",
3529 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3530 "response_status": 200,
3531 "response_body": "ok",
Merge branch 'worktree-agent-ab2e39e11a6493412'3532 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3533 "duration_ms": 184,
Merge branch 'worktree-agent-ab2e39e11a6493412'3534 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3535 "created_at": "2026-10-04T16:01:12.440Z",
3536 "delivered_at": "2026-10-04T16:01:12.631Z",
3537 "next_attempt_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'3538 }
3539 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3540 "notes": "Returns at most 50, newest first. `status` is `pending`, `delivered` or `failed`; `next_attempt_at` is set while it is pending."
Merge branch 'worktree-agent-ab2e39e11a6493412'3541 },
3542 "list_webhook_deliveries_for_workspace": {
3543 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3544 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3545 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd"
3546 },
3547 "response": [
3548 {
3549 "id": "dlv_01kpx6a2b3c4d5e6f7g8h9j0kz",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3550 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3551 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3552 "event": "ping",
3553 "status": "pending",
3554 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3555 "response_status": 503,
3556 "response_body": "Service Unavailable",
Merge branch 'worktree-agent-ab2e39e11a6493412'3557 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3558 "duration_ms": 212,
Merge branch 'worktree-agent-ab2e39e11a6493412'3559 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3560 "created_at": "2026-10-04T16:20:03.100Z",
3561 "delivered_at": null,
3562 "next_attempt_at": "2026-10-04T16:21:03.312Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3563 },
3564 {
3565 "id": "dlv_01kpx5p9v2j7k3m8n4p5q6r7st",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3566 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3567 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3568 "event": "ping",
3569 "status": "delivered",
3570 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3571 "response_status": 200,
3572 "response_body": "ok",
Merge branch 'worktree-agent-ab2e39e11a6493412'3573 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3574 "duration_ms": 184,
Merge branch 'worktree-agent-ab2e39e11a6493412'3575 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3576 "created_at": "2026-10-04T16:01:12.440Z",
3577 "delivered_at": "2026-10-04T16:01:12.631Z",
3578 "next_attempt_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'3579 }
3580 ]
3581 },
3582 "redeliver_webhook": {
3583 "params": {
3584 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3585 "delivery": "dlv_01kpx6a2b3c4d5e6f7g8h9j0kz"
3586 },
3587 "response": {
3588 "id": "dlv_01kpx6c8d1e2f3g4h5j6k7m8np",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3589 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3590 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3591 "event": "ping",
3592 "status": "delivered",
3593 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3594 "response_status": 200,
3595 "response_body": "ok",
Merge branch 'worktree-agent-ab2e39e11a6493412'3596 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3597 "duration_ms": 171,
Merge branch 'worktree-agent-ab2e39e11a6493412'3598 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3599 "created_at": "2026-10-04T16:25:40.007Z",
3600 "delivered_at": "2026-10-04T16:25:40.178Z",
3601 "next_attempt_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'3602 },
3603 "notes": "The response is the new delivery."
3604 },
3605 "redeliver_webhook_for_workspace": {
3606 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3607 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3608 "id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3609 "delivery": "dlv_01kpx6a2b3c4d5e6f7g8h9j0kz"
3610 },
3611 "response": {
3612 "id": "dlv_01kpx6c8d1e2f3g4h5j6k7m8np",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3613 "hook_id": "hk_01kpx5p9s4h0t1w6x8y2a3b4cd",
3614 "event_id": "",
Merge branch 'worktree-agent-ab2e39e11a6493412'3615 "event": "ping",
3616 "status": "delivered",
3617 "attempts": 1,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3618 "response_status": 200,
3619 "response_body": "ok",
Merge branch 'worktree-agent-ab2e39e11a6493412'3620 "error": null,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3621 "duration_ms": 171,
Merge branch 'worktree-agent-ab2e39e11a6493412'3622 "payload": "{\"hook\":{\"events\":[\"git.push\",\"pull.merged\"],\"id\":\"hk_01kpx5p9s4h0t1w6x8y2a3b4cd\",\"url\":\"https://hooks.example.com/g1t\"},\"message\":\"g1t will send this webhook's events here.\",\"time\":\"2026-10-04T16:01:12.440Z\",\"type\":\"ping\"}",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3623 "created_at": "2026-10-04T16:25:40.007Z",
3624 "delivered_at": "2026-10-04T16:25:40.178Z",
3625 "next_attempt_at": null
Merge branch 'worktree-agent-ab2e39e11a6493412'3626 }
3627 },
3628 "list_integrations": {
3629 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3630 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'3631 },
3632 "response": [
3633 {
3634 "id": "con_01kpx3m7q2f8r9t4v6w0y1z2ab",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3635 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3636 "provider": "anthropic",
3637 "kind": "models",
3638 "name": "Anthropic",
3639 "config": {
3640 "assign": false,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3641 "write_back": true
Merge branch 'worktree-agent-ab2e39e11a6493412'3642 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3643 "secret_hint": "…3f9a",
3644 "webhook_url": null,
3645 "created_by": "syntaqx",
3646 "created_at": "2026-10-04T15:42:07.318Z",
3647 "last_used_at": "2026-10-04T15:42:08.102Z",
3648 "last_error": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'3649 "models": [
3650 "claude-haiku-4-5",
3651 "claude-sonnet-4-5"
3652 ]
3653 },
3654 {
3655 "id": "con_01kpx4n8r3g9s0v5w7x1z2a3bc",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3656 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3657 "provider": "jira",
3658 "kind": "tracker",
3659 "name": "Jira",
3660 "config": {
3661 "assign": false,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3662 "write_back": true,
Merge branch 'worktree-agent-ab2e39e11a6493412'3663 "site": "https://acme.atlassian.net",
3664 "email": "syntaqx@example.com",
3665 "keys": [
3666 "TECH"
3667 ]
3668 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3669 "secret_hint": "…x7Qe",
3670 "webhook_url": null,
3671 "created_by": "syntaqx",
3672 "created_at": "2026-10-04T15:42:07.318Z",
3673 "last_used_at": null,
3674 "last_error": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'3675 "models": []
3676 }
3677 ],
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3678 "notes": "`kind` is `models`, `alerts` or `tracker`. `secret_hint` shows the end of the secret; the secret itself is never returned. `webhook_url` is where an alert source sends its alerts."
Merge branch 'worktree-agent-ab2e39e11a6493412'3679 },
3680 "connect_integration": {
3681 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3682 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'3683 },
3684 "request": {
3685 "provider": "webhook",
3686 "config": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3687 "repo": "flagon-io/hello",
Merge branch 'worktree-agent-ab2e39e11a6493412'3688 "label": "bug"
3689 }
3690 },
3691 "response": {
3692 "connection": {
3693 "id": "con_01kpx4n8r3g9s0v5w7x1z2a3bd",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3694 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3695 "provider": "webhook",
3696 "kind": "alerts",
3697 "name": "Webhook",
3698 "config": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3699 "repo": "flagon-io/hello",
Merge branch 'worktree-agent-ab2e39e11a6493412'3700 "label": "bug",
3701 "assign": false,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3702 "write_back": true
Merge branch 'worktree-agent-ab2e39e11a6493412'3703 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3704 "secret_hint": null,
3705 "webhook_url": "https://api.g1t.sh/hooks/con_01kpx4n8r3g9s0v5w7x1z2a3bd",
3706 "created_by": "syntaqx",
3707 "created_at": "2026-10-04T15:42:07.318Z",
3708 "last_used_at": null,
3709 "last_error": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'3710 "models": []
3711 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3712 "signing_secret": "g1ts_9f2c4a7e1b0d3c6f8a2e5b7d9c1f4a6e8b0d2c4f6a8e1b3d"
Merge branch 'worktree-agent-ab2e39e11a6493412'3713 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3714 "notes": "`signing_secret` is set only when g1t made it, for `datadog` and `webhook`, and is shown only this once. A model provider is tested as it is connected. See [integrations](/guides/integrations/) and [model providers](/guides/models/)."
Merge branch 'worktree-agent-ab2e39e11a6493412'3715 },
3716 "disconnect_integration": {
3717 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3718 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3719 "id": "con_01kpx3m7q2f8r9t4v6w0y1z2ab"
3720 },
3721 "response": true
3722 },
3723 "test_integration": {
3724 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3725 "workspace": "flagon-io",
Merge branch 'worktree-agent-ab2e39e11a6493412'3726 "id": "con_01kpx3m7q2f8r9t4v6w0y1z2ab"
3727 },
3728 "response": {
3729 "ok": true,
3730 "message": "Anthropic accepted the key and offers 9 models."
3731 },
3732 "notes": "Credentials that do not work still answer `200`, with `ok` false and `message` saying what went wrong."
3733 },
3734 "get_model_routes": {
3735 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3736 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'3737 },
3738 "response": [
3739 {
3740 "task": "default",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3741 "connection_id": "con_01kpx3m7q2f8r9t4v6w0y1z2ab",
Merge branch 'worktree-agent-ab2e39e11a6493412'3742 "model": "claude-sonnet-4-5"
3743 },
3744 {
3745 "task": "review",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3746 "connection_id": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'3747 "model": null
3748 }
3749 ]
3750 },
3751 "set_model_routes": {
3752 "params": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3753 "workspace": "flagon-io"
Merge branch 'worktree-agent-ab2e39e11a6493412'3754 },
3755 "request": {
3756 "routes": [
3757 {
3758 "task": "default",
3759 "connection_id": "con_01kpx3m7q2f8r9t4v6w0y1z2ab",
3760 "model": "claude-sonnet-4-5"
3761 },
3762 {
3763 "task": "review",
3764 "connection_id": null
3765 }
3766 ]
3767 },
3768 "response": [
3769 {
3770 "task": "default",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3771 "connection_id": "con_01kpx3m7q2f8r9t4v6w0y1z2ab",
Merge branch 'worktree-agent-ab2e39e11a6493412'3772 "model": "claude-sonnet-4-5"
3773 },
3774 {
3775 "task": "review",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3776 "connection_id": null,
Merge branch 'worktree-agent-ab2e39e11a6493412'3777 "model": null
3778 }
3779 ],
3780 "notes": "The response is the routes as saved, ordered by task."
3781 },
3782 "get_context": {
3783 "query": {
3784 "reference": "TECH-1234"
3785 },
3786 "response": {
3787 "provider": "jira",
3788 "key": "TECH-1234",
3789 "title": "Checkout fails for EU cards",
3790 "url": "https://acme.atlassian.net/browse/TECH-1234",
3791 "status": "In Progress",
3792 "body": "Customers with 3DS cards see a 500 at /pay.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3793 "fetched_at": "2026-10-04T15:42:07.318Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3794 }
3795 },
3796 "import_issue": {
3797 "request": {
3798 "reference": "TECH-1234"
3799 },
3800 "response": {
3801 "number": 42,
3802 "item": {
3803 "provider": "jira",
3804 "key": "TECH-1234",
3805 "title": "Checkout fails for EU cards",
3806 "url": "https://acme.atlassian.net/browse/TECH-1234",
3807 "status": "In Progress",
3808 "body": "Customers with 3DS cards see a 500 at /pay.",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3809 "fetched_at": "2026-10-04T15:42:07.318Z"
Merge branch 'worktree-agent-ab2e39e11a6493412'3810 },
3811 "created": true
3812 },
3813 "notes": "`created` is false when the ticket was imported before; `number` is then that issue."
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3814 },
3815 "remember": {
3816 "request": {
3817 "text": "The tests need TZ=UTC or the date tests fail.",
3818 "scope": "project",
3819 "kind": "gotcha",
3820 "from_number": 14
3821 },
3822 "response": {
3823 "id": "mem_01m43v8q2w3e4r5t6y7u8i9o0p",
3824 "scope": "project",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3825 "workspace": "flagon-io",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3826 "repo": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3827 "namespace": "flagon-io",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3828 "name": "hello"
3829 },
3830 "text": "The tests need TZ=UTC or the date tests fail.",
3831 "kind": "gotcha",
3832 "source": {
3833 "kind": "run",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3834 "run_id": "arn_01m43v2c1p9k8d7e6f5a4b3c2d",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3835 "repo": {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3836 "namespace": "flagon-io",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3837 "name": "hello"
3838 },
3839 "number": 14
3840 },
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent3841 "created_by": "g1t",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3842 "pinned": false,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3843 "created_at": "2026-10-01T18:40:12.000Z",
3844 "updated_at": "2026-10-01T18:40:12.000Z",
3845 "last_used_at": null
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3846 },
3847 "notes": "Text that looks like a key, a token or a password is refused with `invalid`: memory is read by every agent in the workspace. Saving the same text again in the same scope returns the memory already kept."
3848 },
3849 "recall": {
3850 "query": {
3851 "q": "pnpm"
3852 },
3853 "response": {
3854 "project": [],
3855 "workspace": [
3856 {
3857 "id": "mem_01m43t0a1s2d3f4g5h6j7k8l9z",
3858 "scope": "workspace",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3859 "workspace": "flagon-io",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3860 "repo": null,
3861 "text": "We use pnpm everywhere, never npm or yarn.",
3862 "kind": "convention",
3863 "source": {
3864 "kind": "person",
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3865 "run_id": null,
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3866 "repo": null,
3867 "number": null
3868 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3869 "created_by": "syntaqx",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3870 "pinned": true,
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3871 "created_at": "2026-10-01T18:40:12.000Z",
3872 "updated_at": "2026-10-01T18:40:12.000Z",
3873 "last_used_at": null
Agents and memory, checks and conflicts, profiles, slug renames, custom domains3874 }
3875 ]
3876 },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look3877 "notes": "Anyone who can read the repository gets its project memory; `workspace` is filled only for members of the workspace, and is empty for anyone else. Each memory returned is marked used, which keeps it near the front of what agents are given."
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3878 },
Search across all of g1t, Explore, and a command palette3879 "search": {
3880 "query": {
3881 "q": "parse_query language:rust repo:acme/web",
3882 "type": "code"
3883 },
3884 "response": {
3885 "query": "parse_query repo:acme/web language:rust",
3886 "type": "code",
3887 "counts": {
3888 "repositories": 0,
3889 "code": 2,
3890 "issues": 0,
3891 "pulls": 0,
3892 "people": 0
3893 },
3894 "page": 1,
3895 "per_page": 20,
3896 "more": false,
3897 "hits": [
3898 {
3899 "kind": "code",
3900 "title": "src/search/query.rs",
3901 "url": "/acme/web/blob/main/src/search/query.rs#L42",
3902 "repo": "acme/web",
3903 "private": false,
3904 "description": null,
3905 "snippet": [],
3906 "lines": [
3907 {
3908 "number": 41,
3909 "parts": [
3910 {
3911 "text": "/// Reads a query typed into the search box.",
3912 "highlight": false
3913 }
3914 ]
3915 },
3916 {
3917 "number": 42,
3918 "parts": [
3919 {
3920 "text": "pub fn ",
3921 "highlight": false
3922 },
3923 {
3924 "text": "parse_query",
3925 "highlight": true
3926 },
3927 {
3928 "text": "(text: &str) -> Query {",
3929 "highlight": false
3930 }
3931 ]
3932 },
3933 {
3934 "number": 43,
3935 "parts": [
3936 {
3937 "text": " let mut query = Query::default();",
3938 "highlight": false
3939 }
3940 ]
3941 }
3942 ],
3943 "path": "src/search/query.rs",
3944 "language": "rust",
3945 "ref": "main",
3946 "number": null,
3947 "state": null,
3948 "author": null,
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights3949 "requested_by": null,
Search across all of g1t, Explore, and a command palette3950 "labels": [],
3951 "topics": [],
3952 "slug": null,
3953 "avatar": null,
3954 "updated_at": null
3955 }
3956 ],
3957 "notes": []
3958 },
g1t is the stored author of what it opens; the person who asked is requested_by and keeps the author's rights3959 "notes": "`q` takes words, `\"exact phrases\"`, `-words` to leave out, and qualifiers: `repo:owner/name`, `org:` (or `workspace:`), `language:`, `path:` (a glob when it has `*`), `is:issue`, `is:pr`, `is:open`, `is:closed`, `is:merged`, `is:draft`, `is:public`, `is:private`, `author:` and `label:`; most can be left out with a leading `-`, as in `-label:wontfix`. `type` is `repositories`, `code`, `issues`, `pulls` or `people`; without it, `path:` means code, `is:pr` pull requests, `is:open`, `author:` or `label:` issues, and anything else repositories. `counts` says how many results each type has, up to 1,000. Each result's `snippet` (or, for code, each of its `lines`) is a list of parts, `highlight` true where the query matched. Code is searched on default branches and needs a word of three characters or more, unless the query names a `repo:`. Public content is returned to anyone, without a token; private content only to people who can read it (members of its workspace, and people given a role on the repository), checked when the search runs, so a repository made private, or a role taken away, stops appearing at once. A g1t agent's token can search too. An issue or pull request g1t opened has `author` `g1t` and `requested_by` the person it was for; `author:` matches the author."
Search across all of g1t, Explore, and a command palette3960 },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API3961 "search_context": {
3962 "params": {
3963 "workspace": "acme"
3964 },
3965 "query": {
3966 "q": "how do we run the web tests",
3967 "project": "web"
3968 },
3969 "response": {
3970 "query": "how do we run the web tests",
3971 "mode": "semantic",
3972 "hits": [
3973 {
3974 "kind": "memory",
3975 "id": "mem_01m4a0c2b7k3f9d1e5g8h2j6k4",
3976 "title": "Gotcha",
3977 "snippet": "The date tests fail unless TZ=UTC.",
3978 "project": "web",
3979 "url": "/acme/web/memory",
3980 "score": 0.82,
3981 "source": "AGENTS.md",
3982 "by": "g1t",
3983 "updated_at": "2026-10-04T21:10:02.000Z"
3984 },
3985 {
3986 "kind": "doc",
3987 "id": "ent_5f0c2a9e41d7b3c86a1e2f40:2",
3988 "title": "Web (README.md)",
3989 "snippet": "## Testing Run npm test. The end-to-end tests need the api running locally…",
3990 "project": "web",
3991 "url": "/acme/web/blob/main/README.md",
3992 "score": 0.77,
3993 "source": "README.md",
3994 "by": null,
3995 "updated_at": "2026-10-04T20:58:41.000Z"
3996 },
3997 {
3998 "kind": "project",
3999 "id": "ent_9b1d6f0a2c3e4b5d6e7f8a9b",
4000 "title": "web",
4001 "snippet": "The storefront. Written in TypeScript. Packages: @acme/web. Uses api. Owned by ana.",
4002 "project": "web",
4003 "url": "/acme/web",
4004 "score": 0.71,
4005 "source": "catalog",
4006 "by": null,
4007 "updated_at": "2026-10-04T20:58:41.000Z"
4008 }
4009 ]
4010 },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look4011 "notes": "Give `workspace`, or `repo` as `owner/name` for its workspace. `kinds` narrows to some of `project`, `app`, `api`, `package`, `language`, `owner`, `environment`, `integration`, `doc`, `memory`, `issue` and `pull`; in a URL, comma-separated. `mode` is `text` when the search index could not answer and words were matched instead. Memory is returned only to members of the workspace and its agents; anything from a private project, only to those who can read it (members, unless the base permission is None, and people given a role on its repository). A g1t agent searches its own workspace only."
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API4012 },
4013 "get_entity": {
4014 "params": {
4015 "workspace": "acme",
4016 "kind": "project",
4017 "id": "web"
4018 },
4019 "response": {
4020 "entity": {
4021 "id": "ent_9b1d6f0a2c3e4b5d6e7f8a9b",
4022 "workspace": "acme",
4023 "kind": "project",
4024 "key": "web",
4025 "name": "web",
4026 "summary": "The storefront. Written in TypeScript. Packages: @acme/web. Uses api. Owned by ana.",
4027 "project": "web",
4028 "private": true,
4029 "data": {
4030 "repo": "acme/web",
4031 "root_dir": "",
4032 "default_branch": "main",
4033 "languages": [
4034 "TypeScript"
4035 ],
4036 "owners": [
4037 "ana"
4038 ],
4039 "tests": true,
4040 "test_commands": [
4041 "npm test"
4042 ],
4043 "production_url": "https://web--acme.g1t.page"
4044 },
4045 "source": "scan",
4046 "ref": "/acme/web",
4047 "updated_at": "2026-10-04T20:58:41.000Z"
4048 },
4049 "relations": [
4050 {
4051 "kind": "depends_on",
4052 "direction": "out",
4053 "entity": {
4054 "id": "ent_0a7c3e5b9d1f2a4c6e8b0d2f",
4055 "workspace": "acme",
4056 "kind": "project",
4057 "key": "api",
4058 "name": "api",
4059 "summary": "The public API. Written in Rust.",
4060 "project": "api",
4061 "private": true,
4062 "data": {},
4063 "source": "scan",
4064 "ref": "/acme/api",
4065 "updated_at": "2026-10-04T20:57:12.000Z"
4066 }
4067 },
4068 {
4069 "kind": "owned_by",
4070 "direction": "out",
4071 "entity": {
4072 "id": "ent_3c5e7a9b1d2f4a6c8e0b2d4f",
4073 "workspace": "acme",
4074 "kind": "owner",
4075 "key": "ana",
4076 "name": "ana",
4077 "summary": null,
4078 "project": null,
4079 "private": false,
4080 "data": {},
4081 "source": "scan",
4082 "ref": "/u/ana",
4083 "updated_at": "2026-10-04T20:58:41.000Z"
4084 }
4085 }
4086 ]
4087 },
4088 "notes": "`id` is the entry's id, or its key: a project's or app's slug, `npm:<name>` (or `cargo:`, `go:`, `pypi:`) for a package, a username for an owner, `<project>/production` for an environment. `data` depends on the kind: a package's version and dependencies, an API's routes, an app's production address."
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look4089 },
4090 "list_collaborators": {
4091 "response": {
4092 "repo": "flagon-io/hello",
4093 "base_permission": "write",
4094 "people": [
4095 {
4096 "username": "syntaqx",
4097 "name": "Chase Pierce",
4098 "avatar": null,
4099 "role": "admin",
4100 "source": "owner",
4101 "direct": null,
4102 "workspace_role": "owner"
4103 },
4104 {
4105 "username": "linus",
4106 "name": null,
4107 "avatar": null,
4108 "role": "maintain",
4109 "source": "direct",
4110 "direct": "maintain",
4111 "workspace_role": "member"
4112 },
4113 {
4114 "username": "grace",
4115 "name": "Grace Hopper",
4116 "avatar": null,
4117 "role": "write",
4118 "source": "base",
4119 "direct": null,
4120 "workspace_role": "member"
4121 },
4122 {
4123 "username": "ada",
4124 "name": "Ada Lovelace",
4125 "avatar": null,
4126 "role": "triage",
4127 "source": "direct",
4128 "direct": "triage",
4129 "workspace_role": null
4130 }
4131 ],
4132 "invitations": [
4133 {
4134 "id": "rin_01kp3c4d5e6f7g8h9j0k1m2n3p",
4135 "repo": "flagon-io/hello",
4136 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4137 "invitee": "alan",
4138 "email": null,
4139 "role": "write",
4140 "invited_by": "syntaqx",
4141 "inviter_avatar": null,
4142 "status": "pending",
4143 "created_at": "2026-10-05T17:00:00.000Z",
4144 "expires_at": "2026-10-12T17:00:00.000Z"
4145 },
4146 {
4147 "id": "rin_01kp3d7e8f9g0h1j2k3m4n5p6q",
4148 "repo": "flagon-io/hello",
4149 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4150 "invitee": null,
4151 "email": "joan@example.com",
4152 "role": "read",
4153 "invited_by": "syntaqx",
4154 "inviter_avatar": null,
4155 "status": "pending",
4156 "created_at": "2026-10-05T17:00:00.000Z",
4157 "expires_at": "2026-10-12T17:00:00.000Z"
4158 }
4159 ],
4160 "viewer_role": "admin",
4161 "can_manage": true
4162 },
4163 "notes": "Owners are listed with `source` `owner`, members with the base permission with `base`, and anyone given a role on this repository with `direct`; `role` is the highest of these, and `direct` shows a direct role even when ownership or the base permission gives more. `workspace_role` null means an outside collaborator. Anyone can read a public repository, which is not listed. `invitations` is empty unless you have the Admin role (`can_manage`). Refused with `403` below the Write role, and `404` for a private repository you cannot see. See [Access and roles](/guides/access-and-roles/)."
4164 },
4165 "add_collaborator": {
4166 "request": {
4167 "invitee": "ada",
4168 "role": "triage"
4169 },
4170 "response": {
4171 "result": "invited",
4172 "invitation": {
4173 "id": "rin_01kp3e9f0g1h2j3k4m5n6p7q8r",
4174 "repo": "flagon-io/hello",
4175 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4176 "invitee": "ada",
4177 "email": null,
4178 "role": "triage",
4179 "invited_by": "syntaqx",
4180 "inviter_avatar": null,
4181 "status": "pending",
4182 "created_at": "2026-10-05T17:00:00.000Z",
4183 "expires_at": "2026-10-12T17:00:00.000Z"
4184 }
4185 },
4186 "notes": "`invitee` is a username or an email address. A member of the workspace answers `{\"result\": \"granted\", \"collaborator\": {…}}` with the role already given, shown as list_collaborators shows a person. Anyone else answers `{\"result\": \"invited\", \"invitation\": {…}}`: the invitation is emailed and waits 7 days, and the role is theirs once they accept it. An email address without an account gets an invitation with `email` set and `invitee` null, and an invite that makes the account and accepts in one step. Refused with `404` when no account has that username, `409` when they already have a role of their own or a pending invitation (change it with update_collaborator), and `403` without the Admin role, from an agent's or a workspace's token, or when the person does not meet what the workspace asks of everyone with access. The `repo.collaborator_added` webhook event is sent once they have the role. See [Access and roles](/guides/access-and-roles/)."
4187 },
4188 "update_collaborator": {
4189 "params": {
4190 "owner": "flagon-io",
4191 "name": "hello",
4192 "username": "ada"
4193 },
4194 "request": {
4195 "role": "write"
4196 },
4197 "response": {
4198 "username": "ada",
4199 "name": "Ada Lovelace",
4200 "avatar": null,
4201 "role": "write",
4202 "source": "direct",
4203 "direct": "write",
4204 "workspace_role": null
4205 },
4206 "notes": "Changes a direct role, or the role of the person's pending invitation. `404` when they have neither: an owner's Admin and a member's base permission are not changed here. Changing a direct role sends the `repo.collaborator_role_changed` webhook event. See [Access and roles](/guides/access-and-roles/)."
4207 },
4208 "remove_collaborator": {
4209 "params": {
4210 "owner": "flagon-io",
4211 "name": "hello",
4212 "username": "ada"
4213 },
4214 "response": true,
4215 "notes": "Takes away a direct role. Anyone may remove their own, to leave a repository. `404` when the person has no role of their own on it. A member keeps the workspace's base permission. Sends the `repo.collaborator_removed` webhook event. See [Access and roles](/guides/access-and-roles/)."
4216 },
4217 "get_collaborator_permission": {
4218 "params": {
4219 "owner": "flagon-io",
4220 "name": "hello",
4221 "username": "ada"
4222 },
4223 "response": {
4224 "username": "ada",
4225 "role": "triage",
4226 "source": "direct",
4227 "capabilities": [
4228 "read",
4229 "participate",
4230 "triage"
4231 ]
4232 },
4233 "notes": "`capabilities` lists what the role allows, in the table's order: `read`, `participate`, `triage`, `push`, `merge`, `run`, `manage_settings`, `manage_protection`, `manage_integrations`, `manage_access`, `administer` and `delete` (which also takes an owner of the workspace). `role` and `source` are null, and `capabilities` empty, for someone with no role. Refused with `403` below the Write role, unless you ask about yourself. See [Access and roles](/guides/access-and-roles/)."
4234 },
4235 "list_repo_invitations": {
4236 "response": [
4237 {
4238 "id": "rin_01kp3c4d5e6f7g8h9j0k1m2n3p",
4239 "repo": "flagon-io/hello",
4240 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4241 "invitee": "alan",
4242 "email": null,
4243 "role": "write",
4244 "invited_by": "syntaqx",
4245 "inviter_avatar": null,
4246 "status": "pending",
4247 "created_at": "2026-10-05T17:00:00.000Z",
4248 "expires_at": "2026-10-12T17:00:00.000Z"
4249 },
4250 {
4251 "id": "rin_01kp3d7e8f9g0h1j2k3m4n5p6q",
4252 "repo": "flagon-io/hello",
4253 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4254 "invitee": null,
4255 "email": "joan@example.com",
4256 "role": "read",
4257 "invited_by": "syntaqx",
4258 "inviter_avatar": null,
4259 "status": "pending",
4260 "created_at": "2026-10-05T17:00:00.000Z",
4261 "expires_at": "2026-10-12T17:00:00.000Z"
4262 }
4263 ],
4264 "notes": "Pending invitations only, newest first. `email` is set for an invitation sent to an address that had no account. Refused with `403` without the Admin role. See [Access and roles](/guides/access-and-roles/)."
4265 },
4266 "revoke_repo_invitation": {
4267 "params": {
4268 "owner": "flagon-io",
4269 "name": "hello",
4270 "id": "rin_01kp3c4d5e6f7g8h9j0k1m2n3p"
4271 },
4272 "response": {
4273 "id": "rin_01kp3c4d5e6f7g8h9j0k1m2n3p",
4274 "repo": "flagon-io/hello",
4275 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4276 "invitee": "alan",
4277 "email": null,
4278 "role": "write",
4279 "invited_by": "syntaqx",
4280 "inviter_avatar": null,
4281 "status": "revoked",
4282 "created_at": "2026-10-05T17:00:00.000Z",
4283 "expires_at": "2026-10-12T17:00:00.000Z"
4284 },
4285 "notes": "`404` when there is no pending invitation with that id on this repository."
4286 },
4287 "list_my_repo_invitations": {
4288 "response": [
4289 {
4290 "id": "rin_01kp3e9f0g1h2j3k4m5n6p7q8r",
4291 "repo": "flagon-io/hello",
4292 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4293 "invitee": "ada",
4294 "email": null,
4295 "role": "triage",
4296 "invited_by": "syntaqx",
4297 "inviter_avatar": null,
4298 "status": "pending",
4299 "created_at": "2026-10-05T17:00:00.000Z",
4300 "expires_at": "2026-10-12T17:00:00.000Z"
4301 }
4302 ],
4303 "notes": "Invitations sent to your username, and to any of your confirmed addresses before you had an account, newest first. Accept one with `PATCH /user/repository_invitations/{id}`, or decline it with `DELETE`. Expired and answered ones are left out."
4304 },
4305 "accept_repo_invitation": {
4306 "params": {
4307 "id": "rin_01kp3e9f0g1h2j3k4m5n6p7q8r"
4308 },
4309 "response": {
4310 "id": "rin_01kp3e9f0g1h2j3k4m5n6p7q8r",
4311 "repo": "flagon-io/hello",
4312 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4313 "invitee": "ada",
4314 "email": null,
4315 "role": "triage",
4316 "invited_by": "syntaqx",
4317 "inviter_avatar": null,
4318 "status": "accepted",
4319 "created_at": "2026-10-05T17:00:00.000Z",
4320 "expires_at": "2026-10-12T17:00:00.000Z"
4321 },
4322 "notes": "The role is yours at once. `404` when you have no pending invitation with that id (it may have expired or been revoked), and `403` when your account does not meet what the workspace asks of everyone with access, such as two-factor authentication, with a message that says what to turn on. See [Access and roles](/guides/access-and-roles/)."
4323 },
4324 "decline_repo_invitation": {
4325 "params": {
4326 "id": "rin_01kp3e9f0g1h2j3k4m5n6p7q8r"
4327 },
4328 "response": {
4329 "id": "rin_01kp3e9f0g1h2j3k4m5n6p7q8r",
4330 "repo": "flagon-io/hello",
4331 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4332 "invitee": "ada",
4333 "email": null,
4334 "role": "triage",
4335 "invited_by": "syntaqx",
4336 "inviter_avatar": null,
4337 "status": "declined",
4338 "created_at": "2026-10-05T17:00:00.000Z",
4339 "expires_at": "2026-10-12T17:00:00.000Z"
4340 },
4341 "notes": "`404` when you have no pending invitation with that id."
4342 },
4343 "set_base_permission": {
4344 "params": {
4345 "workspace": "flagon-io"
4346 },
4347 "request": {
4348 "base_permission": "read"
4349 },
4350 "response": {
4351 "workspace": "flagon-io",
4352 "base_permission": "read"
4353 },
4354 "notes": "`base_permission` is `none`, `read`, `write` (the default) or `admin`. Owners keep Admin, and a role given on a repository directly still counts where it is higher. Refused with `403` for anyone but an owner signed in as a person. See [Access and roles](/guides/access-and-roles/)."
4355 },
4356 "list_outside_collaborators": {
4357 "params": {
4358 "workspace": "flagon-io"
4359 },
4360 "response": [
4361 {
4362 "username": "ada",
4363 "name": "Ada Lovelace",
4364 "avatar": null,
4365 "repos": [
4366 {
4367 "repo": "flagon-io/docs",
4368 "role": "write"
4369 },
4370 {
4371 "repo": "flagon-io/hello",
4372 "role": "triage"
4373 }
4374 ]
4375 }
4376 ],
4377 "notes": "By username, each with the repositories they have a role on. Refused with `403` for anyone but an owner. See [Access and roles](/guides/access-and-roles/)."
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily4378 },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar4379 "list_teams": {
4380 "params": {
4381 "workspace": "flagon-io"
4382 },
4383 "query": {
4384 "q": "back"
4385 },
4386 "response": [
4387 {
4388 "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
4389 "workspace": "flagon-io",
4390 "slug": "backend",
4391 "name": "Backend",
4392 "description": "The API and the services behind it.",
4393 "visibility": "visible",
4394 "parent": {
4395 "slug": "engineering",
4396 "name": "Engineering"
4397 },
4398 "notify": true,
4399 "review_assignment": {
4400 "enabled": false,
4401 "algorithm": "round_robin",
4402 "count": 1,
4403 "skip_busy": false,
4404 "busy_at": 5,
4405 "include_child_teams": false,
4406 "excluded": [],
4407 "notify_team": false
4408 },
4409 "members_count": 4,
4410 "repos_count": 2,
4411 "child_teams_count": 1,
4412 "viewer_role": "maintainer",
4413 "can_manage": true,
4414 "created_at": "2026-10-06T15:02:11.480Z",
4415 "updated_at": "2026-10-06T15:02:11.480Z"
4416 }
4417 ],
4418 "notes": "Teams you are in come first, then the rest by name. A secret team is listed only for its own people and the workspace's owners. `review_assignment` is what happens when the team is asked to review: see [`set_team_review_assignment`](/reference/api/teams/set-team-review-assignment/). `403` for anyone who is not a member of the workspace. See [Teams](/guides/teams/)."
4419 },
4420 "create_team": {
4421 "params": {
4422 "workspace": "flagon-io"
4423 },
4424 "request": {
4425 "name": "Backend",
4426 "description": "The API and the services behind it.",
4427 "visibility": "visible",
4428 "parent": "engineering",
4429 "members": [
4430 "ana"
4431 ]
4432 },
4433 "response": {
4434 "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
4435 "workspace": "flagon-io",
4436 "slug": "backend",
4437 "name": "Backend",
4438 "description": "The API and the services behind it.",
4439 "visibility": "visible",
4440 "parent": {
4441 "slug": "engineering",
4442 "name": "Engineering"
4443 },
4444 "notify": true,
4445 "review_assignment": {
4446 "enabled": false,
4447 "algorithm": "round_robin",
4448 "count": 1,
4449 "skip_busy": false,
4450 "busy_at": 5,
4451 "include_child_teams": false,
4452 "excluded": [],
4453 "notify_team": false
4454 },
4455 "members_count": 2,
4456 "repos_count": 0,
4457 "child_teams_count": 0,
4458 "viewer_role": "maintainer",
4459 "can_manage": true,
4460 "created_at": "2026-10-06T15:02:11.480Z",
4461 "updated_at": "2026-10-06T15:02:11.480Z"
4462 },
Owners choose who can create teams4463 "notes": "You become the team's maintainer. Refused with `403` for a member when the workspace's `team_creation` is `owners`. `slug` is made from `name` when left out (`Web & Mobile` becomes `web-mobile`), and `409` says one is taken. A workspace has at most 500 teams, nested at most 8 deep; `name` is at most 80 characters and `description` 280. A `secret` team cannot have a parent or child teams. Refused with `403` for an agent's or a workspace's token. See [Teams](/guides/teams/)."
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar4464 },
4465 "get_team": {
4466 "params": {
4467 "workspace": "flagon-io",
4468 "team": "backend"
4469 },
4470 "response": {
4471 "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
4472 "workspace": "flagon-io",
4473 "slug": "backend",
4474 "name": "Backend",
4475 "description": "The API and the services behind it.",
4476 "visibility": "visible",
4477 "parent": {
4478 "slug": "engineering",
4479 "name": "Engineering"
4480 },
4481 "notify": true,
4482 "review_assignment": {
4483 "enabled": false,
4484 "algorithm": "round_robin",
4485 "count": 1,
4486 "skip_busy": false,
4487 "busy_at": 5,
4488 "include_child_teams": false,
4489 "excluded": [],
4490 "notify_team": false
4491 },
4492 "members_count": 4,
4493 "repos_count": 2,
4494 "child_teams_count": 1,
4495 "viewer_role": "maintainer",
4496 "can_manage": true,
4497 "created_at": "2026-10-06T15:02:11.480Z",
4498 "updated_at": "2026-10-06T15:02:11.480Z"
4499 },
4500 "notes": "`404` for a team that does not exist, or a secret one you are not in, unless you are an owner."
4501 },
4502 "update_team": {
4503 "params": {
4504 "workspace": "flagon-io",
4505 "team": "backend"
4506 },
4507 "request": {
4508 "description": "The API, the services behind it, and their on-call.",
4509 "visibility": "secret",
4510 "parent": ""
4511 },
4512 "response": {
4513 "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
4514 "workspace": "flagon-io",
4515 "slug": "backend",
4516 "name": "Backend",
4517 "description": "The API, the services behind it, and their on-call.",
4518 "visibility": "secret",
4519 "parent": null,
4520 "notify": true,
4521 "review_assignment": {
4522 "enabled": false,
4523 "algorithm": "round_robin",
4524 "count": 1,
4525 "skip_busy": false,
4526 "busy_at": 5,
4527 "include_child_teams": false,
4528 "excluded": [],
4529 "notify_team": false
4530 },
4531 "members_count": 4,
4532 "repos_count": 2,
4533 "child_teams_count": 1,
4534 "viewer_role": "maintainer",
4535 "can_manage": true,
4536 "created_at": "2026-10-06T15:02:11.480Z",
4537 "updated_at": "2026-10-07T09:41:52.006Z"
4538 },
4539 "notes": "Only the fields given change. `parent` set to `\"\"` takes the team out from under its parent; a team cannot be nested under itself or one of its own child teams. A new `slug` changes how it is mentioned: `@flagon-io/backend` no longer reaches it. `review_assignment` takes the fields [`set_team_review_assignment`](/reference/api/teams/set-team-review-assignment/) does. Owners of the workspace and the team's maintainers (`403` otherwise)."
4540 },
4541 "delete_team": {
4542 "params": {
4543 "workspace": "flagon-io",
4544 "team": "backend"
4545 },
4546 "response": true,
4547 "notes": "Its child teams move up to its parent, or to the top when it has none. The roles it gave on repositories are taken away, and it is no longer asked to review. Owners of the workspace and the team's maintainers (`403` otherwise)."
4548 },
4549 "list_team_members": {
4550 "params": {
4551 "workspace": "flagon-io",
4552 "team": "backend"
4553 },
4554 "query": {
4555 "include_child_teams": "true"
4556 },
4557 "response": [
4558 {
4559 "username": "syntaqx",
4560 "name": "Chase Pierce",
4561 "avatar": null,
4562 "role": "maintainer",
4563 "via": null
4564 },
4565 {
4566 "username": "ana",
4567 "name": "Ana Lima",
4568 "avatar": null,
4569 "role": "member",
4570 "via": null
4571 },
4572 {
4573 "username": "bo",
4574 "name": null,
4575 "avatar": null,
4576 "role": "member",
4577 "via": "payments"
4578 }
4579 ],
4580 "notes": "Maintainers come first, then members, each by username. With `include_child_teams`, the people of its child teams (and theirs) follow, each with `via`, the child team they are in; someone in both is listed once, as the team's own."
4581 },
4582 "set_team_member": {
4583 "params": {
4584 "workspace": "flagon-io",
4585 "team": "backend",
4586 "username": "ana"
4587 },
4588 "request": {
4589 "role": "maintainer"
4590 },
4591 "response": {
4592 "username": "ana",
4593 "name": "Ana Lima",
4594 "avatar": null,
4595 "role": "maintainer",
4596 "via": null
4597 },
4598 "notes": "`role` is `member` (the default) or `maintainer`. `422` when they are not a member of the workspace: add them to it first. Owners of the workspace and the team's maintainers (`403` otherwise)."
4599 },
4600 "remove_team_member": {
4601 "params": {
4602 "workspace": "flagon-io",
4603 "team": "backend",
4604 "username": "ana"
4605 },
4606 "response": true,
4607 "notes": "Anyone may take themselves out of a team. Leaving the workspace takes a person out of all its teams."
4608 },
4609 "list_child_teams": {
4610 "params": {
4611 "workspace": "flagon-io",
4612 "team": "engineering"
4613 },
4614 "response": [
4615 {
4616 "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
4617 "workspace": "flagon-io",
4618 "slug": "backend",
4619 "name": "Backend",
4620 "description": "The API and the services behind it.",
4621 "visibility": "visible",
4622 "parent": {
4623 "slug": "engineering",
4624 "name": "Engineering"
4625 },
4626 "notify": true,
4627 "review_assignment": {
4628 "enabled": false,
4629 "algorithm": "round_robin",
4630 "count": 1,
4631 "skip_busy": false,
4632 "busy_at": 5,
4633 "include_child_teams": false,
4634 "excluded": [],
4635 "notify_team": false
4636 },
4637 "members_count": 4,
4638 "repos_count": 2,
4639 "child_teams_count": 0,
4640 "viewer_role": "maintainer",
4641 "can_manage": true,
4642 "created_at": "2026-10-06T15:02:11.480Z",
4643 "updated_at": "2026-10-06T15:02:11.480Z"
4644 }
4645 ],
4646 "notes": "Only the teams directly under it; read each one's own with this again. A child team inherits its parent's roles on repositories, and a mention or review request for the parent reaches its people too."
4647 },
4648 "list_team_repos": {
4649 "params": {
4650 "workspace": "flagon-io",
4651 "team": "backend"
4652 },
4653 "response": [
4654 {
4655 "repo": "flagon-io/hello",
4656 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4657 "role": "write",
4658 "inherited_from": null
4659 },
4660 {
4661 "repo": "flagon-io/docs",
4662 "repo_id": "rep_01m3m5r2a8c4e6g8j0m2p4r6t8",
4663 "role": "read",
4664 "inherited_from": "engineering"
4665 }
4666 ],
4667 "notes": "A role inherited from a parent team names it in `inherited_from`. Where the team has a role of its own on the same repository, the higher one is listed. Only repositories you can see are listed."
4668 },
4669 "set_team_repo": {
4670 "params": {
4671 "workspace": "flagon-io",
4672 "team": "backend",
4673 "repo": "hello"
4674 },
4675 "request": {
4676 "role": "maintain"
4677 },
4678 "response": {
4679 "repo": "flagon-io/hello",
4680 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
4681 "role": "maintain",
4682 "inherited_from": null
4683 },
4684 "notes": "`repo` in the path is the repository's name in the team's workspace; a team has roles only on its own workspace's repositories. `role` is `read`, `triage`, `write`, `maintain` or `admin`. Everyone in the team and its child teams gets it; someone with a higher role otherwise keeps that. Needs the Admin role on the repository (`403` otherwise), and the `access:admin` scope. See [Access and roles](/guides/access-and-roles/)."
4685 },
4686 "remove_team_repo": {
4687 "params": {
4688 "workspace": "flagon-io",
4689 "team": "backend",
4690 "repo": "hello"
4691 },
4692 "response": true,
4693 "notes": "A role the team inherits from a parent is taken away on the parent. Needs the Admin role on the repository, or to be an owner or one of the team's maintainers."
4694 },
4695 "set_team_review_assignment": {
4696 "params": {
4697 "workspace": "flagon-io",
4698 "team": "backend"
4699 },
4700 "request": {
4701 "enabled": true,
4702 "algorithm": "load_balance",
4703 "count": 2,
4704 "skip_busy": true,
4705 "busy_at": 5,
4706 "excluded": [
4707 "syntaqx"
4708 ]
4709 },
4710 "response": {
4711 "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
4712 "workspace": "flagon-io",
4713 "slug": "backend",
4714 "name": "Backend",
4715 "description": "The API and the services behind it.",
4716 "visibility": "visible",
4717 "parent": {
4718 "slug": "engineering",
4719 "name": "Engineering"
4720 },
4721 "notify": true,
4722 "review_assignment": {
4723 "enabled": true,
4724 "algorithm": "load_balance",
4725 "count": 2,
4726 "skip_busy": true,
4727 "busy_at": 5,
4728 "include_child_teams": false,
4729 "excluded": [
4730 "syntaqx"
4731 ],
4732 "notify_team": false
4733 },
4734 "members_count": 4,
4735 "repos_count": 2,
4736 "child_teams_count": 1,
4737 "viewer_role": "maintainer",
4738 "can_manage": true,
4739 "created_at": "2026-10-06T15:02:11.480Z",
4740 "updated_at": "2026-10-07T09:44:03.512Z"
4741 },
4742 "notes": "| Field | |\n| --- | --- |\n| `enabled` | Off, everyone in the team is asked. On, `count` people are picked and asked, and the team stays shown as asked beside them. |\n| `algorithm` | `round_robin`: whoever this team asked least recently. `load_balance`: whoever has the fewest pull requests waiting on their review. |\n| `count` | How many to pick, 1 to 10. People from the team already asked count towards it. |\n| `skip_busy`, `busy_at` | Leave out anyone with `busy_at` (1 to 100) or more pull requests waiting on their review. |\n| `include_child_teams` | Also pick from its child teams' people. |\n| `excluded` | Usernames never picked. Replaces the whole list. |\n| `notify_team` | Also tell the rest of the team when people are picked. |\n\nFields left out keep their value. The pull request's author is never picked. See [Teams](/guides/teams/)."
4743 },
4744 "list_user_teams": {
4745 "params": {
4746 "workspace": "flagon-io",
4747 "username": "ana"
4748 },
4749 "response": [
4750 {
4751 "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
4752 "workspace": "flagon-io",
4753 "slug": "backend",
4754 "name": "Backend",
4755 "description": "The API and the services behind it.",
4756 "visibility": "visible",
4757 "parent": {
4758 "slug": "engineering",
4759 "name": "Engineering"
4760 },
4761 "notify": true,
4762 "review_assignment": {
4763 "enabled": false,
4764 "algorithm": "round_robin",
4765 "count": 1,
4766 "skip_busy": false,
4767 "busy_at": 5,
4768 "include_child_teams": false,
4769 "excluded": [],
4770 "notify_team": false
4771 },
4772 "members_count": 4,
4773 "repos_count": 2,
4774 "child_teams_count": 1,
4775 "viewer_role": null,
4776 "can_manage": false,
4777 "created_at": "2026-10-06T15:02:11.480Z",
4778 "updated_at": "2026-10-06T15:02:11.480Z"
4779 }
4780 ],
4781 "notes": "Only the teams they are in themselves, not the parents those teams are under. Secret teams you are not in are left out unless you are an owner. `403` for anyone who is not a member of the workspace."
4782 },
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily4783 "list_security_alerts": {
4784 "params": {
4785 "owner": "flagon-io",
4786 "name": "hello"
4787 },
4788 "query": {
4789 "state": "open"
4790 },
4791 "response": [
4792 {
4793 "kind": "secret",
4794 "id": "sec_01kp4a7b2c3d4e5f6g7h8j9k0m",
4795 "state": "dismissed",
4796 "secret_type": "aws_access_key",
4797 "label": "an AWS access key",
4798 "path": "test/fixtures/aws.env",
4799 "line": 3,
4800 "commit": "9f2c1e04b7d3a8e6f5c2b1a0d9e8f7c6b5a4d3e2",
4801 "preview": "AKIA…MPLE",
4802 "status": "allowed",
4803 "source": "history",
4804 "test_value": "the documented example key",
4805 "found_by": null,
4806 "found_at": "2026-10-01T12:00:00.000Z",
4807 "dismissed_reason": "used_in_tests",
4808 "dismissed_comment": "Only in the test fixtures.",
4809 "dismissed_by": "syntaqx",
4810 "dismissed_at": "2026-10-02T09:15:00.000Z"
4811 },
4812 {
4813 "kind": "dependency",
4814 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n",
4815 "state": "open",
4816 "ecosystem": "npm",
4817 "package": "lodash",
4818 "version": "4.17.20",
4819 "manifest": "package-lock.json",
4820 "advisory": "GHSA-35jh-r3h4-6jhm",
4821 "osv_id": "GHSA-35jh-r3h4-6jhm",
4822 "summary": "Command Injection in lodash",
4823 "severity": "high",
4824 "fixed_version": "4.17.21",
4825 "fixed_at": null,
4826 "update": {
4827 "state": "open",
4828 "target": "4.17.21",
4829 "branch": "g1t/security/lodash-4.17.21",
4830 "pull": 42,
4831 "issue": null,
4832 "error": null,
4833 "updated_at": "2026-10-01T12:20:00.000Z"
4834 },
4835 "found_at": "2026-10-01T12:00:00.000Z",
4836 "dismissed_reason": null,
4837 "dismissed_comment": null,
4838 "dismissed_by": null,
4839 "dismissed_at": null
4840 }
4841 ],
4842 "notes": "Secrets come first, then dependencies. Fields only one kind has are left out of the other: a secret has `secret_type`, `label`, `path`, `line`, `commit`, `preview`, `status` (`open`, `blocked`, `allowed` or `resolved`), `source` (`push` or `history`), `test_value` and `found_by`; a dependency has `ecosystem`, `package`, `version`, `manifest`, `advisory`, `osv_id`, `summary`, `severity`, `fixed_version` (null when no patched version is available), `fixed_at` and `update`, the pull request g1t opens to upgrade it. `dismissed_reason`, `dismissed_comment`, `dismissed_by` and `dismissed_at` are null while an alert is open; a secret fixed by being revoked keeps them. `422` for a `state` or `kind` it does not know, and `404` for anyone without the Write role. See [Security](/guides/security/)."
4843 },
4844 "dismiss_security_alert": {
4845 "params": {
4846 "owner": "flagon-io",
4847 "name": "hello",
4848 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n"
4849 },
4850 "request": {
4851 "reason": "tolerable_risk",
4852 "comment": "Only the build uses it, on trusted input."
4853 },
4854 "response": {
4855 "kind": "dependency",
4856 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n",
4857 "state": "dismissed",
4858 "ecosystem": "npm",
4859 "package": "lodash",
4860 "version": "4.17.20",
4861 "manifest": "package-lock.json",
4862 "advisory": "GHSA-35jh-r3h4-6jhm",
4863 "osv_id": "GHSA-35jh-r3h4-6jhm",
4864 "summary": "Command Injection in lodash",
4865 "severity": "high",
4866 "fixed_version": "4.17.21",
4867 "fixed_at": null,
4868 "update": {
4869 "state": "open",
4870 "target": "4.17.21",
4871 "branch": "g1t/security/lodash-4.17.21",
4872 "pull": 42,
4873 "issue": null,
4874 "error": null,
4875 "updated_at": "2026-10-01T12:20:00.000Z"
4876 },
4877 "found_at": "2026-10-01T12:00:00.000Z",
4878 "dismissed_reason": "tolerable_risk",
4879 "dismissed_comment": "Only the build uses it, on trusted input.",
4880 "dismissed_by": "syntaqx",
4881 "dismissed_at": "2026-10-06T10:00:00.000Z"
4882 },
4883 "notes": "| Kind | Reasons |\n| --- | --- |\n| `secret` | `false_positive`, `used_in_tests`, `revoked`, `wont_fix` |\n| `dependency` | `fix_started`, `no_bandwidth`, `tolerable_risk`, `inaccurate`, `not_used` |\n\nA reason for the other kind of alert, or one not in the table, is refused with `422`. A secret dismissed as `revoked` becomes `fixed`; with any other reason it becomes `dismissed` and pushes that carry it go through. Dismissing a secret needs the Admin role on the repository; a dependency needs the Write role. A token needs `repo:admin` for either, and a g1t agent’s token never dismisses alerts."
4884 },
4885 "reopen_security_alert": {
4886 "params": {
4887 "owner": "flagon-io",
4888 "name": "hello",
4889 "id": "sec_01kp4a7b2c3d4e5f6g7h8j9k0m"
4890 },
4891 "response": {
4892 "kind": "secret",
4893 "id": "sec_01kp4a7b2c3d4e5f6g7h8j9k0m",
4894 "state": "open",
4895 "secret_type": "aws_access_key",
4896 "label": "an AWS access key",
4897 "path": "test/fixtures/aws.env",
4898 "line": 3,
4899 "commit": "9f2c1e04b7d3a8e6f5c2b1a0d9e8f7c6b5a4d3e2",
4900 "preview": "AKIA…MPLE",
4901 "status": "open",
4902 "source": "history",
4903 "test_value": "the documented example key",
4904 "found_by": null,
4905 "found_at": "2026-10-01T12:00:00.000Z",
4906 "dismissed_reason": null,
4907 "dismissed_comment": null,
4908 "dismissed_by": null,
4909 "dismissed_at": null
4910 },
4911 "notes": "The alert is `open` again, and a reopened secret stops pushes that carry it. The same roles as dismissing: Admin for a secret, Write for a dependency."
API: notifications over REST and MCP, with notifications scopes4912 },
4913 "list_notifications": {
4914 "query": {
4915 "participating": "true"
4916 },
4917 "response": {
4918 "items": [
4919 {
4920 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
4921 "reason": "review_requested",
4922 "severity": "warning",
4923 "title": "ada asked you to review flagon-io/hello#14",
4924 "body": "Add a greeting to the README",
4925 "event": "pull.review_requested",
4926 "repo": "flagon-io/hello",
4927 "workspace": "flagon-io",
4928 "subject": "pull",
4929 "number": 14,
4930 "url": "/flagon-io/hello/pull/14",
4931 "actor": "ada",
4932 "count": 3,
4933 "created_at": "2026-10-06T15:02:11.000Z",
4934 "updated_at": "2026-10-07T09:41:30.000Z",
4935 "read_at": null,
4936 "done_at": null,
4937 "saved": false,
4938 "snoozed_until": null
4939 },
4940 {
4941 "id": "ntf_01kp7k9a8b7c6d5e4f3g2h1j0k",
4942 "reason": "ci_activity",
4943 "severity": "error",
4944 "title": "Production of hello failed to deploy",
4945 "body": "The build failed: npm run build exited with 1.",
4946 "event": "deployment.failed",
4947 "repo": "flagon-io/hello",
4948 "workspace": "flagon-io",
4949 "subject": "deploy",
4950 "number": null,
4951 "url": "/flagon-io/hello/deployments/dpl_01kp7k8z7y6x5w4v3t2s1r0q9p",
4952 "actor": "syntaqx",
4953 "count": 1,
4954 "created_at": "2026-10-07T08:12:40.000Z",
4955 "updated_at": "2026-10-07T08:12:40.000Z",
4956 "read_at": null,
4957 "done_at": null,
4958 "saved": false,
4959 "snoozed_until": null
4960 }
4961 ],
4962 "next": null
4963 },
4964 "notes": "Unread threads only, unless `all=true`. Threads that wait on you (an agent, or a review asked of you) have severity `warning`.\n\n| `reason` | You were told because |\n| --- | --- |\n| `agent` | An agent is waiting on you: it asked a question, or g1t stopped until a person steps in |\n| `review_requested` | You were asked to review |\n| `assign` | You were assigned |\n| `mention` | Someone mentioned you by `@username` |\n| `ci_activity` | Checks, a workflow or a deployment on your work finished |\n| `security_alert` | A security alert on a repository you look after |\n| `state_change` | It was closed, reopened or merged |\n| `author` | You opened it, or asked g1t for it |\n| `comment` | You commented on it |\n| `manual` | You subscribed to it by hand |\n| `subscribed` | You watch its repository |\n\nWith `participating=true`, threads you only follow (`manual`, `subscribed`) are left out. For the next page, pass `next` as `cursor`; `next` is null on the last."
4965 },
4966 "list_repo_notifications": {
4967 "params": {
4968 "owner": "flagon-io",
4969 "name": "hello"
4970 },
4971 "query": {
4972 "all": "true"
4973 },
4974 "response": {
4975 "items": [
4976 {
4977 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
4978 "reason": "review_requested",
4979 "severity": "warning",
4980 "title": "ada asked you to review flagon-io/hello#14",
4981 "body": "Add a greeting to the README",
4982 "event": "pull.review_requested",
4983 "repo": "flagon-io/hello",
4984 "workspace": "flagon-io",
4985 "subject": "pull",
4986 "number": 14,
4987 "url": "/flagon-io/hello/pull/14",
4988 "actor": "ada",
4989 "count": 3,
4990 "created_at": "2026-10-06T15:02:11.000Z",
4991 "updated_at": "2026-10-07T09:41:30.000Z",
4992 "read_at": "2026-10-07T09:50:00.000Z",
4993 "done_at": null,
4994 "saved": false,
4995 "snoozed_until": null
4996 },
4997 {
4998 "id": "ntf_01kp7k9a8b7c6d5e4f3g2h1j0k",
4999 "reason": "ci_activity",
5000 "severity": "error",
5001 "title": "Production of hello failed to deploy",
5002 "body": "The build failed: npm run build exited with 1.",
5003 "event": "deployment.failed",
5004 "repo": "flagon-io/hello",
5005 "workspace": "flagon-io",
5006 "subject": "deploy",
5007 "number": null,
5008 "url": "/flagon-io/hello/deployments/dpl_01kp7k8z7y6x5w4v3t2s1r0q9p",
5009 "actor": "syntaqx",
5010 "count": 1,
5011 "created_at": "2026-10-07T08:12:40.000Z",
5012 "updated_at": "2026-10-07T08:12:40.000Z",
5013 "read_at": null,
5014 "done_at": null,
5015 "saved": false,
5016 "snoozed_until": null
5017 }
5018 ],
5019 "next": "ntf_01kp7k9a8b7c6d5e4f3g2h1j0k"
5020 },
5021 "notes": "The same as `GET /notifications`, for one repository you can read."
5022 },
5023 "mark_notifications_read": {
5024 "request": {
5025 "last_read_at": "2026-10-07T10:00:00Z"
5026 },
5027 "response": {
5028 "marked": 12,
5029 "last_read_at": "2026-10-07T10:00:00.000Z"
5030 },
5031 "notes": "Threads with activity after `last_read_at` stay unread, so send the time you last listed them."
5032 },
5033 "mark_repo_notifications_read": {
5034 "params": {
5035 "owner": "flagon-io",
5036 "name": "hello"
5037 },
5038 "request": {},
5039 "response": {
5040 "marked": 3,
5041 "last_read_at": "2026-10-07T10:02:41.512Z"
5042 }
5043 },
5044 "get_notification_thread": {
5045 "params": {
5046 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5047 },
5048 "response": {
5049 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
5050 "reason": "review_requested",
5051 "severity": "warning",
5052 "title": "ada asked you to review flagon-io/hello#14",
5053 "body": "Add a greeting to the README",
5054 "event": "pull.review_requested",
5055 "repo": "flagon-io/hello",
5056 "workspace": "flagon-io",
5057 "subject": "pull",
5058 "number": 14,
5059 "url": "/flagon-io/hello/pull/14",
5060 "actor": "ada",
5061 "count": 3,
5062 "created_at": "2026-10-06T15:02:11.000Z",
5063 "updated_at": "2026-10-07T09:41:30.000Z",
5064 "read_at": null,
5065 "done_at": null,
5066 "saved": false,
5067 "snoozed_until": null,
5068 "activity": [
5069 {
5070 "reason": "review_requested",
5071 "severity": "warning",
5072 "title": "ada asked you to review flagon-io/hello#14",
5073 "body": "Add a greeting to the README",
5074 "event": "pull.review_requested",
5075 "actor": "ada",
5076 "created_at": "2026-10-07T09:41:30.000Z"
5077 },
5078 {
5079 "reason": "comment",
5080 "severity": "info",
5081 "title": "ada commented on flagon-io/hello#14",
5082 "body": "Pushed the fix for the heading.",
5083 "event": "comment.created",
5084 "actor": "ada",
5085 "created_at": "2026-10-06T18:20:02.000Z"
5086 },
5087 {
5088 "reason": "comment",
5089 "severity": "info",
5090 "title": "g1t commented on flagon-io/hello#14",
5091 "body": "The heading level is off by one.",
5092 "event": "comment.created",
5093 "actor": "g1t",
5094 "created_at": "2026-10-06T15:02:11.000Z"
5095 }
5096 ],
5097 "subscription": {
5098 "subscribed": true,
5099 "ignored": false,
5100 "reason": "review_requested",
5101 "repo": "flagon-io/hello",
5102 "number": 14,
5103 "updated_at": null
5104 }
5105 },
5106 "notes": "`activity` keeps the last 10 things that happened on the thread, newest first; `count` is how many there have been. `subscription` is null for a workflow or a deployment, which nobody subscribes to."
5107 },
5108 "mark_thread_read": {
5109 "params": {
5110 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5111 },
5112 "request": {},
5113 "response": {
5114 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
5115 "reason": "review_requested",
5116 "severity": "warning",
5117 "title": "ada asked you to review flagon-io/hello#14",
5118 "body": "Add a greeting to the README",
5119 "event": "pull.review_requested",
5120 "repo": "flagon-io/hello",
5121 "workspace": "flagon-io",
5122 "subject": "pull",
5123 "number": 14,
5124 "url": "/flagon-io/hello/pull/14",
5125 "actor": "ada",
5126 "count": 3,
5127 "created_at": "2026-10-06T15:02:11.000Z",
5128 "updated_at": "2026-10-07T09:41:30.000Z",
5129 "read_at": "2026-10-07T10:03:00.000Z",
5130 "done_at": null,
5131 "saved": false,
5132 "snoozed_until": null,
5133 "activity": [
5134 {
5135 "reason": "review_requested",
5136 "severity": "warning",
5137 "title": "ada asked you to review flagon-io/hello#14",
5138 "body": "Add a greeting to the README",
5139 "event": "pull.review_requested",
5140 "actor": "ada",
5141 "created_at": "2026-10-07T09:41:30.000Z"
5142 },
5143 {
5144 "reason": "comment",
5145 "severity": "info",
5146 "title": "ada commented on flagon-io/hello#14",
5147 "body": "Pushed the fix for the heading.",
5148 "event": "comment.created",
5149 "actor": "ada",
5150 "created_at": "2026-10-06T18:20:02.000Z"
5151 },
5152 {
5153 "reason": "comment",
5154 "severity": "info",
5155 "title": "g1t commented on flagon-io/hello#14",
5156 "body": "The heading level is off by one.",
5157 "event": "comment.created",
5158 "actor": "g1t",
5159 "created_at": "2026-10-06T15:02:11.000Z"
5160 }
5161 ],
5162 "subscription": {
5163 "subscribed": true,
5164 "ignored": false,
5165 "reason": "review_requested",
5166 "repo": "flagon-io/hello",
5167 "number": 14,
5168 "updated_at": null
5169 }
5170 }
5171 },
5172 "mark_thread_done": {
5173 "params": {
5174 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5175 },
5176 "response": {
5177 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
5178 "reason": "review_requested",
5179 "severity": "warning",
5180 "title": "ada asked you to review flagon-io/hello#14",
5181 "body": "Add a greeting to the README",
5182 "event": "pull.review_requested",
5183 "repo": "flagon-io/hello",
5184 "workspace": "flagon-io",
5185 "subject": "pull",
5186 "number": 14,
5187 "url": "/flagon-io/hello/pull/14",
5188 "actor": "ada",
5189 "count": 3,
5190 "created_at": "2026-10-06T15:02:11.000Z",
5191 "updated_at": "2026-10-07T09:41:30.000Z",
5192 "read_at": "2026-10-07T10:03:00.000Z",
5193 "done_at": "2026-10-07T10:03:00.000Z",
5194 "saved": false,
5195 "snoozed_until": null,
5196 "activity": [
5197 {
5198 "reason": "review_requested",
5199 "severity": "warning",
5200 "title": "ada asked you to review flagon-io/hello#14",
5201 "body": "Add a greeting to the README",
5202 "event": "pull.review_requested",
5203 "actor": "ada",
5204 "created_at": "2026-10-07T09:41:30.000Z"
5205 },
5206 {
5207 "reason": "comment",
5208 "severity": "info",
5209 "title": "ada commented on flagon-io/hello#14",
5210 "body": "Pushed the fix for the heading.",
5211 "event": "comment.created",
5212 "actor": "ada",
5213 "created_at": "2026-10-06T18:20:02.000Z"
5214 },
5215 {
5216 "reason": "comment",
5217 "severity": "info",
5218 "title": "g1t commented on flagon-io/hello#14",
5219 "body": "The heading level is off by one.",
5220 "event": "comment.created",
5221 "actor": "g1t",
5222 "created_at": "2026-10-06T15:02:11.000Z"
5223 }
5224 ],
5225 "subscription": {
5226 "subscribed": true,
5227 "ignored": false,
5228 "reason": "review_requested",
5229 "repo": "flagon-io/hello",
5230 "number": 14,
5231 "updated_at": null
5232 }
5233 },
5234 "notes": "New activity on a done thread brings it back to the inbox, unread."
5235 },
5236 "save_thread": {
5237 "params": {
5238 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5239 },
5240 "request": {},
5241 "response": {
5242 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
5243 "reason": "review_requested",
5244 "severity": "warning",
5245 "title": "ada asked you to review flagon-io/hello#14",
5246 "body": "Add a greeting to the README",
5247 "event": "pull.review_requested",
5248 "repo": "flagon-io/hello",
5249 "workspace": "flagon-io",
5250 "subject": "pull",
5251 "number": 14,
5252 "url": "/flagon-io/hello/pull/14",
5253 "actor": "ada",
5254 "count": 3,
5255 "created_at": "2026-10-06T15:02:11.000Z",
5256 "updated_at": "2026-10-07T09:41:30.000Z",
5257 "read_at": null,
5258 "done_at": null,
5259 "saved": true,
5260 "snoozed_until": null,
5261 "activity": [
5262 {
5263 "reason": "review_requested",
5264 "severity": "warning",
5265 "title": "ada asked you to review flagon-io/hello#14",
5266 "body": "Add a greeting to the README",
5267 "event": "pull.review_requested",
5268 "actor": "ada",
5269 "created_at": "2026-10-07T09:41:30.000Z"
5270 },
5271 {
5272 "reason": "comment",
5273 "severity": "info",
5274 "title": "ada commented on flagon-io/hello#14",
5275 "body": "Pushed the fix for the heading.",
5276 "event": "comment.created",
5277 "actor": "ada",
5278 "created_at": "2026-10-06T18:20:02.000Z"
5279 },
5280 {
5281 "reason": "comment",
5282 "severity": "info",
5283 "title": "g1t commented on flagon-io/hello#14",
5284 "body": "The heading level is off by one.",
5285 "event": "comment.created",
5286 "actor": "g1t",
5287 "created_at": "2026-10-06T15:02:11.000Z"
5288 }
5289 ],
5290 "subscription": {
5291 "subscribed": true,
5292 "ignored": false,
5293 "reason": "review_requested",
5294 "repo": "flagon-io/hello",
5295 "number": 14,
5296 "updated_at": null
5297 }
5298 }
5299 },
5300 "unsave_thread": {
5301 "params": {
5302 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5303 },
5304 "response": {
5305 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
5306 "reason": "review_requested",
5307 "severity": "warning",
5308 "title": "ada asked you to review flagon-io/hello#14",
5309 "body": "Add a greeting to the README",
5310 "event": "pull.review_requested",
5311 "repo": "flagon-io/hello",
5312 "workspace": "flagon-io",
5313 "subject": "pull",
5314 "number": 14,
5315 "url": "/flagon-io/hello/pull/14",
5316 "actor": "ada",
5317 "count": 3,
5318 "created_at": "2026-10-06T15:02:11.000Z",
5319 "updated_at": "2026-10-07T09:41:30.000Z",
5320 "read_at": null,
5321 "done_at": null,
5322 "saved": false,
5323 "snoozed_until": null,
5324 "activity": [
5325 {
5326 "reason": "review_requested",
5327 "severity": "warning",
5328 "title": "ada asked you to review flagon-io/hello#14",
5329 "body": "Add a greeting to the README",
5330 "event": "pull.review_requested",
5331 "actor": "ada",
5332 "created_at": "2026-10-07T09:41:30.000Z"
5333 },
5334 {
5335 "reason": "comment",
5336 "severity": "info",
5337 "title": "ada commented on flagon-io/hello#14",
5338 "body": "Pushed the fix for the heading.",
5339 "event": "comment.created",
5340 "actor": "ada",
5341 "created_at": "2026-10-06T18:20:02.000Z"
5342 },
5343 {
5344 "reason": "comment",
5345 "severity": "info",
5346 "title": "g1t commented on flagon-io/hello#14",
5347 "body": "The heading level is off by one.",
5348 "event": "comment.created",
5349 "actor": "g1t",
5350 "created_at": "2026-10-06T15:02:11.000Z"
5351 }
5352 ],
5353 "subscription": {
5354 "subscribed": true,
5355 "ignored": false,
5356 "reason": "review_requested",
5357 "repo": "flagon-io/hello",
5358 "number": 14,
5359 "updated_at": null
5360 }
5361 }
5362 },
5363 "snooze_thread": {
5364 "params": {
5365 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5366 },
5367 "request": {
5368 "until": "2026-10-08T09:00:00Z"
5369 },
5370 "response": {
5371 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
5372 "reason": "review_requested",
5373 "severity": "warning",
5374 "title": "ada asked you to review flagon-io/hello#14",
5375 "body": "Add a greeting to the README",
5376 "event": "pull.review_requested",
5377 "repo": "flagon-io/hello",
5378 "workspace": "flagon-io",
5379 "subject": "pull",
5380 "number": 14,
5381 "url": "/flagon-io/hello/pull/14",
5382 "actor": "ada",
5383 "count": 3,
5384 "created_at": "2026-10-06T15:02:11.000Z",
5385 "updated_at": "2026-10-07T09:41:30.000Z",
5386 "read_at": "2026-10-07T10:03:00.000Z",
5387 "done_at": null,
5388 "saved": false,
5389 "snoozed_until": "2026-10-08T09:00:00.000Z",
5390 "activity": [
5391 {
5392 "reason": "review_requested",
5393 "severity": "warning",
5394 "title": "ada asked you to review flagon-io/hello#14",
5395 "body": "Add a greeting to the README",
5396 "event": "pull.review_requested",
5397 "actor": "ada",
5398 "created_at": "2026-10-07T09:41:30.000Z"
5399 },
5400 {
5401 "reason": "comment",
5402 "severity": "info",
5403 "title": "ada commented on flagon-io/hello#14",
5404 "body": "Pushed the fix for the heading.",
5405 "event": "comment.created",
5406 "actor": "ada",
5407 "created_at": "2026-10-06T18:20:02.000Z"
5408 },
5409 {
5410 "reason": "comment",
5411 "severity": "info",
5412 "title": "g1t commented on flagon-io/hello#14",
5413 "body": "The heading level is off by one.",
5414 "event": "comment.created",
5415 "actor": "g1t",
5416 "created_at": "2026-10-06T15:02:11.000Z"
5417 }
5418 ],
5419 "subscription": {
5420 "subscribed": true,
5421 "ignored": false,
5422 "reason": "review_requested",
5423 "repo": "flagon-io/hello",
5424 "number": 14,
5425 "updated_at": null
5426 }
5427 }
5428 },
5429 "unsnooze_thread": {
5430 "params": {
5431 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5432 },
5433 "response": {
5434 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a",
5435 "reason": "review_requested",
5436 "severity": "warning",
5437 "title": "ada asked you to review flagon-io/hello#14",
5438 "body": "Add a greeting to the README",
5439 "event": "pull.review_requested",
5440 "repo": "flagon-io/hello",
5441 "workspace": "flagon-io",
5442 "subject": "pull",
5443 "number": 14,
5444 "url": "/flagon-io/hello/pull/14",
5445 "actor": "ada",
5446 "count": 3,
5447 "created_at": "2026-10-06T15:02:11.000Z",
5448 "updated_at": "2026-10-07T09:41:30.000Z",
5449 "read_at": "2026-10-07T10:03:00.000Z",
5450 "done_at": null,
5451 "saved": false,
5452 "snoozed_until": null,
5453 "activity": [
5454 {
5455 "reason": "review_requested",
5456 "severity": "warning",
5457 "title": "ada asked you to review flagon-io/hello#14",
5458 "body": "Add a greeting to the README",
5459 "event": "pull.review_requested",
5460 "actor": "ada",
5461 "created_at": "2026-10-07T09:41:30.000Z"
5462 },
5463 {
5464 "reason": "comment",
5465 "severity": "info",
5466 "title": "ada commented on flagon-io/hello#14",
5467 "body": "Pushed the fix for the heading.",
5468 "event": "comment.created",
5469 "actor": "ada",
5470 "created_at": "2026-10-06T18:20:02.000Z"
5471 },
5472 {
5473 "reason": "comment",
5474 "severity": "info",
5475 "title": "g1t commented on flagon-io/hello#14",
5476 "body": "The heading level is off by one.",
5477 "event": "comment.created",
5478 "actor": "g1t",
5479 "created_at": "2026-10-06T15:02:11.000Z"
5480 }
5481 ],
5482 "subscription": {
5483 "subscribed": true,
5484 "ignored": false,
5485 "reason": "review_requested",
5486 "repo": "flagon-io/hello",
5487 "number": 14,
5488 "updated_at": null
5489 }
5490 }
5491 },
5492 "get_thread_subscription": {
5493 "params": {
5494 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5495 },
5496 "response": {
5497 "subscribed": true,
5498 "ignored": false,
5499 "reason": "review_requested",
5500 "repo": "flagon-io/hello",
5501 "number": 14,
5502 "updated_at": null
5503 }
5504 },
5505 "set_thread_subscription": {
5506 "params": {
5507 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5508 },
5509 "request": {
5510 "ignored": true
5511 },
5512 "response": {
5513 "subscribed": false,
5514 "ignored": true,
5515 "reason": null,
5516 "repo": "flagon-io/hello",
5517 "number": 14,
5518 "updated_at": "2026-10-07T10:04:00.000Z"
5519 },
5520 "notes": "| Body | Then |\n| --- | --- |\n| `{}` or `{\"subscribed\": true}` | You hear of what happens on it |\n| `{\"subscribed\": false}` | You hear only of what is asked of you |\n| `{\"ignored\": true}` | You hear of nothing on it, not even a mention |"
5521 },
5522 "delete_thread_subscription": {
5523 "params": {
5524 "id": "ntf_01kp7m2q3r4s5t6v7w8x9y0z1a"
5525 },
5526 "response": {
5527 "subscribed": false,
5528 "ignored": false,
5529 "reason": null,
5530 "repo": "flagon-io/hello",
5531 "number": 14,
5532 "updated_at": "2026-10-07T10:04:00.000Z"
5533 }
5534 },
5535 "get_issue_subscription": {
5536 "params": {
5537 "owner": "flagon-io",
5538 "name": "hello",
5539 "number": 14
5540 },
5541 "response": {
5542 "subscribed": true,
5543 "ignored": false,
5544 "reason": "author",
5545 "repo": null,
5546 "number": 14,
5547 "updated_at": null
5548 }
5549 },
5550 "set_issue_subscription": {
5551 "params": {
5552 "owner": "flagon-io",
5553 "name": "hello",
5554 "number": 14
5555 },
5556 "request": {
5557 "subscribed": true
5558 },
5559 "response": {
5560 "subscribed": true,
5561 "ignored": false,
5562 "reason": "manual",
5563 "repo": null,
5564 "number": 14,
5565 "updated_at": "2026-10-07T10:05:00.000Z"
5566 }
5567 },
5568 "delete_issue_subscription": {
5569 "params": {
5570 "owner": "flagon-io",
5571 "name": "hello",
5572 "number": 14
5573 },
5574 "response": {
5575 "subscribed": false,
5576 "ignored": false,
5577 "reason": null,
5578 "repo": null,
5579 "number": 14,
5580 "updated_at": "2026-10-07T10:05:30.000Z"
5581 }
5582 },
5583 "get_repo_subscription": {
5584 "params": {
5585 "owner": "flagon-io",
5586 "name": "hello"
5587 },
5588 "response": {
5589 "repo": "flagon-io/hello",
5590 "level": "participating",
5591 "events": [],
5592 "subscribed": false,
5593 "ignored": false,
5594 "updated_at": null
5595 }
5596 },
5597 "set_repo_subscription": {
5598 "params": {
5599 "owner": "flagon-io",
5600 "name": "hello"
5601 },
5602 "request": {
5603 "level": "custom",
5604 "events": [
5605 "pulls",
5606 "deployments"
5607 ]
5608 },
5609 "response": {
5610 "repo": "flagon-io/hello",
5611 "level": "custom",
5612 "events": [
5613 "pulls",
5614 "deployments"
5615 ],
5616 "subscribed": true,
5617 "ignored": false,
5618 "updated_at": "2026-10-07T10:06:00.000Z"
5619 },
5620 "notes": "| `level` | You hear of |\n| --- | --- |\n| `participating` | What you take part in, or are mentioned in (the default) |\n| `all` | Every issue and pull request opened, commented on, closed or merged, and every deployment |\n| `custom` | What you take part in, and the kinds in `events`: `issues`, `pulls`, `deployments`, `security` |\n| `ignore` | Nothing, not even a mention |\n\nInstead of `level`, `{\"subscribed\": true}` is `all`, `{\"subscribed\": false}` is `participating` and `{\"ignored\": true}` is `ignore`."
5621 },
5622 "delete_repo_subscription": {
5623 "params": {
5624 "owner": "flagon-io",
5625 "name": "hello"
5626 },
5627 "response": {
5628 "repo": "flagon-io/hello",
5629 "level": "participating",
5630 "events": [],
5631 "subscribed": false,
5632 "ignored": false,
5633 "updated_at": null
5634 }
5635 },
5636 "list_watched_repos": {
5637 "response": [
5638 {
5639 "repo": "flagon-io/hello",
5640 "level": "all",
5641 "events": [],
5642 "subscribed": true,
5643 "ignored": false,
5644 "updated_at": "2026-10-07T10:00:00.000Z"
5645 },
5646 {
5647 "repo": "flagon-io/docs",
5648 "level": "ignore",
5649 "events": [],
5650 "subscribed": false,
5651 "ignored": true,
5652 "updated_at": "2026-10-05T14:30:00.000Z"
5653 }
5654 ]
API: pinned projects over REST and MCP5655 },
Usage, Billing settings and prepaid AI credit; fixes from the UX audit5656 "get_usage": {
5657 "params": {
5658 "workspace": "flagon-io"
5659 },
5660 "query": {
5661 "from": "2026-10-01",
5662 "until": "2026-10-07",
5663 "group_by": "project"
5664 },
5665 "response": {
5666 "from": "2026-10-01",
5667 "until": "2026-10-07",
5668 "totals": {
5669 "price_micros": 48210000,
5670 "discount_micros": 0,
5671 "included_micros": 20000000,
5672 "credits_micros": 18000000,
5673 "charged_micros": 10210000,
5674 "pending_micros": 1340000,
5675 "cost_micros": 40100000
5676 },
5677 "days": [
5678 {
5679 "day": "2026-10-06",
5680 "product": "agent",
5681 "micros": 12400000
5682 },
5683 {
5684 "day": "2026-10-06",
5685 "product": "sandboxes",
5686 "micros": 2100000
5687 },
5688 {
5689 "day": "2026-10-07",
5690 "product": "agent",
5691 "micros": 9800000
5692 }
5693 ],
5694 "products": [
5695 {
5696 "key": "agent",
5697 "label": "Agent",
5698 "micros": 41000000,
5699 "meters": [
5700 {
5701 "key": "agent_models",
5702 "label": "Models",
5703 "product": "agent",
5704 "unit": "tokens",
5705 "quantity": 9120000,
5706 "micros": 41000000,
5707 "pending_micros": 0,
5708 "daily": [
5709 3100000,
5710 5200000,
5711 4400000,
5712 6000000,
5713 0,
5714 12400000,
5715 9800000
5716 ],
5717 "allowance": null,
5718 "by_project": [
5719 {
5720 "project": "flagon-io/g1t",
5721 "micros": 36000000,
5722 "quantity": 8010000
5723 },
5724 {
5725 "project": "flagon-io/hello",
5726 "micros": 5000000,
5727 "quantity": 1110000
5728 }
5729 ]
5730 }
5731 ],
5732 "features": [
5733 {
5734 "key": "runs",
5735 "label": "Runs",
5736 "micros": 33000000,
5737 "count": 14
5738 },
5739 {
5740 "key": "reviews",
5741 "label": "Reviews",
5742 "micros": 8000000,
5743 "count": 9
5744 }
5745 ]
5746 },
5747 {
5748 "key": "sandboxes",
5749 "label": "Sandboxes",
5750 "micros": 7210000,
5751 "meters": [
5752 {
5753 "key": "sandbox",
5754 "label": "Sandbox time",
5755 "product": "sandboxes",
5756 "unit": "seconds",
5757 "quantity": 41300,
5758 "micros": 7210000,
5759 "pending_micros": 0,
5760 "daily": [
5761 900000,
5762 1200000,
5763 800000,
5764 1100000,
5765 0,
5766 2100000,
5767 1110000
5768 ],
5769 "allowance": {
5770 "used": 41300,
5771 "of": 108000,
5772 "unit": "seconds"
5773 },
5774 "by_project": [
5775 {
5776 "project": "flagon-io/g1t",
5777 "micros": 7210000,
5778 "quantity": 41300
5779 }
5780 ]
5781 }
5782 ],
5783 "features": []
5784 }
5785 ],
5786 "projects": [
5787 "flagon-io/g1t",
5788 "flagon-io/hello"
5789 ],
5790 "included": {
5791 "used": 20,
5792 "of": 20,
5793 "unit": "dollars"
5794 },
5795 "discount_percent": null,
5796 "ai_credit_micros": 62000000,
5797 "credit_micros": 0,
5798 "trial_micros": null,
5799 "plan": "pro",
5800 "free": false,
5801 "group_by": "project",
5802 "groups": [
5803 {
5804 "key": "flagon-io/g1t",
5805 "micros": 43210000
5806 },
5807 {
5808 "key": "flagon-io/hello",
5809 "micros": 5000000
5810 }
5811 ]
5812 },
5813 "notes": "Every product family is listed, in order, even with nothing used; this example shows two. `daily` has one amount for each day of the range, oldest first. `projects` and `products` take several values separated by commas: `?products=agent,sandboxes`. A range of more than 400 days, or one that ends before it starts, is refused with `invalid`."
5814 },
5815 "get_budget": {
5816 "params": {
5817 "workspace": "flagon-io"
5818 },
5819 "response": {
5820 "workspace": "flagon-io",
5821 "amount_micros": 500000000,
5822 "automatic": false,
5823 "spent_micros": 132450000,
5824 "max_amount_micros": 2000000000,
5825 "alerts": [
5826 50,
5827 75,
5828 90,
5829 100
5830 ],
5831 "pause_at_limit": true,
5832 "webhook": "https://ops.example.com/g1t/budget",
5833 "state": "ok",
5834 "message": null
5835 },
5836 "notes": "All amounts are whole millionths of a dollar: 500000000 is $500. `max_amount_micros` is null for g1t's own workspaces, which have no ceiling. When `state` is `stopped`, new sandboxes, builds and app requests wait until the limit is raised or the month closes."
5837 },
5838 "set_budget": {
5839 "params": {
5840 "workspace": "flagon-io"
5841 },
5842 "request": {
5843 "amount_micros": 500000000,
5844 "alerts": [
5845 50,
5846 75,
5847 90,
5848 100
5849 ],
5850 "webhook": "https://ops.example.com/g1t/budget"
5851 },
5852 "response": {
5853 "workspace": "flagon-io",
5854 "amount_micros": 500000000,
5855 "automatic": false,
5856 "spent_micros": 132450000,
5857 "max_amount_micros": 2000000000,
5858 "alerts": [
5859 50,
5860 75,
5861 90,
5862 100
5863 ],
5864 "pause_at_limit": true,
5865 "webhook": "https://ops.example.com/g1t/budget",
5866 "state": "ok",
5867 "message": null
5868 },
5869 "notes": "Fields left out keep their value. A limit above `max_amount_micros` is refused with `invalid`. Called by anyone but an owner signed in as a person, or by a workspace's own token or one of g1t's agents, it is refused with `forbidden`. Each alert is sent once a month, to the owners by email and, with `webhook`, as a JSON POST."
5870 },
5871 "get_ai_credit": {
5872 "params": {
5873 "workspace": "flagon-io"
5874 },
5875 "response": {
5876 "balance_micros": 62000000,
5877 "purchased_micros": 50000000,
5878 "given_micros": 12000000,
5879 "grants": [
5880 {
5881 "id": "crd_01kkr2m4c8f1t7qh3d6n9w5p0x",
5882 "workspace": "flagon-io",
5883 "kind": "purchase",
5884 "amount_micros": 50000000,
5885 "used_micros": 0,
5886 "left_micros": 50000000,
5887 "note": "AI credit bought",
5888 "refund_for": null,
5889 "refund_day": null,
5890 "expires_at": "2027-10-02T00:00:00.000Z",
5891 "created_by": "ana",
5892 "created_at": "2026-10-02T16:20:00.000Z",
5893 "state": "open",
5894 "closed_at": null,
5895 "closed_note": null,
5896 "closed_by": null
5897 }
5898 ],
5899 "free_via_discount": false,
5900 "postpaid": false,
5901 "blocked": false,
5902 "can_buy": true,
5903 "presets_cents": [
5904 2500,
5905 5000,
5906 10000,
5907 25000
5908 ],
5909 "min_cents": 1000,
5910 "max_cents": 100000,
5911 "card_fee": {
5912 "on": true,
5913 "percent_micros": 29000,
5914 "fixed_cents": 30
5915 },
5916 "reload": {
5917 "enabled": false,
5918 "threshold_micros": 10000000,
5919 "target_micros": 50000000,
5920 "monthly_max_micros": 200000000,
5921 "reloaded_micros": 0,
5922 "failed_at": null,
5923 "error": null
5924 },
5925 "agent_rate_micros": 3.6,
5926 "model_markup_percent": 10,
5927 "gateway_markup_percent": 5,
5928 "upgrade_credit_micros": 10000000,
5929 "expires_days": 365
5930 },
5931 "notes": "`card_fee.percent_micros` is per dollar charged, in millionths: 29000 is 2.9%. `blocked` is true when the credit has run out and new runs on g1t's models wait for more; runs on a model provider the workspace connected itself never need it."
5932 },
5933 "buy_ai_credit": {
5934 "params": {
5935 "workspace": "flagon-io"
5936 },
5937 "request": {
5938 "amount_cents": 5000
5939 },
5940 "response": {
5941 "url": "https://checkout.example.com/c/pay/cs_test_a1b2c3"
5942 },
5943 "notes": "Open `url` in a browser to pay. Nothing is charged until the payment is made there; the credit then shows in get_ai_credit. An amount outside `min_cents` to `max_cents`, or not in whole dollars, is refused with `invalid`; a workspace that cannot buy credit (see `can_buy`) gets `conflict` or `payment_required`."
5944 },
5945 "list_invoices": {
5946 "params": {
5947 "workspace": "flagon-io"
5948 },
5949 "response": {
5950 "invoices": [
5951 {
5952 "id": "in_1Q2w3E4r5T6y7U8i",
5953 "number": "FLAGON-0004",
5954 "status": "paid",
5955 "total_cents": 4210,
5956 "currency": "usd",
5957 "created_at": "2026-10-01T00:05:00.000Z",
5958 "description": "Usage for 2026-09",
5959 "hosted_url": "https://invoice.example.com/i/acct_1/in_1Q2w3E4r5T6y7U8i",
5960 "pdf_url": "https://invoice.example.com/i/acct_1/in_1Q2w3E4r5T6y7U8i/pdf"
5961 }
5962 ],
5963 "usage_invoices": [
5964 {
5965 "id": "inv_01kkqz8d3c6f9t2wq5n8h1m4r7",
5966 "workspace": "flagon-io",
5967 "reason": "month",
5968 "period": "2026-09",
5969 "amount_micros": 42100000,
5970 "status": "paid",
5971 "hosted_url": "https://invoice.example.com/i/acct_1/in_1Q2w3E4r5T6y7U8i",
5972 "pdf_url": "https://invoice.example.com/i/acct_1/in_1Q2w3E4r5T6y7U8i/pdf",
5973 "lines": [
5974 {
5975 "description": "Agent: models",
5976 "amount_micros": 35900000
5977 },
5978 {
5979 "description": "Sandbox time",
5980 "amount_micros": 6200000
5981 }
5982 ],
5983 "created_at": "2026-10-01T00:05:00.000Z"
5984 }
5985 ],
5986 "upcoming": {
5987 "closes_at": "2026-11-01T00:00:00.000Z",
5988 "subscriptions_micros": 20000000,
5989 "usage_micros": 10210000,
5990 "total_micros": 30210000
5991 },
5992 "unavailable": null
5993 },
5994 "notes": "`invoices` are in cents (`total_cents`); `usage_invoices` and `upcoming` in millionths of a dollar. A usage invoice's `reason` is `month` (the month closed) or `threshold` (charged near the limit), and its `status` `paid`, `open`, `failed` or `void`. An invoice's `status` is `paid`, `open`, `void`, `uncollectible` or `draft`."
5995 },
5996 "get_billing_details": {
5997 "params": {
5998 "workspace": "flagon-io"
5999 },
6000 "response": {
6001 "customer": true,
6002 "email": "billing@flagon.example.com",
6003 "name": "Flagon, Inc.",
6004 "address": {
6005 "line1": "100 Market Street",
6006 "line2": "",
6007 "city": "San Francisco",
6008 "state": "CA",
6009 "postal_code": "94105",
6010 "country": "US"
6011 },
6012 "tax_id_type": "us_ein",
6013 "tax_id": "12-3456789",
6014 "po_number": null,
6015 "language": "en",
6016 "payment_method": {
6017 "kind": "card",
6018 "brand": "visa",
6019 "last4": "4242",
6020 "exp_month": 12,
6021 "exp_year": 2028
6022 }
6023 },
6024 "notes": "Owners change these on the workspace's billing page. `payment_method` is null until a card or other way to pay is saved."
6025 },
API: pinned projects over REST and MCP6026 "list_pinned_projects": {
6027 "params": {
6028 "workspace": "flagon-io"
6029 },
6030 "response": [
6031 {
6032 "position": 0,
6033 "id": "prj_01kkp3m8w2f6t9qh4c7d1r5n0x",
6034 "workspace": "flagon-io",
6035 "slug": "g1t",
6036 "name": "g1t",
6037 "description": null,
6038 "private": false,
6039 "archived": false,
6040 "kind": "app",
6041 "url": "https://g1t.sh/flagon-io/g1t",
6042 "pushed_at": "2026-10-07T10:00:00.000Z",
6043 "updated_at": "2026-10-01T09:12:00.000Z"
6044 },
6045 {
6046 "position": 1,
6047 "id": "prj_01kkq0c4d9h2w7rn5f8t3k6p2z",
6048 "workspace": "flagon-io",
6049 "slug": "lab-api",
6050 "name": "lab-api",
6051 "description": null,
6052 "private": true,
6053 "archived": false,
6054 "kind": "app",
6055 "url": "https://g1t.sh/flagon-io/lab-api",
6056 "pushed_at": "2026-10-06T18:40:00.000Z",
6057 "updated_at": "2026-10-01T09:12:00.000Z"
6058 },
6059 {
6060 "position": 2,
6061 "id": "prj_01kkp3n2a7e5v8sk3b6g9j4m1y",
6062 "workspace": "flagon-io",
6063 "slug": "hello",
6064 "name": "hello",
6065 "description": "Greets people from the command line.",
6066 "private": false,
6067 "archived": false,
6068 "kind": "library",
6069 "url": "https://g1t.sh/flagon-io/hello",
6070 "pushed_at": null,
6071 "updated_at": "2026-10-01T09:12:00.000Z"
6072 }
6073 ],
6074 "notes": "In your order: `position` 0 first. The sidebar shows these, then the projects you opened last. `pushed_at` is null until the project's repository is pushed to."
6075 },
6076 "pin_project": {
6077 "params": {
6078 "workspace": "flagon-io",
6079 "project": "hello"
6080 },
6081 "request": {
6082 "position": 0
6083 },
6084 "response": [
6085 {
6086 "position": 0,
6087 "id": "prj_01kkp3n2a7e5v8sk3b6g9j4m1y",
6088 "workspace": "flagon-io",
6089 "slug": "hello",
6090 "name": "hello",
6091 "description": "Greets people from the command line.",
6092 "private": false,
6093 "archived": false,
6094 "kind": "library",
6095 "url": "https://g1t.sh/flagon-io/hello",
6096 "pushed_at": null,
6097 "updated_at": "2026-10-01T09:12:00.000Z"
6098 },
6099 {
6100 "position": 1,
6101 "id": "prj_01kkp3m8w2f6t9qh4c7d1r5n0x",
6102 "workspace": "flagon-io",
6103 "slug": "g1t",
6104 "name": "g1t",
6105 "description": null,
6106 "private": false,
6107 "archived": false,
6108 "kind": "app",
6109 "url": "https://g1t.sh/flagon-io/g1t",
6110 "pushed_at": "2026-10-07T10:00:00.000Z",
6111 "updated_at": "2026-10-01T09:12:00.000Z"
6112 },
6113 {
6114 "position": 2,
6115 "id": "prj_01kkq0c4d9h2w7rn5f8t3k6p2z",
6116 "workspace": "flagon-io",
6117 "slug": "lab-api",
6118 "name": "lab-api",
6119 "description": null,
6120 "private": true,
6121 "archived": false,
6122 "kind": "app",
6123 "url": "https://g1t.sh/flagon-io/lab-api",
6124 "pushed_at": "2026-10-06T18:40:00.000Z",
6125 "updated_at": "2026-10-01T09:12:00.000Z"
6126 }
6127 ],
6128 "notes": "A ninth pin in a workspace is refused with `409 conflict`: unpin one first."
6129 },
6130 "unpin_project": {
6131 "params": {
6132 "workspace": "flagon-io",
6133 "project": "lab-api"
6134 },
6135 "response": [
6136 {
6137 "position": 0,
6138 "id": "prj_01kkp3m8w2f6t9qh4c7d1r5n0x",
6139 "workspace": "flagon-io",
6140 "slug": "g1t",
6141 "name": "g1t",
6142 "description": null,
6143 "private": false,
6144 "archived": false,
6145 "kind": "app",
6146 "url": "https://g1t.sh/flagon-io/g1t",
6147 "pushed_at": "2026-10-07T10:00:00.000Z",
6148 "updated_at": "2026-10-01T09:12:00.000Z"
6149 },
6150 {
6151 "position": 1,
6152 "id": "prj_01kkp3n2a7e5v8sk3b6g9j4m1y",
6153 "workspace": "flagon-io",
6154 "slug": "hello",
6155 "name": "hello",
6156 "description": "Greets people from the command line.",
6157 "private": false,
6158 "archived": false,
6159 "kind": "library",
6160 "url": "https://g1t.sh/flagon-io/hello",
6161 "pushed_at": null,
6162 "updated_at": "2026-10-01T09:12:00.000Z"
6163 }
6164 ]
6165 },
6166 "reorder_pinned_projects": {
6167 "params": {
6168 "workspace": "flagon-io"
6169 },
6170 "request": {
6171 "projects": [
6172 "lab-api",
6173 "g1t",
6174 "hello"
6175 ]
6176 },
6177 "response": [
6178 {
6179 "position": 0,
6180 "id": "prj_01kkq0c4d9h2w7rn5f8t3k6p2z",
6181 "workspace": "flagon-io",
6182 "slug": "lab-api",
6183 "name": "lab-api",
6184 "description": null,
6185 "private": true,
6186 "archived": false,
6187 "kind": "app",
6188 "url": "https://g1t.sh/flagon-io/lab-api",
6189 "pushed_at": "2026-10-06T18:40:00.000Z",
6190 "updated_at": "2026-10-01T09:12:00.000Z"
6191 },
6192 {
6193 "position": 1,
6194 "id": "prj_01kkp3m8w2f6t9qh4c7d1r5n0x",
6195 "workspace": "flagon-io",
6196 "slug": "g1t",
6197 "name": "g1t",
6198 "description": null,
6199 "private": false,
6200 "archived": false,
6201 "kind": "app",
6202 "url": "https://g1t.sh/flagon-io/g1t",
6203 "pushed_at": "2026-10-07T10:00:00.000Z",
6204 "updated_at": "2026-10-01T09:12:00.000Z"
6205 },
6206 {
6207 "position": 2,
6208 "id": "prj_01kkp3n2a7e5v8sk3b6g9j4m1y",
6209 "workspace": "flagon-io",
6210 "slug": "hello",
6211 "name": "hello",
6212 "description": "Greets people from the command line.",
6213 "private": false,
6214 "archived": false,
6215 "kind": "library",
6216 "url": "https://g1t.sh/flagon-io/hello",
6217 "pushed_at": null,
6218 "updated_at": "2026-10-01T09:12:00.000Z"
6219 }
6220 ],
6221 "notes": "Name every pinned project once; anything else is refused with `422 invalid`."
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar6222 },
6223 "list_secret_scanning_alerts": {
6224 "params": {
6225 "owner": "flagon-io",
6226 "name": "hello"
6227 },
6228 "query": {
6229 "state": "open"
6230 },
6231 "response": [
6232 {
6233 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6234 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6235 "kind": "github_token",
6236 "label": "a GitHub token",
6237 "path": "scripts/release.sh",
6238 "line": 12,
6239 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6240 "preview": "ghp_X7…",
6241 "status": "open",
6242 "source": "push",
6243 "found_by": "syntaqx",
6244 "found_at": "2026-10-06T09:14:02.118Z",
6245 "decided_by": null,
6246 "reason": null,
6247 "decided_at": null,
6248 "dismissed_reason": null,
6249 "test_value": null,
6250 "state": "open",
6251 "validity": "active",
6252 "validity_checked_at": "2026-10-06T09:20:41.502Z",
6253 "bypass": {
6254 "reason": "will_fix_later",
6255 "comment": "Rotating it this afternoon.",
6256 "by": "syntaqx",
6257 "at": "2026-10-06T09:14:02.118Z",
6258 "approved_by": null
6259 },
6260 "pattern_id": null,
6261 "pattern_name": null,
6262 "locations": 1
6263 }
6264 ],
6265 "notes": "| Filter | Values |\n| --- | --- |\n| `state` | `open` (in the history, or blocked at a push), `dismissed`, `fixed` |\n| `secret_type` | `aws_access_key`, `github_token`, `custom_pattern`, … |\n| `validity` | `active`, `inactive`, `unknown`, `unsupported` |\n| `bypassed` | `true` or `false` |\n\nThe secret itself is never returned: `preview` is enough to recognise it. `status` says where it stands: `open`, `blocked` (stopped at a push, never landed), `allowed` or `resolved`."
6266 },
6267 "list_secret_scanning_alerts_for_workspace": {
6268 "params": {
6269 "workspace": "flagon-io"
6270 },
6271 "query": {
6272 "state": "open"
6273 },
6274 "response": [
6275 {
6276 "repo": "hello",
6277 "secret": {
6278 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6279 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6280 "kind": "github_token",
6281 "label": "a GitHub token",
6282 "path": "scripts/release.sh",
6283 "line": 12,
6284 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6285 "preview": "ghp_X7…",
6286 "status": "open",
6287 "source": "push",
6288 "found_by": "syntaqx",
6289 "found_at": "2026-10-06T09:14:02.118Z",
6290 "decided_by": null,
6291 "reason": null,
6292 "decided_at": null,
6293 "dismissed_reason": null,
6294 "test_value": null,
6295 "state": "open",
6296 "validity": "active",
6297 "validity_checked_at": "2026-10-06T09:20:41.502Z",
6298 "bypass": {
6299 "reason": "will_fix_later",
6300 "comment": "Rotating it this afternoon.",
6301 "by": "syntaqx",
6302 "at": "2026-10-06T09:14:02.118Z",
6303 "approved_by": null
6304 },
6305 "pattern_id": null,
6306 "pattern_name": null,
6307 "locations": 1
6308 }
6309 }
6310 ],
6311 "notes": "Every repository whose findings you may see, each alert with its repository's name."
6312 },
6313 "get_secret_scanning_alert": {
6314 "params": {
6315 "owner": "flagon-io",
6316 "name": "hello",
6317 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p"
6318 },
6319 "response": {
6320 "secret": {
6321 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6322 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6323 "kind": "github_token",
6324 "label": "a GitHub token",
6325 "path": "scripts/release.sh",
6326 "line": 12,
6327 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6328 "preview": "ghp_X7…",
6329 "status": "blocked",
6330 "source": "push",
6331 "found_by": "syntaqx",
6332 "found_at": "2026-10-06T09:14:02.118Z",
6333 "decided_by": null,
6334 "reason": null,
6335 "decided_at": null,
6336 "dismissed_reason": null,
6337 "test_value": null,
6338 "state": "open",
6339 "validity": null,
6340 "validity_checked_at": null,
6341 "bypass": null,
6342 "pattern_id": null,
6343 "pattern_name": null,
6344 "locations": 1
6345 },
6346 "locations": [
6347 {
6348 "path": "scripts/release.sh",
6349 "line": 12,
6350 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6351 "source": "push",
6352 "found_at": "2026-10-06T09:14:02.118Z"
6353 }
6354 ],
6355 "activity": [],
6356 "requests": [],
6357 "checkable": true,
6358 "can_bypass": true,
6359 "can_request_bypass": false
6360 }
6361 },
6362 "update_secret_scanning_alert": {
6363 "params": {
6364 "owner": "flagon-io",
6365 "name": "hello",
6366 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p"
6367 },
6368 "request": {
6369 "state": "dismissed",
6370 "reason": "revoked",
6371 "comment": "Rotated in the issuer's settings."
6372 },
6373 "response": {
6374 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6375 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6376 "kind": "github_token",
6377 "label": "a GitHub token",
6378 "path": "scripts/release.sh",
6379 "line": 12,
6380 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6381 "preview": "ghp_X7…",
6382 "status": "resolved",
6383 "source": "push",
6384 "found_by": "syntaqx",
6385 "found_at": "2026-10-06T09:14:02.118Z",
6386 "decided_by": "syntaqx",
6387 "reason": "Rotated in the issuer's settings.",
6388 "decided_at": "2026-10-06T09:20:41.502Z",
6389 "dismissed_reason": "revoked",
6390 "test_value": null,
6391 "state": "fixed",
6392 "validity": "active",
6393 "validity_checked_at": "2026-10-06T09:20:41.502Z",
6394 "bypass": {
6395 "reason": "will_fix_later",
6396 "comment": "Rotating it this afternoon.",
6397 "by": "syntaqx",
6398 "at": "2026-10-06T09:14:02.118Z",
6399 "approved_by": null
6400 },
6401 "pattern_id": null,
6402 "pattern_name": null,
6403 "locations": 1
6404 },
6405 "notes": "Takes the Admin role: a dismissed secret is let through push protection, unless it was `revoked`, which marks it fixed. `state` `open` reopens it."
6406 },
6407 "list_secret_scanning_locations": {
6408 "params": {
6409 "owner": "flagon-io",
6410 "name": "hello",
6411 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p"
6412 },
6413 "response": [
6414 {
6415 "path": "scripts/release.sh",
6416 "line": 12,
6417 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6418 "source": "push",
6419 "found_at": "2026-10-06T09:14:02.118Z"
6420 }
6421 ]
6422 },
6423 "bypass_push_protection": {
6424 "params": {
6425 "owner": "flagon-io",
6426 "name": "hello",
6427 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p"
6428 },
6429 "request": {
6430 "reason": "will_fix_later",
6431 "comment": "Rotating it this afternoon."
6432 },
6433 "response": {
6434 "secret": {
6435 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6436 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6437 "kind": "github_token",
6438 "label": "a GitHub token",
6439 "path": "scripts/release.sh",
6440 "line": 12,
6441 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6442 "preview": "ghp_X7…",
6443 "status": "open",
6444 "source": "push",
6445 "found_by": "syntaqx",
6446 "found_at": "2026-10-06T09:14:02.118Z",
6447 "decided_by": null,
6448 "reason": null,
6449 "decided_at": null,
6450 "dismissed_reason": null,
6451 "test_value": null,
6452 "state": "open",
6453 "validity": null,
6454 "validity_checked_at": null,
6455 "bypass": {
6456 "reason": "will_fix_later",
6457 "comment": "Rotating it this afternoon.",
6458 "by": "syntaqx",
6459 "at": "2026-10-06T09:14:02.118Z",
6460 "approved_by": null
6461 },
6462 "pattern_id": null,
6463 "pattern_name": null,
6464 "locations": 1
6465 },
6466 "request": null
6467 },
6468 "notes": "| Reason | The alert |\n| --- | --- |\n| `false_positive` | Closed as a false positive |\n| `used_in_tests` | Closed as used in tests |\n| `will_fix_later` | Stays open, to be rotated |\n\nWith delegated bypass on, a call from someone who does not review bypasses makes a request instead: `request` is set and the secret is still blocked until an owner or admin approves it. Push again once it is bypassed."
6469 },
6470 "check_secret_validity": {
6471 "params": {
6472 "owner": "flagon-io",
6473 "name": "hello",
6474 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p"
6475 },
6476 "response": {
6477 "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6478 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6479 "kind": "github_token",
6480 "label": "a GitHub token",
6481 "path": "scripts/release.sh",
6482 "line": 12,
6483 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6484 "preview": "ghp_X7…",
6485 "status": "open",
6486 "source": "push",
6487 "found_by": "syntaqx",
6488 "found_at": "2026-10-06T09:14:02.118Z",
6489 "decided_by": null,
6490 "reason": null,
6491 "decided_at": null,
6492 "dismissed_reason": null,
6493 "test_value": null,
6494 "state": "open",
6495 "validity": "active",
6496 "validity_checked_at": "2026-10-06T09:20:41.502Z",
6497 "bypass": {
6498 "reason": "will_fix_later",
6499 "comment": "Rotating it this afternoon.",
6500 "by": "syntaqx",
6501 "at": "2026-10-06T09:14:02.118Z",
6502 "approved_by": null
6503 },
6504 "pattern_id": null,
6505 "pattern_name": null,
6506 "locations": 1
6507 },
6508 "notes": "Made for GitHub, GitLab, Stripe, Slack, npm, OpenAI, Anthropic and SendGrid tokens, with the issuer's own read-only call. Other formats answer `unsupported`; a secret that never landed answers `unknown`."
6509 },
6510 "list_bypass_requests": {
6511 "params": {
6512 "workspace": "flagon-io"
6513 },
6514 "query": {
6515 "state": "pending"
6516 },
6517 "response": [
6518 {
6519 "id": "byp_01kq2n8e5f6g7h8j9k0m1n2p3q",
6520 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6521 "workspace": "flagon-io",
6522 "repo": "hello",
6523 "secret_id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6524 "label": "a GitHub token",
6525 "path": "scripts/release.sh",
6526 "line": 12,
6527 "preview": "ghp_X7…",
6528 "requester": "ana",
6529 "reason": "used_in_tests",
6530 "comment": "A token from the test fixtures, never issued.",
6531 "state": "pending",
6532 "reviewer": null,
6533 "review_comment": null,
6534 "created_at": "2026-10-06T09:14:02.118Z",
6535 "reviewed_at": null
6536 }
6537 ]
6538 },
6539 "review_bypass_request": {
6540 "params": {
6541 "workspace": "flagon-io",
6542 "id": "byp_01kq2n8e5f6g7h8j9k0m1n2p3q"
6543 },
6544 "request": {
6545 "decision": "approve",
6546 "comment": "A fixture."
6547 },
6548 "response": {
6549 "id": "byp_01kq2n8e5f6g7h8j9k0m1n2p3q",
6550 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6551 "workspace": "flagon-io",
6552 "repo": "hello",
6553 "secret_id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p",
6554 "label": "a GitHub token",
6555 "path": "scripts/release.sh",
6556 "line": 12,
6557 "preview": "ghp_X7…",
6558 "requester": "ana",
6559 "reason": "used_in_tests",
6560 "comment": "A token from the test fixtures, never issued.",
6561 "state": "approved",
6562 "reviewer": "syntaqx",
6563 "review_comment": "A fixture.",
6564 "created_at": "2026-10-06T09:14:02.118Z",
6565 "reviewed_at": "2026-10-06T09:20:41.502Z"
6566 }
6567 },
6568 "list_custom_patterns": {
6569 "params": {
6570 "owner": "flagon-io",
6571 "name": "hello"
6572 },
6573 "response": {
6574 "patterns": [
6575 {
6576 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r",
6577 "scope": "repository",
6578 "workspace": "flagon-io",
6579 "repo": "hello",
6580 "name": "Acme API key",
6581 "pattern": "acme_[a-z0-9]{32}",
6582 "before": null,
6583 "after": null,
6584 "test_strings": [
6585 "ACME_KEY=acme_0123456789abcdef0123456789abcdef"
6586 ],
6587 "state": "published",
6588 "created_by": "syntaqx",
6589 "created_at": "2026-10-06T09:14:02.118Z",
6590 "updated_by": "syntaqx",
6591 "updated_at": "2026-10-06T09:14:02.118Z",
6592 "open_alerts": 0
6593 }
6594 ],
6595 "entitled": true
6596 },
6597 "notes": "A repository's list includes its workspace's patterns, with `scope` `workspace`. `entitled` says whether they run here: always on a public repository, and on a private one with the Security and quality activation."
6598 },
6599 "list_custom_patterns_for_workspace": {
6600 "params": {
6601 "workspace": "flagon-io"
6602 },
6603 "response": {
6604 "patterns": [
6605 {
6606 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r",
6607 "scope": "workspace",
6608 "workspace": "flagon-io",
6609 "repo": null,
6610 "name": "Acme API key",
6611 "pattern": "acme_[a-z0-9]{32}",
6612 "before": null,
6613 "after": null,
6614 "test_strings": [
6615 "ACME_KEY=acme_0123456789abcdef0123456789abcdef"
6616 ],
6617 "state": "published",
6618 "created_by": "syntaqx",
6619 "created_at": "2026-10-06T09:14:02.118Z",
6620 "updated_by": "syntaqx",
6621 "updated_at": "2026-10-06T09:14:02.118Z",
6622 "open_alerts": 0
6623 }
6624 ],
6625 "entitled": true
6626 }
6627 },
6628 "create_custom_pattern": {
6629 "params": {
6630 "owner": "flagon-io",
6631 "name": "hello"
6632 },
6633 "request": {
6634 "pattern_name": "Acme API key",
6635 "pattern": "acme_[a-z0-9]{32}",
6636 "test_strings": [
6637 "ACME_KEY=acme_0123456789abcdef0123456789abcdef"
6638 ],
6639 "publish": true
6640 },
6641 "response": {
6642 "pattern": {
6643 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r",
6644 "scope": "repository",
6645 "workspace": "flagon-io",
6646 "repo": "hello",
6647 "name": "Acme API key",
6648 "pattern": "acme_[a-z0-9]{32}",
6649 "before": null,
6650 "after": null,
6651 "test_strings": [
6652 "ACME_KEY=acme_0123456789abcdef0123456789abcdef"
6653 ],
6654 "state": "published",
6655 "created_by": "syntaqx",
6656 "created_at": "2026-10-06T09:14:02.118Z",
6657 "updated_by": "syntaqx",
6658 "updated_at": "2026-10-06T09:14:02.118Z",
6659 "open_alerts": 0
6660 },
6661 "tests": [
6662 [
6663 9,
6664 46
6665 ]
6666 ]
6667 },
6668 "notes": "`tests` gives, for each test string, where the pattern matched (start and end, in characters), or `null`. A pattern that does not compile, matches an empty string, or is too complex is refused with `422` and says why."
6669 },
6670 "create_custom_pattern_for_workspace": {
6671 "params": {
6672 "workspace": "flagon-io"
6673 },
6674 "request": {
6675 "pattern_name": "Acme API key",
6676 "pattern": "acme_[a-z0-9]{32}",
6677 "publish": false
6678 },
6679 "response": {
6680 "pattern": {
6681 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r",
6682 "scope": "workspace",
6683 "workspace": "flagon-io",
6684 "repo": null,
6685 "name": "Acme API key",
6686 "pattern": "acme_[a-z0-9]{32}",
6687 "before": null,
6688 "after": null,
6689 "test_strings": [],
6690 "state": "draft",
6691 "created_by": "syntaqx",
6692 "created_at": "2026-10-06T09:14:02.118Z",
6693 "updated_by": "syntaqx",
6694 "updated_at": "2026-10-06T09:14:02.118Z",
6695 "open_alerts": 0
6696 },
6697 "tests": []
6698 }
6699 },
6700 "update_custom_pattern": {
6701 "params": {
6702 "owner": "flagon-io",
6703 "name": "hello",
6704 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r"
6705 },
6706 "request": {
6707 "pattern_name": "Acme API key",
6708 "pattern": "acme_[a-z0-9]{32,40}",
6709 "publish": true
6710 },
6711 "response": {
6712 "pattern": {
6713 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r",
6714 "scope": "repository",
6715 "workspace": "flagon-io",
6716 "repo": "hello",
6717 "name": "Acme API key",
6718 "pattern": "acme_[a-z0-9]{32,40}",
6719 "before": null,
6720 "after": null,
6721 "test_strings": [
6722 "ACME_KEY=acme_0123456789abcdef0123456789abcdef"
6723 ],
6724 "state": "published",
6725 "created_by": "syntaqx",
6726 "created_at": "2026-10-06T09:14:02.118Z",
6727 "updated_by": "syntaqx",
6728 "updated_at": "2026-10-06T09:14:02.118Z",
6729 "open_alerts": 0
6730 },
6731 "tests": [
6732 [
6733 9,
6734 46
6735 ]
6736 ]
6737 }
6738 },
6739 "update_custom_pattern_for_workspace": {
6740 "params": {
6741 "workspace": "flagon-io",
6742 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r"
6743 },
6744 "request": {
6745 "pattern_name": "Acme API key",
6746 "pattern": "acme_[a-z0-9]{32}",
6747 "publish": true
6748 },
6749 "response": {
6750 "pattern": {
6751 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r",
6752 "scope": "workspace",
6753 "workspace": "flagon-io",
6754 "repo": null,
6755 "name": "Acme API key",
6756 "pattern": "acme_[a-z0-9]{32}",
6757 "before": null,
6758 "after": null,
6759 "test_strings": [
6760 "ACME_KEY=acme_0123456789abcdef0123456789abcdef"
6761 ],
6762 "state": "published",
6763 "created_by": "syntaqx",
6764 "created_at": "2026-10-06T09:14:02.118Z",
6765 "updated_by": "syntaqx",
6766 "updated_at": "2026-10-06T09:14:02.118Z",
6767 "open_alerts": 0
6768 },
6769 "tests": [
6770 [
6771 9,
6772 46
6773 ]
6774 ]
6775 }
6776 },
6777 "delete_custom_pattern": {
6778 "params": {
6779 "owner": "flagon-io",
6780 "name": "hello",
6781 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r"
6782 },
6783 "response": {
6784 "deleted": true
6785 }
6786 },
6787 "delete_custom_pattern_for_workspace": {
6788 "params": {
6789 "workspace": "flagon-io",
6790 "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r"
6791 },
6792 "response": {
6793 "deleted": true
6794 }
6795 },
6796 "dry_run_custom_pattern": {
6797 "params": {
6798 "owner": "flagon-io",
6799 "name": "hello"
6800 },
6801 "request": {
6802 "pattern": "acme_[a-z0-9]{32}"
6803 },
6804 "response": {
6805 "repos": [
6806 {
6807 "name": "hello",
6808 "files_scanned": 214,
6809 "matches": [
6810 {
6811 "path": "config/dev.env",
6812 "line": 3,
6813 "preview": "ACME_KEY=acme_01••••••••••••••••••••••••"
6814 }
6815 ],
6816 "truncated": false,
6817 "commit": "4807077b296e6edbf410d55e72749d3e1170c291"
6818 }
6819 ]
6820 },
6821 "notes": "Reads up to 2,000 files and 20 MB of the default branch, skipping what secret scanning skips. Nothing is recorded."
6822 },
6823 "dry_run_custom_pattern_for_workspace": {
6824 "params": {
6825 "workspace": "flagon-io"
6826 },
6827 "request": {
6828 "pattern": "acme_[a-z0-9]{32}",
6829 "repos": [
6830 "hello"
6831 ]
6832 },
6833 "response": {
6834 "repos": [
6835 {
6836 "name": "hello",
6837 "files_scanned": 214,
6838 "matches": [],
6839 "truncated": false,
6840 "commit": "4807077b296e6edbf410d55e72749d3e1170c291"
6841 }
6842 ]
6843 }
6844 },
6845 "list_code_scanning_alerts": {
6846 "params": {
6847 "owner": "flagon-io",
6848 "name": "hello"
6849 },
6850 "query": {
6851 "state": "open",
6852 "severity": "high"
6853 },
6854 "response": [
6855 {
6856 "id": "cod_01kq2qag7h8j9k0m1n2p3q4r5s",
6857 "number": 4,
6858 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6859 "tool": "Semgrep OSS",
6860 "category": "Semgrep OSS",
6861 "rule_id": "javascript.lang.security.detect-child-process.detect-child-process",
6862 "rule_name": "javascript.lang.security.detect-child-process.detect-child-process",
6863 "rule_description": "Detected calls to child_process from a function argument.",
6864 "help": null,
6865 "help_uri": "https://semgrep.dev/r/javascript.lang.security.detect-child-process.detect-child-process",
6866 "tags": [
6867 "security",
6868 "CWE-78"
6869 ],
6870 "level": "error",
6871 "security_severity": null,
6872 "severity": "high",
6873 "message": "Detected calls to child_process from a function argument `req`. This could lead to a command injection.",
6874 "path": "src/server.js",
6875 "start_line": 6,
6876 "end_line": 6,
6877 "start_column": 3,
6878 "end_column": 60,
6879 "state": "open",
6880 "fingerprint": "3f1c9a0e7b2d4c5e6f708192a3b4c5d6",
6881 "first_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6882 "last_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6883 "created_at": "2026-10-06T09:14:02.118Z",
6884 "updated_at": "2026-10-06T09:14:02.118Z",
6885 "fixed_at": null,
6886 "dismissed_by": null,
6887 "dismissed_reason": null,
6888 "dismissed_comment": null,
6889 "dismissed_at": null,
6890 "issue": null
6891 }
6892 ],
6893 "notes": "`severity` is the rule's security severity when it has one (from its `security-severity` score), else from the result's level: `error` high, `warning` medium, `note` low."
6894 },
6895 "list_code_scanning_alerts_for_workspace": {
6896 "params": {
6897 "workspace": "flagon-io"
6898 },
6899 "query": {
6900 "state": "open"
6901 },
6902 "response": [
6903 {
6904 "repo": "hello",
6905 "code": {
6906 "id": "cod_01kq2qag7h8j9k0m1n2p3q4r5s",
6907 "number": 4,
6908 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6909 "tool": "Semgrep OSS",
6910 "category": "Semgrep OSS",
6911 "rule_id": "javascript.lang.security.detect-child-process.detect-child-process",
6912 "rule_name": "javascript.lang.security.detect-child-process.detect-child-process",
6913 "rule_description": "Detected calls to child_process from a function argument.",
6914 "help": null,
6915 "help_uri": "https://semgrep.dev/r/javascript.lang.security.detect-child-process.detect-child-process",
6916 "tags": [
6917 "security",
6918 "CWE-78"
6919 ],
6920 "level": "error",
6921 "security_severity": null,
6922 "severity": "high",
6923 "message": "Detected calls to child_process from a function argument `req`. This could lead to a command injection.",
6924 "path": "src/server.js",
6925 "start_line": 6,
6926 "end_line": 6,
6927 "start_column": 3,
6928 "end_column": 60,
6929 "state": "open",
6930 "fingerprint": "3f1c9a0e7b2d4c5e6f708192a3b4c5d6",
6931 "first_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6932 "last_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6933 "created_at": "2026-10-06T09:14:02.118Z",
6934 "updated_at": "2026-10-06T09:14:02.118Z",
6935 "fixed_at": null,
6936 "dismissed_by": null,
6937 "dismissed_reason": null,
6938 "dismissed_comment": null,
6939 "dismissed_at": null,
6940 "issue": null
6941 }
6942 }
6943 ]
6944 },
6945 "get_code_scanning_alert": {
6946 "params": {
6947 "owner": "flagon-io",
6948 "name": "hello",
6949 "number": 4
6950 },
6951 "response": {
6952 "alert": {
6953 "id": "cod_01kq2qag7h8j9k0m1n2p3q4r5s",
6954 "number": 4,
6955 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6956 "tool": "Semgrep OSS",
6957 "category": "Semgrep OSS",
6958 "rule_id": "javascript.lang.security.detect-child-process.detect-child-process",
6959 "rule_name": "javascript.lang.security.detect-child-process.detect-child-process",
6960 "rule_description": "Detected calls to child_process from a function argument.",
6961 "help": null,
6962 "help_uri": "https://semgrep.dev/r/javascript.lang.security.detect-child-process.detect-child-process",
6963 "tags": [
6964 "security",
6965 "CWE-78"
6966 ],
6967 "level": "error",
6968 "security_severity": null,
6969 "severity": "high",
6970 "message": "Detected calls to child_process from a function argument `req`. This could lead to a command injection.",
6971 "path": "src/server.js",
6972 "start_line": 6,
6973 "end_line": 6,
6974 "start_column": 3,
6975 "end_column": 60,
6976 "state": "open",
6977 "fingerprint": "3f1c9a0e7b2d4c5e6f708192a3b4c5d6",
6978 "first_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6979 "last_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
6980 "created_at": "2026-10-06T09:14:02.118Z",
6981 "updated_at": "2026-10-06T09:14:02.118Z",
6982 "fixed_at": null,
6983 "dismissed_by": null,
6984 "dismissed_reason": null,
6985 "dismissed_comment": null,
6986 "dismissed_at": null,
6987 "issue": null
6988 },
6989 "activity": [],
6990 "analyses": [
6991 {
6992 "id": "ana_01kq2rbh8j9k0m1n2p3q4r5s6t",
6993 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
6994 "sarif_id": "sar_01kq2scj9k0m1n2p3q4r5s6t7v",
6995 "tool": "Semgrep OSS",
6996 "tool_version": "1.140.0",
6997 "category": "Semgrep OSS",
6998 "commit_sha": "4807077b296e6edbf410d55e72749d3e1170c291",
6999 "git_ref": "refs/heads/main",
7000 "pull": null,
7001 "results": 7,
7002 "new_alerts": 2,
7003 "fixed_alerts": 1,
7004 "dropped": 0,
7005 "created_at": "2026-10-06T09:14:02.118Z"
7006 }
7007 ]
7008 }
7009 },
7010 "update_code_scanning_alert": {
7011 "params": {
7012 "owner": "flagon-io",
7013 "name": "hello",
7014 "number": 4
7015 },
7016 "request": {
7017 "state": "dismissed",
7018 "dismissed_reason": "false_positive",
7019 "dismissed_comment": "The argument is a constant."
7020 },
7021 "response": {
7022 "id": "cod_01kq2qag7h8j9k0m1n2p3q4r5s",
7023 "number": 4,
7024 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
7025 "tool": "Semgrep OSS",
7026 "category": "Semgrep OSS",
7027 "rule_id": "javascript.lang.security.detect-child-process.detect-child-process",
7028 "rule_name": "javascript.lang.security.detect-child-process.detect-child-process",
7029 "rule_description": "Detected calls to child_process from a function argument.",
7030 "help": null,
7031 "help_uri": "https://semgrep.dev/r/javascript.lang.security.detect-child-process.detect-child-process",
7032 "tags": [
7033 "security",
7034 "CWE-78"
7035 ],
7036 "level": "error",
7037 "security_severity": null,
7038 "severity": "high",
7039 "message": "Detected calls to child_process from a function argument `req`. This could lead to a command injection.",
7040 "path": "src/server.js",
7041 "start_line": 6,
7042 "end_line": 6,
7043 "start_column": 3,
7044 "end_column": 60,
7045 "state": "dismissed",
7046 "fingerprint": "3f1c9a0e7b2d4c5e6f708192a3b4c5d6",
7047 "first_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
7048 "last_commit": "4807077b296e6edbf410d55e72749d3e1170c291",
7049 "created_at": "2026-10-06T09:14:02.118Z",
7050 "updated_at": "2026-10-06T09:14:02.118Z",
7051 "fixed_at": null,
7052 "dismissed_by": "syntaqx",
7053 "dismissed_reason": "false_positive",
7054 "dismissed_comment": "The argument is a constant.",
7055 "dismissed_at": "2026-10-06T09:20:41.502Z",
7056 "issue": null
7057 }
7058 },
7059 "list_code_scanning_analyses": {
7060 "params": {
7061 "owner": "flagon-io",
7062 "name": "hello"
7063 },
7064 "response": [
7065 {
7066 "id": "ana_01kq2rbh8j9k0m1n2p3q4r5s6t",
7067 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
7068 "sarif_id": "sar_01kq2scj9k0m1n2p3q4r5s6t7v",
7069 "tool": "Semgrep OSS",
7070 "tool_version": "1.140.0",
7071 "category": "Semgrep OSS",
7072 "commit_sha": "4807077b296e6edbf410d55e72749d3e1170c291",
7073 "git_ref": "refs/heads/main",
7074 "pull": null,
7075 "results": 7,
7076 "new_alerts": 2,
7077 "fixed_alerts": 1,
7078 "dropped": 0,
7079 "created_at": "2026-10-06T09:14:02.118Z"
7080 }
7081 ]
7082 },
7083 "upload_sarif": {
7084 "params": {
7085 "owner": "flagon-io",
7086 "name": "hello"
7087 },
7088 "request": {
7089 "commit_sha": "4807077b296e6edbf410d55e72749d3e1170c291",
7090 "ref": "refs/heads/main",
7091 "sarif": "H4sIAAAAAAAA…",
7092 "checkout_uri": "file:///home/runner/work/repo"
7093 },
7094 "response": {
7095 "id": "sar_01kq2scj9k0m1n2p3q4r5s6t7v",
7096 "processing_status": "complete",
7097 "analyses": [
7098 "ana_01kq2rbh8j9k0m1n2p3q4r5s6t"
7099 ],
7100 "errors": [],
7101 "commit_sha": "4807077b296e6edbf410d55e72749d3e1170c291",
7102 "git_ref": "refs/heads/main",
7103 "created_at": "2026-10-06T09:14:02.118Z"
7104 },
7105 "notes": "`sarif` is the SARIF 2.1.0 file gzipped, then base64-encoded: `gzip -c results.sarif | base64 -w0`. The upload is read at once: `processing_status` is `complete` or `failed`, with `errors` saying why. For `refs/pull/<number>/head`, the results become the pull request's `Code scanning` check instead of alerts."
7106 },
7107 "get_sarif_upload": {
7108 "params": {
7109 "owner": "flagon-io",
7110 "name": "hello",
7111 "id": "sar_01kq2scj9k0m1n2p3q4r5s6t7v"
7112 },
7113 "response": {
7114 "id": "sar_01kq2scj9k0m1n2p3q4r5s6t7v",
7115 "processing_status": "complete",
7116 "analyses": [
7117 "ana_01kq2rbh8j9k0m1n2p3q4r5s6t"
7118 ],
7119 "errors": [],
7120 "commit_sha": "4807077b296e6edbf410d55e72749d3e1170c291",
7121 "git_ref": "refs/heads/main",
7122 "created_at": "2026-10-06T09:14:02.118Z"
7123 }
7124 },
7125 "list_vulnerability_alerts": {
7126 "params": {
7127 "owner": "flagon-io",
7128 "name": "hello"
7129 },
7130 "query": {
7131 "state": "open"
7132 },
7133 "response": [
7134 {
7135 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n",
7136 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
7137 "ecosystem": "npm",
7138 "package": "lodash",
7139 "version": "4.17.20",
7140 "manifest": "package-lock.json",
7141 "advisory": "GHSA-35jh-r3h4-6jhm",
7142 "osv_id": "GHSA-35jh-r3h4-6jhm",
7143 "summary": "Command Injection in lodash",
7144 "severity": "high",
7145 "fixed_version": "4.17.21",
7146 "status": "open",
7147 "issue": null,
7148 "found_at": "2026-10-06T09:14:02.118Z",
7149 "fixed_at": null,
7150 "state": "open",
7151 "dismissed_by": null,
7152 "dismissed_reason": null,
7153 "dismissed_comment": null,
7154 "dismissed_at": null,
7155 "update": null
7156 }
7157 ]
7158 },
7159 "list_vulnerability_alerts_for_workspace": {
7160 "params": {
7161 "workspace": "flagon-io"
7162 },
7163 "query": {
7164 "severity": "critical"
7165 },
7166 "response": [
7167 {
7168 "repo": "hello",
7169 "vulnerability": {
7170 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n",
7171 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
7172 "ecosystem": "npm",
7173 "package": "lodash",
7174 "version": "4.17.20",
7175 "manifest": "package-lock.json",
7176 "advisory": "GHSA-35jh-r3h4-6jhm",
7177 "osv_id": "GHSA-35jh-r3h4-6jhm",
7178 "summary": "Command Injection in lodash",
7179 "severity": "high",
7180 "fixed_version": "4.17.21",
7181 "status": "open",
7182 "issue": null,
7183 "found_at": "2026-10-06T09:14:02.118Z",
7184 "fixed_at": null,
7185 "state": "open",
7186 "dismissed_by": null,
7187 "dismissed_reason": null,
7188 "dismissed_comment": null,
7189 "dismissed_at": null,
7190 "update": null
7191 }
7192 }
7193 ]
7194 },
7195 "get_vulnerability_alert": {
7196 "params": {
7197 "owner": "flagon-io",
7198 "name": "hello",
7199 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n"
7200 },
7201 "response": {
7202 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n",
7203 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
7204 "ecosystem": "npm",
7205 "package": "lodash",
7206 "version": "4.17.20",
7207 "manifest": "package-lock.json",
7208 "advisory": "GHSA-35jh-r3h4-6jhm",
7209 "osv_id": "GHSA-35jh-r3h4-6jhm",
7210 "summary": "Command Injection in lodash",
7211 "severity": "high",
7212 "fixed_version": "4.17.21",
7213 "status": "open",
7214 "issue": null,
7215 "found_at": "2026-10-06T09:14:02.118Z",
7216 "fixed_at": null,
7217 "state": "open",
7218 "dismissed_by": null,
7219 "dismissed_reason": null,
7220 "dismissed_comment": null,
7221 "dismissed_at": null,
7222 "update": null
7223 }
7224 },
7225 "update_vulnerability_alert": {
7226 "params": {
7227 "owner": "flagon-io",
7228 "name": "hello",
7229 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n"
7230 },
7231 "request": {
7232 "state": "dismissed",
7233 "reason": "tolerable_risk",
7234 "comment": "Only the build uses it."
7235 },
7236 "response": {
7237 "id": "vul_01kp4b8c3d4e5f6g7h8j9k0m1n",
7238 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
7239 "ecosystem": "npm",
7240 "package": "lodash",
7241 "version": "4.17.20",
7242 "manifest": "package-lock.json",
7243 "advisory": "GHSA-35jh-r3h4-6jhm",
7244 "osv_id": "GHSA-35jh-r3h4-6jhm",
7245 "summary": "Command Injection in lodash",
7246 "severity": "high",
7247 "fixed_version": "4.17.21",
7248 "status": "dismissed",
7249 "issue": null,
7250 "found_at": "2026-10-06T09:14:02.118Z",
7251 "fixed_at": null,
7252 "state": "dismissed",
7253 "dismissed_by": "syntaqx",
7254 "dismissed_reason": "tolerable_risk",
7255 "dismissed_comment": "Only the build uses it.",
7256 "dismissed_at": "2026-10-06T09:20:41.502Z",
7257 "update": null
7258 }
7259 },
7260 "fix_security_alert": {
7261 "params": {
7262 "owner": "flagon-io",
7263 "name": "hello",
7264 "id": "cod_01kq2qag7h8j9k0m1n2p3q4r5s"
7265 },
7266 "response": {
7267 "issue": 57,
7268 "started": true,
7269 "message": null
7270 },
7271 "notes": "Opens an issue with what is wrong and what done means, and puts g1t on it as you. Its run is charged as agent usage, and its pull request lands through the repository's required checks. Asking again while the issue is open returns it."
7272 },
7273 "get_dependency_graph": {
7274 "params": {
7275 "owner": "flagon-io",
7276 "name": "hello"
7277 },
7278 "response": {
7279 "commit": "4807077b296e6edbf410d55e72749d3e1170c291",
7280 "manifests": [
7281 {
7282 "path": "package-lock.json",
7283 "ecosystem": "npm",
7284 "dependencies": 2,
7285 "direct": 1
7286 }
7287 ],
7288 "dependencies": [
7289 {
7290 "ecosystem": "npm",
7291 "name": "lodash",
7292 "version": "4.17.20",
7293 "manifest": "package-lock.json",
7294 "relationship": "direct",
7295 "development": false,
7296 "license": "MIT",
7297 "purl": "pkg:npm/lodash@4.17.20",
7298 "vulnerabilities": 1
7299 },
7300 {
7301 "ecosystem": "npm",
7302 "name": "ms",
7303 "version": "2.1.3",
7304 "manifest": "package-lock.json",
7305 "relationship": "transitive",
7306 "development": false,
7307 "license": "MIT",
7308 "purl": "pkg:npm/ms@2.1.3",
7309 "vulnerabilities": 0
7310 }
7311 ]
7312 }
7313 },
7314 "get_sbom": {
7315 "params": {
7316 "owner": "flagon-io",
7317 "name": "hello"
7318 },
7319 "response": {
7320 "sbom": {
7321 "spdxVersion": "SPDX-2.3",
7322 "dataLicense": "CC0-1.0",
7323 "SPDXID": "SPDXRef-DOCUMENT",
7324 "name": "flagon-io/hello dependency graph",
7325 "documentNamespace": "https://g1t.sh/flagon-io/hello/sbom/sbom_01kq2tdk0m1n2p3q4r5s6t7v8w",
7326 "creationInfo": {
7327 "created": "2026-10-06T09:14:02Z",
7328 "creators": [
7329 "Tool: g1t",
7330 "Organization: g1t"
7331 ],
7332 "comment": "Read from the repository's lockfiles on its default branch."
7333 },
7334 "documentDescribes": [
7335 "SPDXRef-Repository-flagon-io-hello"
7336 ],
7337 "packages": [
7338 {
7339 "SPDXID": "SPDXRef-Repository-flagon-io-hello",
7340 "name": "flagon-io/hello",
7341 "versionInfo": "4807077b296e6edbf410d55e72749d3e1170c291",
7342 "downloadLocation": "git+https://g1t.sh/flagon-io/hello.git",
7343 "filesAnalyzed": false,
7344 "licenseConcluded": "NOASSERTION",
7345 "licenseDeclared": "NOASSERTION",
7346 "copyrightText": "NOASSERTION",
7347 "primaryPackagePurpose": "SOURCE",
7348 "externalRefs": []
7349 },
7350 {
7351 "SPDXID": "SPDXRef-Package-npm-lodash-4.17.20",
7352 "name": "lodash",
7353 "versionInfo": "4.17.20",
7354 "downloadLocation": "NOASSERTION",
7355 "filesAnalyzed": false,
7356 "licenseConcluded": "NOASSERTION",
7357 "licenseDeclared": "MIT",
7358 "copyrightText": "NOASSERTION",
7359 "primaryPackagePurpose": "LIBRARY",
7360 "comment": "Resolved by package-lock.json (direct dependency).",
7361 "externalRefs": [
7362 {
7363 "referenceCategory": "PACKAGE-MANAGER",
7364 "referenceType": "purl",
7365 "referenceLocator": "pkg:npm/lodash@4.17.20"
7366 }
7367 ]
7368 }
7369 ],
7370 "relationships": [
7371 {
7372 "spdxElementId": "SPDXRef-DOCUMENT",
7373 "relationshipType": "DESCRIBES",
7374 "relatedSpdxElement": "SPDXRef-Repository-flagon-io-hello"
7375 },
7376 {
7377 "spdxElementId": "SPDXRef-Repository-flagon-io-hello",
7378 "relationshipType": "DEPENDS_ON",
7379 "relatedSpdxElement": "SPDXRef-Package-npm-lodash-4.17.20"
7380 }
7381 ]
7382 }
7383 },
7384 "notes": "`sbom` is an SPDX 2.3 JSON document, sent as SPDX spells it. Save it with `jq .sbom`."
7385 },
7386 "compare_dependencies": {
7387 "params": {
7388 "owner": "flagon-io",
7389 "name": "hello",
7390 "basehead": "main...upgrade-deps"
7391 },
7392 "response": {
7393 "base": "main",
7394 "head": "upgrade-deps",
7395 "changes": [
7396 {
7397 "change_type": "added",
7398 "manifest": "package-lock.json",
7399 "ecosystem": "npm",
7400 "name": "lodash",
7401 "version": "4.17.20",
7402 "relationship": "direct",
7403 "development": false,
7404 "license": "MIT",
7405 "purl": "pkg:npm/lodash@4.17.20",
7406 "vulnerabilities": [
7407 {
7408 "advisory": "GHSA-35jh-r3h4-6jhm",
7409 "osv_id": "GHSA-35jh-r3h4-6jhm",
7410 "summary": "Command Injection in lodash",
7411 "severity": "high",
7412 "fixed_version": "4.17.21",
7413 "url": "https://osv.dev/vulnerability/GHSA-35jh-r3h4-6jhm"
7414 }
7415 ],
7416 "denied_license": false,
7417 "failing": true
7418 },
7419 {
7420 "change_type": "removed",
7421 "manifest": "package-lock.json",
7422 "ecosystem": "npm",
7423 "name": "lodash",
7424 "version": "4.17.21",
7425 "relationship": "direct",
7426 "development": false,
7427 "license": "MIT",
7428 "purl": "pkg:npm/lodash@4.17.21",
7429 "vulnerabilities": [],
7430 "denied_license": false,
7431 "failing": false
7432 }
7433 ],
7434 "passed": false,
7435 "headline": "Adds 1 vulnerable package",
7436 "fail_on": "high",
7437 "deny_licenses": []
7438 }
7439 },
7440 "get_security_settings": {
7441 "params": {
7442 "owner": "flagon-io",
7443 "name": "hello"
7444 },
7445 "response": {
7446 "settings": {
7447 "code_scanning_gate": "high",
7448 "dependency_review": true,
7449 "review_fail_on": "high",
7450 "review_deny_licenses": [
7451 "AGPL-3.0-only"
7452 ],
7453 "review_comment": true
7454 },
7455 "workspace": {
7456 "delegated_bypass": true,
7457 "validity_checks": true
7458 },
7459 "private": true,
7460 "entitled": true,
7461 "upkeep": true
7462 }
7463 },
7464 "update_security_settings": {
7465 "params": {
7466 "owner": "flagon-io",
7467 "name": "hello"
7468 },
7469 "request": {
7470 "code_scanning_gate": "high",
7471 "review_deny_licenses": [
7472 "AGPL-3.0-only"
7473 ]
7474 },
7475 "response": {
7476 "settings": {
7477 "code_scanning_gate": "high",
7478 "dependency_review": true,
7479 "review_fail_on": "high",
7480 "review_deny_licenses": [
7481 "AGPL-3.0-only"
7482 ],
7483 "review_comment": true
7484 },
7485 "workspace": {
7486 "delegated_bypass": true,
7487 "validity_checks": true
7488 },
7489 "private": true,
7490 "entitled": true,
7491 "upkeep": true
7492 },
7493 "notes": "Only what you send changes. The `Code scanning` and `Dependency review` checks gate merges once you require them in branch protection."
7494 },
7495 "get_workspace_security_settings": {
7496 "params": {
7497 "workspace": "flagon-io"
7498 },
7499 "response": {
7500 "settings": {
7501 "delegated_bypass": true,
7502 "validity_checks": true
7503 },
7504 "activated": true
7505 }
7506 },
7507 "update_workspace_security_settings": {
7508 "params": {
7509 "workspace": "flagon-io"
7510 },
7511 "request": {
7512 "delegated_bypass": true
7513 },
7514 "response": {
7515 "settings": {
7516 "delegated_bypass": true,
7517 "validity_checks": true
7518 },
7519 "activated": true
7520 }
7521 },
7522 "get_security_overview": {
7523 "params": {
7524 "workspace": "flagon-io"
7525 },
7526 "query": {
7527 "days": "30"
7528 },
7529 "response": {
7530 "activated": true,
7531 "private_hidden": 0,
7532 "totals": [
7533 {
7534 "alert_type": "secret_scanning",
7535 "open": {
7536 "critical": 1,
7537 "high": 0,
7538 "medium": 0,
7539 "low": 0,
7540 "unknown": 0
7541 },
7542 "opened": 2,
7543 "closed": 1
7544 },
7545 {
7546 "alert_type": "code_scanning",
7547 "open": {
7548 "critical": 0,
7549 "high": 3,
7550 "medium": 4,
7551 "low": 0,
7552 "unknown": 0
7553 },
7554 "opened": 7,
7555 "closed": 2
7556 },
7557 {
7558 "alert_type": "vulnerability",
7559 "open": {
7560 "critical": 0,
7561 "high": 1,
7562 "medium": 2,
7563 "low": 1,
7564 "unknown": 0
7565 },
7566 "opened": 3,
7567 "closed": 5
7568 }
7569 ],
7570 "trend": [
7571 {
7572 "day": "2026-10-05",
7573 "secret_scanning": 1,
7574 "code_scanning": 8,
7575 "vulnerability": 6
7576 },
7577 {
7578 "day": "2026-10-06",
7579 "secret_scanning": 1,
7580 "code_scanning": 7,
7581 "vulnerability": 4
7582 }
7583 ],
7584 "repos": [
7585 {
7586 "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m",
7587 "name": "hello",
7588 "private": true,
7589 "custom_patterns": 1,
7590 "validity_checks": true,
7591 "code_scanning_at": "2026-10-06T09:14:02.118Z",
7592 "dependency_review": true,
7593 "security_updates": true,
7594 "lockfiles": 1,
7595 "secrets": {
7596 "critical": 1,
7597 "high": 0,
7598 "medium": 0,
7599 "low": 0,
7600 "unknown": 0
7601 },
7602 "code": {
7603 "critical": 0,
7604 "high": 3,
7605 "medium": 4,
7606 "low": 0,
7607 "unknown": 0
7608 },
7609 "vulnerabilities": {
7610 "critical": 0,
7611 "high": 1,
7612 "medium": 2,
7613 "low": 1,
7614 "unknown": 0
7615 }
7616 }
7617 ]
7618 }
7619 },
7620 "create_label": {
7621 "request": {
7622 "label": "area: cli",
7623 "color": "1d76db",
7624 "description": "The command-line tool"
7625 },
7626 "response": {
7627 "name": "area: cli",
7628 "color": "1d76db",
7629 "description": "The command-line tool",
7630 "issues": 0,
7631 "pulls": 0
7632 }
7633 },
7634 "update_label": {
7635 "params": {
7636 "label": "area: cli"
7637 },
7638 "request": {
7639 "new_name": "cli",
7640 "color": "0052cc"
7641 },
7642 "response": {
7643 "name": "cli",
7644 "color": "0052cc",
7645 "description": "The command-line tool",
7646 "issues": 3,
7647 "pulls": 1
7648 },
7649 "notes": "Renaming a label renames it on every issue and pull request that carries it."
7650 },
7651 "delete_label": {
7652 "params": {
7653 "label": "wontfix"
7654 },
7655 "response": true
7656 },
7657 "add_default_labels": {
7658 "response": [
7659 {
7660 "name": "bug",
7661 "color": "d73a4a",
7662 "description": "Something isn't working",
7663 "issues": 4,
7664 "pulls": 1
7665 },
7666 {
7667 "name": "documentation",
7668 "color": "0075ca",
7669 "description": "Improvements or additions to documentation",
7670 "issues": 0,
7671 "pulls": 0
7672 }
7673 ],
7674 "notes": "Every label the repository has afterwards, shortened here. Labels it already had are left as they were."
7675 },
7676 "list_issue_labels": {
7677 "response": [
7678 {
7679 "name": "bug",
7680 "color": "d73a4a",
7681 "description": "Something isn't working",
7682 "issues": 4,
7683 "pulls": 1
7684 },
7685 {
7686 "name": "help wanted",
7687 "color": "008672",
7688 "description": "Extra attention is needed",
7689 "issues": 1,
7690 "pulls": 0
7691 }
7692 ]
7693 },
7694 "add_issue_labels": {
7695 "request": {
7696 "labels": [
7697 "help wanted"
7698 ]
7699 },
7700 "response": [
7701 "bug",
7702 "help wanted"
7703 ],
7704 "notes": "Returns its labels now, by name."
7705 },
7706 "set_issue_labels": {
7707 "request": {
7708 "labels": [
7709 "bug"
7710 ]
7711 },
7712 "response": [
7713 "bug"
7714 ]
7715 },
7716 "remove_issue_labels": {
7717 "response": []
7718 },
7719 "remove_issue_label": {
7720 "params": {
7721 "label": "help wanted"
7722 },
7723 "response": [
7724 "bug"
7725 ]
7726 },
7727 "list_milestones": {
7728 "response": [
7729 {
7730 "number": 3,
7731 "title": "Launch",
7732 "description": "Everything that has to land before the launch on October 14.",
7733 "due_on": "2026-10-14",
7734 "state": "open",
7735 "open_items": 5,
7736 "closed_items": 12,
7737 "created_at": "2026-09-20T09:00:00.000Z",
7738 "updated_at": "2026-10-06T16:12:40.118Z",
7739 "closed_at": null
7740 }
7741 ],
7742 "notes": "Open milestones soonest due first, then closed ones. Progress is closed_items out of open_items plus closed_items."
7743 },
7744 "create_milestone": {
7745 "request": {
7746 "title": "Launch",
7747 "description": "Everything that has to land before the launch on October 14.",
7748 "due_on": "2026-10-14"
7749 },
7750 "response": {
7751 "number": 3,
7752 "title": "Launch",
7753 "description": "Everything that has to land before the launch on October 14.",
7754 "due_on": "2026-10-14",
7755 "state": "open",
7756 "open_items": 0,
7757 "closed_items": 0,
7758 "created_at": "2026-09-20T09:00:00.000Z",
7759 "updated_at": "2026-09-20T09:00:00.000Z",
7760 "closed_at": null
7761 }
7762 },
7763 "update_milestone": {
7764 "params": {
7765 "milestone": 3
7766 },
7767 "request": {
7768 "state": "closed"
7769 },
7770 "response": {
7771 "number": 3,
7772 "title": "Launch",
7773 "description": "Everything that has to land before the launch on October 14.",
7774 "due_on": "2026-10-14",
7775 "state": "closed",
7776 "open_items": 0,
7777 "closed_items": 17,
7778 "created_at": "2026-09-20T09:00:00.000Z",
7779 "updated_at": "2026-10-14T18:00:00.000Z",
7780 "closed_at": "2026-10-14T18:00:00.000Z"
7781 }
7782 },
7783 "delete_milestone": {
7784 "params": {
7785 "milestone": 3
7786 },
7787 "response": true
7788 },
7789 "get_milestone": {
7790 "params": {
7791 "milestone": 3
7792 },
7793 "response": {
7794 "milestone": {
7795 "number": 3,
7796 "title": "Launch",
7797 "description": "Everything that has to land before the launch on October 14.",
7798 "due_on": "2026-10-14",
7799 "state": "open",
7800 "open_items": 5,
7801 "closed_items": 12,
7802 "created_at": "2026-09-20T09:00:00.000Z",
7803 "updated_at": "2026-10-06T16:12:40.118Z",
7804 "closed_at": null
7805 },
7806 "issues": [
7807 {
7808 "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
7809 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
7810 "number": 12,
7811 "title": "Greeting should name the caller",
7812 "body": "Take a name from the first argument; fall back to world.",
7813 "labels": [
7814 "feature",
7815 "good first issue"
7816 ],
7817 "state": "open",
7818 "reason": null,
7819 "resolved_by": null,
7820 "author": {
7821 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
7822 "username": "syntaqx",
7823 "kind": "user",
7824 "verified": false,
7825 "workspaces": []
7826 },
7827 "requested_by": null,
7828 "created_at": "2026-10-01T18:04:11.482Z",
7829 "updated_at": "2026-10-01T18:09:47.305Z",
7830 "closed_at": null,
7831 "pull_count": 0,
7832 "comment_count": 0,
7833 "assignees": [
7834 "syntaqx"
7835 ],
7836 "blocked_by": [],
7837 "queued": false,
7838 "agent": null,
7839 "milestone": {
7840 "number": 3,
7841 "title": "Launch"
7842 }
7843 }
7844 ],
7845 "pulls": [
7846 {
7847 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
7848 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
7849 "number": 14,
7850 "issue": 12,
7851 "title": "Greeting should name the caller",
7852 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
7853 "agent": "claude-code",
7854 "runtime": "external",
7855 "status": "open",
7856 "fork": {
7857 "namespace": "pulls",
7858 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
7859 },
7860 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
7861 "branch": null,
7862 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
7863 "merge_base": null,
7864 "merged_by": null,
7865 "merged_at": null,
7866 "superseded_by": null,
7867 "check_status": "passed",
7868 "files": [
7869 {
7870 "path": "src/main.rs",
7871 "additions": 6,
7872 "deletions": 2
7873 }
7874 ],
7875 "assignees": [],
7876 "reviewers": [
7877 "ana"
7878 ],
7879 "labels": [],
7880 "milestone": {
7881 "number": 3,
7882 "title": "Launch"
7883 },
7884 "base": "main",
7885 "author": {
7886 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
7887 "username": "syntaqx",
7888 "kind": "user",
7889 "verified": false,
7890 "workspaces": []
7891 },
7892 "requested_by": null,
7893 "created_at": "2026-10-01T18:20:02.117Z",
7894 "updated_at": "2026-10-01T18:35:44.902Z",
7895 "confidence": null
7896 }
7897 ]
7898 }
7899 },
7900 "update_pull_request": {
7901 "request": {
7902 "base": "release/1.x",
7903 "labels": [
7904 "bug"
7905 ]
7906 },
7907 "response": {
7908 "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
7909 "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
7910 "number": 14,
7911 "issue": 12,
7912 "title": "Greeting should name the caller",
7913 "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
7914 "agent": "claude-code",
7915 "runtime": "external",
7916 "status": "open",
7917 "fork": {
7918 "namespace": "pulls",
7919 "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
7920 },
7921 "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
7922 "branch": null,
7923 "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
7924 "merge_base": null,
7925 "merged_by": null,
7926 "merged_at": null,
7927 "superseded_by": null,
7928 "check_status": "passed",
7929 "files": [
7930 {
7931 "path": "src/main.rs",
7932 "additions": 6,
7933 "deletions": 2
7934 }
7935 ],
7936 "assignees": [],
7937 "reviewers": [
7938 "ana"
7939 ],
7940 "labels": [
7941 "bug"
7942 ],
7943 "milestone": null,
7944 "base": "release/1.x",
7945 "author": {
7946 "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
7947 "username": "syntaqx",
7948 "kind": "user",
7949 "verified": false,
7950 "workspaces": []
7951 },
7952 "requested_by": null,
7953 "created_at": "2026-10-01T18:20:02.117Z",
7954 "updated_at": "2026-10-01T18:35:44.902Z",
7955 "confidence": null
7956 },
7957 "notes": "A new base takes it out of the merge queue, and whether it is behind, merges cleanly and has the checks it needs is worked out against the new base."
Merge branch 'worktree-agent-ab2e39e11a6493412'7958 }
7959}

This file's history is long; its oldest lines are credited to the oldest commit read.