Documentation · API reference
GET
/api/v1/sites/{site}/shareWhat a site shares with people who are not members, and how
This page as Markdown, or in an AI chatMore ways to read this page
What a site shares with people who are not members, and how.
# What a site shares with people who are not members, and how
> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-sites-site-share
`GET /api/v1/sites/{site}/share`
What a site shares with people who are not members, and how.
## Parameters
- `site` (in path, needed): The site's id or name
## The answer
200, `ShareAdmin`: What the Sharing screen shows and changes.
- `address` (string, needed): Where the public dashboard is, on or off.
- `floor` (integer, needed): A row with fewer visitors than this is folded into "other".
- `links` (list of ShareLinkView, needed)
- `never` (list of string, needed): What is never in a shared view, whatever is ticked.
- `now` (integer, needed)
- `panels` (list of PanelView, needed)
- `settings` (object, needed)
- `site` (string, needed)
## Asking
```sh
curl https://tidekeeper.eu/api/v1/sites/example.org/share \
-H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```
Parameters
- sitein the address
- neededThe site's id or name
The answer
Status 200
ShareAdmin What the Sharing screen shows and changes.
- address
- stringneededWhere the public dashboard is, on or off.
- floor
- integerneededA row with fewer visitors than this is folded into "other".
- links
- list of ShareLinkViewneeded
- never
- list of stringneededWhat is never in a shared view, whatever is ticked.
- now
- integerneeded
- panels
- list of PanelViewneeded
- settings
- objectneeded
- site
- stringneeded
Asking
curl https://tidekeeper.eu/api/v1/sites/example.org/share \ -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
const answer = await fetch("https://tidekeeper.eu/api/v1/sites/example.org/share", { headers: { Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`, }, }).then((r) => r.json());