# Ask for access to a board

> Page: https://docs.plotwork.dev/api/post-user-boards-board-access-requests. Index of every page: https://docs.plotwork.dev/llms.txt

Asks the people who manage the board to let the caller open it, with an optional note.

`POST /user/boards/{board}/access-requests`

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | Ask for access to a board. |
| What does it take? | A JSON body of type [`BoardAccessRequestBody`](https://docs.plotwork.dev/api/schemas.md#boardaccessrequestbody). |
| What does it return? | Status 202 with no body. |
| What can go wrong? | `400` the body is not valid; `401` not signed in; `429` too many requests; `503` organisations or boards are not set up on this server. Every failure uses the one error envelope. |

## What it does

Asks the people who manage the board to let the caller open it, with an optional note. The answer is 202 whether the board exists or not, so it reveals nothing. At most three requests a person a board a day are kept and emailed; a request goes after 30 days.

## Path parameters

| Field | Type | Required | Description |
|---|---|---|---|
| `board` | `string` | yes |  |

## Request body

The body has the type [`BoardAccessRequestBody`](https://docs.plotwork.dev/api/schemas.md#boardaccessrequestbody).

| Field | Type | Required | Description |
|---|---|---|---|
| `note` | `string` | no | at most 200 characters. |

## Responses

| Status | Meaning | Body |
|---|---|---|
| 202 | Received. | none |
| 400 | The body is not valid. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |
| 401 | Not signed in. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |
| 429 | Too many requests. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |
| 503 | Organisations or boards are not set up on this server. | [`ErrorResponse`](https://docs.plotwork.dev/api/schemas.md#errorresponse) |

## See also

| Doc | Why |
|---|---|
| [API reference](https://docs.plotwork.dev/api/reference.md) | Every endpoint, and the error envelope |
| [Schemas](https://docs.plotwork.dev/api/schemas.md) | Every request and response type |
| [Tool reference](https://docs.plotwork.dev/mcp/tools.md) | The operations as callable tools |