Open a request for someone who wrote to you

Open a request for someone who wrote to you.

# 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": "…"}'
```

Parameters

sitein the address

neededA site's id or name

What to send

RequestCreate

kind

stringneeded`copy` or `deletion`.

subject

stringneededA visitor ID (`v_…`, whole or its first eight digits) or the site's own user ID.

The answer

Status 201

RequestView

asked

integerneeded

asked_how

stringneeded

days_left

integerneededDays left to answer; negative when it is late.

deadline

integerneeded

done

integer or null

id

stringneeded

kind

stringneeded`copy` or `deletion`.

label

stringneeded

log

list of LogLineViewneeded

number

stringneeded`R-0031`.

outcome

stringneeded

state

stringneeded`open`, `done` or `closed`.

subject

stringneeded

visitor

string or nullThe visitor it is about, while they are held.

will_delete

string or nullFor an open deletion: what will go and what will stay.

Asking

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": "…"}'

const answer = await fetch("https://tidekeeper.eu/api/v1/sites/example.org/requests", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"kind": "…", "subject": "…"}),
}).then((r) => r.json());