# Alpsana

> Dashboard builder with a REST API for reading, editing and saving dashboards.

Agents and HTTP clients: start at /api/docs/agent. It is a compact JSON guide
with the editing workflow, operation list, schema names and links to on-demand
references. Fetch only the operations and schemas you need.

Authentication: send `Authorization: Bearer <personal access token>`. Users
create tokens on the Access tokens page of the app.

## API

- [Agent guide](/api/docs/agent): start here
- [OpenAPI 3.1](/api/openapi.json): full contract; select one item with ?operationId= or ?schema=
- [Swagger UI](/api/docs): browser-readable reference