# Open a request for someone who wrote to you

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

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

Open a request for someone who wrote to you.

## Parameters

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

## What to send

`RequestCreate`

- `kind` (string, needed): `copy` or `deletion`.
- `subject` (string, needed): A visitor ID (`v_…`, whole or its first eight digits) or the site's own user ID.

## The answer

201, `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 \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"kind": "…", "subject": "…"}'
```