Skip to content
GET/user/invites

While g1t is invite-only, every new account needs an invite code. You may have 5 invites out at once: pending and used ones count, and one revoked or expired before it was used comes back. allowance.limit is null when you have no limit. workspaces lists the workspaces you own that were granted invites to share. A pending invite’s code is shown to you; status is pending, redeemed, expired or revoked.

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.

curl https://api.g1t.sh/user/invites \
-H "Authorization: Bearer $G1T_TOKEN"

A successful request answers 200 with:

{
"mode": "invite",
"allowance": {
"limit": 5,
"used": 2,
"remaining": 3
},
"workspaces": [
{
"slug": "acme-labs",
"allowance": {
"limit": 20,
"used": 4,
"remaining": 16
}
}
],
"invites": [
{
"id": "inv_01kp2x7m8n9q0r1s2t3v4w5x6y",
"code": "g1t-k7m2-q9xd-4hpw-…",
"hint": "g1t-k7m2",
"email": "ada@example.com",
"kind": "account",
"workspace": null,
"status": "pending",
"charged_to": "user",
"invited_by": "syntaqx",
"redeemed_by": null,
"created_at": "2026-10-05T17:00:00.000Z",
"expires_at": "2026-11-04T17:00:00.000Z",
"redeemed_at": null,
"revoked_at": null
},
{
"id": "inv_01kp1v3c4d5e6f7g8h9j0k1m2n",
"code": null,
"hint": "g1t-p3rt",
"email": null,
"kind": "account",
"workspace": null,
"status": "redeemed",
"charged_to": "user",
"invited_by": "syntaqx",
"redeemed_by": "grace",
"created_at": "2026-10-02T09:12:40.000Z",
"expires_at": "2026-11-01T09:12:40.000Z",
"redeemed_at": "2026-10-02T11:30:05.000Z",
"revoked_at": null
}
]
}

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

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