Skip to content
Graft Docs

Team

Invite people and manage seats. Owner only.

GET /api/v1/team

Section titled “GET /api/v1/team”

Members, pending invites and seats (used and limit). Owner only.

Auth: Bearer token

POST /api/v1/team/invites

Section titled “POST /api/v1/team/invites”

Create an invite link as owner. The raw token appears once, inside url, and is never stored. Invites expire after 7 days. Seat arithmetic: members plus pending invites must stay under the plan’s seat limit, else 403 QUOTA_EXCEEDED with details.meter = "seats".

Auth: Bearer token

Request body

{
  "role": "member",
  "email": "sam@example.com"
}

Response

{
  "data": {
    "invite": {
      "id": "…",
      "role": "member",
      "email": "sam@example.com",
      "expiresAt": "…"
    },
    "url": "https://…/invite/<token>"
  }
}

DELETE /api/v1/team/invites/:inviteId

Section titled “DELETE /api/v1/team/invites/:inviteId”

Revoke a pending invite. Returns 204.

Auth: Bearer token · Path parameters: inviteId

POST /api/v1/team/invites/accept

Section titled “POST /api/v1/team/invites/accept”

A signed-in user takes the seat an invite offers.

Auth: Bearer token

Request body

{
  "token": "…"
}

DELETE /api/v1/team/members/:userId

Section titled “DELETE /api/v1/team/members/:userId”

Remove someone from the workspace. Returns 204. The owner can’t remove themselves.

Auth: Bearer token · Path parameters: userId