# My away dates

## `GET /api/me/away`

**List my away dates**

Returns the signed-in member's away ranges, soonest first. Past ranges are pruned before the list is built.

**Response `200` — The member's away ranges.**

Model: array of {ref}`AwayRangeSchema <model-awayrangeschema>`

Type: array of {ref}`AwayRangeSchema <model-awayrangeschema>`


## `POST /api/me/away`

**Add an away date range**

Adds a new away range for the signed-in member.

**Request body**

Model: {ref}`AwayRangeIn <model-awayrangein>`

| Field | Type | Required | Description |
|---|---|---|---|
| `start_date` | string (date) | yes |  |
| `end_date` | string (date) | yes |  |
| `note` | string \| null | no |  |

**Response `201` — The new away range.**

Model: {ref}`AwayRangeSchema <model-awayrangeschema>`

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `start_date` | string (date) | yes |  |
| `end_date` | string (date) | yes |  |
| `note` | string \| null | yes |  |


## `DELETE /api/me/away/{range_id}`

**Remove an away date range**

Removes one of the signed-in member's own away ranges.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `range_id` | path | string (uuid) | yes | The away range's ID. |

**Response `204`** — The away range was removed.