---
title: "Accept a workspace invite"
method: POST
path: "/invites/accept"
tags: ["Gateway"]
---

# Accept a workspace invite

`POST /invites/accept`

## Request

- Base URL: `https://api.phaseo.app/v1`
- URL: `https://api.phaseo.app/v1/invites/accept`
- Auth: HTTP bearer

Asks to join the workspace an invite code belongs to. A workspace owner or admin then approves or rejects the request. OAuth token with workspaces:write required; management keys are refused because they belong to a workspace, not a person.

## Request body

- WorkspaceInviteAcceptRequest
  - `token` string, required: The invite code.

## Response `201`

Join request created

- MyJoinRequestCreatedResponse
  - `data` object, required
    - `id` string
    - `workspace_id` string
    - `status` string
    - `created_at` string, date-time

## Other responses

- `400`: Missing invite code
- `403`: Not an OAuth user token, or token lacks workspaces:write
- `404`: Invalid or expired invite
- `409`: Already a member, or a request is already pending

## Changes

- **2026-10-28** `72ba9c856a2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/invites/accept/post.md)

---

[API](https://skmtc.dev/phaseo/apis/phaseo-gateway-api.md) - [All operations](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/revisions/5ca9bb220d25?raw)