API keys
The board Chair or Secretary creates keys in Preside under Settings, API keys. Each key belongs to one organisation. It reads either one board or every board of the organisation its creator sits on, and never more than its creator can see: if the creator leaves a board, the key stops reading it. Preside shows a key once and keeps only a hash of it, with the first characters for telling keys apart. A key can be set to expire, and can be revoked at any time. Creating and revoking a key is written to the organisation's audit log.
Send the key as a bearer token on every request:
curl https://presideos.com/api/v1/meetings?limit=10 \
-H "Authorization: Bearer preside_live_..."Scopes
Choose what each key may read. Every scope is read-only.
meetings:read: Meetingsagendas:read: Agendasdocuments:read: Document details (not files)action-items:read: Action itemsresolutions:read: Resolutions and vote counts
Endpoints
| Endpoint | Scope | Returns |
|---|---|---|
GET /api/v1/boards | any key | The boards this key may read. |
GET /api/v1/meetings | meetings:read | Meetings, newest start time first. Filter by board_id, status, starts_after, starts_before, updated_since. |
GET /api/v1/meetings/{id} | meetings:read | One meeting. |
GET /api/v1/meetings/{id}/agenda | agendas:read | The meeting's agenda items, in order. |
GET /api/v1/documents | documents:read | Document details: title, category, status, meeting and latest version (file name, size, type). Never the file. A document limited to chosen people is never listed. |
GET /api/v1/documents/{id} | documents:read | One document's details. A document limited to chosen people answers 404. |
GET /api/v1/action-items | action-items:read | Action items, newest first. Filter by board_id, meeting_id, status, priority, updated_since. |
GET /api/v1/action-items/{id} | action-items:read | One action item. |
GET /api/v1/resolutions | resolutions:read | Resolutions with their result as recorded (not who voted which way): Preside's count when voting closed, the signatures of a written resolution circulated for e-signature, the signed copies an officer recorded for a decision adopted outside Preside, or the votes cast, named in votes.counted_from. On a board with weighted director votes, votes.weighted gives the votes each way where the result was counted in votes. Filter by board_id, meeting_id, status, updated_since. |
GET /api/v1/resolutions/{id} | resolutions:read | One resolution. |
Pages of results
Lists return data and next_cursor. Ask for up to 100 records with limit (the default is 50). To get the next page, pass next_cursor back as cursor. It is null on the last page.
{
"data": [ { "id": "...", "board_id": "...", "title": "Q4 Board Meeting", ... } ],
"next_cursor": "WyIyMDI2LTEyLTA..."
}Rate limits
Each key may make 120 requests a minute. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Over the limit, you get status 429 with Retry-After.
Errors
Every error has the same shape:
{ "error": { "code": "not_found", "message": "Meeting not found." } }| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | A query parameter is not valid. |
| 401 | unauthorized | The key is missing, not valid, revoked or expired. |
| 403 | plan_required | The organisation is not on the Enterprise plan. |
| 403 | insufficient_scope | The key does not hold the scope this endpoint needs. |
| 403 | ip_not_allowed | The organisation's IP allow list does not include your address. |
| 403 | no_board_access | The person who made the key no longer sits on its board. |
| 404 | not_found | No such record on a board this key may read. |
| 429 | rate_limited | Too many requests. Wait for the seconds in Retry-After. |
| 500 | internal_error | Something went wrong on our side. |
Security
- A key reads only its own organisation. A record on any other board answers 404, the same as one that does not exist.
- Your organisation's IP allow list, when it is on, applies to API requests as well as sign-ins.
- A key stops working when it is revoked, when it expires, or when the organisation leaves the Enterprise plan.
- The API never returns document files or links to them, nor who voted which way.
Not in this version
- Writing through the API: version 1 reads only.
- Outbound webhooks for events such as a meeting created or a resolution passed. Coming Soon
- An MCP server for Preside data, built on this API. Coming Soon