# Close a request without doing it, saying why

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/post-sites-site-requests-id-close

`POST /api/v1/sites/{site}/requests/{id}/close`

Close a request without doing it, saying why.

## Parameters

- `site` (in path, needed): A site's id or name
- `id` (in path, needed): The request

## What to send

`RequestDone`

- `confirm` (string): For a deletion: the visitor's ID, typed.
- `outcome` (string): For closing without doing: why.

## The answer

200, `RequestView`

- `asked` (integer, needed)
- `asked_how` (string, needed)
- `days_left` (integer, needed): Days left to answer; negative when it is late.
- `deadline` (integer, needed)
- `done` (integer or null)
- `id` (string, needed)
- `kind` (string, needed): `copy` or `deletion`.
- `label` (string, needed)
- `log` (list of LogLineView, needed)
- `number` (string, needed): `R-0031`.
- `outcome` (string, needed)
- `state` (string, needed): `open`, `done` or `closed`.
- `subject` (string, needed)
- `visitor` (string or null): The visitor it is about, while they are held.
- `will_delete` (string or null): For an open deletion: what will go and what will stay.

## Asking

```sh
curl -X POST https://tidekeeper.eu/api/v1/sites/example.org/requests/{id}/close \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{}'
```