Leave a stretch out of comparisons

This page as Markdown, or in an AI chatMore ways to read this page

Leave a stretch out of comparisons: its views stay counted, and what is usual is worked out without them.

# Leave a stretch out of comparisons

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

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

Leave a stretch out of comparisons: its views stay counted, and what is usual is worked out without them.

## Parameters

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

## What to send

`StretchCreate`: Leave a stretch out of comparisons. What is left out of the request is empty, and is refused as that: after it is known that the site is the asker's to change.

- `from` (string): `2026-10-08T15:00`, in the site's own time.
- `until` (string)
- `why` (string): 1 to 280 characters. Shown on the chart with who said it.

## The answer

201, `StretchView`: A stretch left out of comparisons (the Dialogs board). Its views stay counted and on the chart; what is usual is worked out without them.

- `by` (string, needed): Who vouched for it.
- `from` (integer, needed): Unix seconds.
- `id` (string, needed)
- `made` (integer, needed)
- `says` (string, needed): From when to when, in words, in the site's own time.
- `undone` (integer or null): When it was undone, if it was. It counts again from then.
- `undone_by` (string, needed)
- `until` (integer, needed)
- `why` (string, needed)

## Asking

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

Parameters

sitein the address: neededA site's id or name

What to send

StretchCreate Leave a stretch out of comparisons. What is left out of the request is empty, and is refused as that: after it is known that the site is the asker's to change.

from: string`2026-10-08T15:00`, in the site's own time.
until: string
why: string1 to 280 characters. Shown on the chart with who said it.

The answer

Status 201

StretchView A stretch left out of comparisons (the Dialogs board). Its views stay counted and on the chart; what is usual is worked out without them.

by: stringneededWho vouched for it.
from: integerneededUnix seconds.
id: stringneeded
made: integerneeded
says: stringneededFrom when to when, in words, in the site's own time.
undone: integer or nullWhen it was undone, if it was. It counts again from then.
undone_by: stringneeded
until: integerneeded
why: stringneeded

Asking

curlJavaScript

With your token from Settings

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

With your token from Settings

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