Invitations · acceptInvitation

Accept an invitation

POST /v1/invitations/accept

The signed-in human joins the workspace with the invited role; their email must be the invited one, and verified (a magic-link sign-in or the confirmation link verifies it: POST /api/auth/verify-email sends one). An unverified email is a 403 email_not_verified. An invitation as Owner also needs the account to own fewer shared workspaces than an account may (402; the invitation stays pending).

Who may call it

any signed-in human

Server

https://api.logu.dev

Request body#

Content type application/json (required).

The token from the invitation link. Strict.

{
  "token": "Zk3mP9qR2sT5vW8yA1bC4dE7fG0hJ3kL"
}

Example#

curl -s -X POST "https://api.logu.dev/v1/invitations/accept" \
  -H "Authorization: Bearer $LOGU_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"token":"Zk3mP9qR2sT5vW8yA1bC4dE7fG0hJ3kL"}'

Responses#

200

The workspace joined.

{
  "workspace": {
    "id": "wsp_01K7D7Y8Z0B2D4F6H8K0M2P4R6",
    "name": "Acme ops",
    "personal": false,
    "role": "viewer",
    "plan": "pro",
    "createdAt": "2026-10-02T12:00:00.000Z"
  }
}

Errors#

Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.