# invites.accept

> POST https://app.intraface.cc/api/v1/invites/accept

A signed-in person (Clerk session cookie). Agent tokens are refused. Body limit: 256 KB.

**Auth:** signed-in session (`__session` cookie)

## Request body (application/json)

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "minLength": 20,
      "maxLength": 200
    }
  },
  "required": [
    "token"
  ]
}
```

## Responses

### 200: Success.

application/json:

```json
{
  "type": "object",
  "properties": {
    "board_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "role": {
      "type": "string",
      "enum": [
        "owner",
        "editor",
        "contributor",
        "commenter",
        "viewer"
      ]
    },
    "already_member": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "board_id",
    "role"
  ]
}
```

### default

Any other error, in the shared envelope `{ error: { code, message, hint?, details? } }`.
