<!-- https://developers.silktide.com/v1/governance/reports | Governance -->

# Reports

A report is a page of widgets, such as scores, charts and tables, laid out by a [report template](https://developers.silktide.com/v1/governance/report-templates.md) and pointed at something to cover, its [context](https://developers.silktide.com/v1/concepts/context.md): one website, a set of websites, or the whole account.

There are two kinds, told apart by `isLive`:

- **Live reports** (`isLive: true`), which Silktide calls dashboards, are built afresh every time you read them, over a length of time counted back from now. If what they cover is removed, such as a website that is deleted, they can no longer show it.
- **Snapshots** (`isLive: false`) are built once, when they are created, over fixed dates, and never change. They keep working when what they cover is removed.

Create a report from a template, then [read its results](https://developers.silktide.com/v1/governance/reports/get-report-results.md). To make a snapshot on a regular interval and email it to people, use a [report schedule](https://developers.silktide.com/v1/governance/report-schedules.md).

Each report records who created it, as an [assignee](https://developers.silktide.com/v1/platform/assignees.md), and has its own permissions: who may see it and who may admin it.
## Operations

- [List reports](https://developers.silktide.com/v1/governance/reports/list-reports.md): `GET /v1/reports`
- [Get a report](https://developers.silktide.com/v1/governance/reports/get-report.md): `GET /v1/reports/{reportId}`
- [Get what a report shows](https://developers.silktide.com/v1/governance/reports/get-report-results.md): `GET /v1/reports/{reportId}/results`
- [Create a live report or a snapshot](https://developers.silktide.com/v1/governance/reports/create-report.md): `POST /v1/reports`
- [Rename a report, or change what a live report covers](https://developers.silktide.com/v1/governance/reports/update-report.md): `PUT /v1/reports/{reportId}`
- [Delete a report](https://developers.silktide.com/v1/governance/reports/delete-report.md): `DELETE /v1/reports/{reportId}`
