BetaPreside is in beta. Thank you for helping us shape it: tell us what you think at info@presideos.com
Developers

The Preside API

Read your board's meetings, agendas, document details, action items and resolutions from your own tools. The API is read-only, versioned at /api/v1 and described in OpenAPI 3.1. It is included in the Enterprise plan.

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: Meetings
  • agendas:read: Agendas
  • documents:read: Document details (not files)
  • action-items:read: Action items
  • resolutions:read: Resolutions and vote counts

Endpoints

EndpointScopeReturns
GET /api/v1/boardsany keyThe boards this key may read.
GET /api/v1/meetingsmeetings:readMeetings, newest start time first. Filter by board_id, status, starts_after, starts_before, updated_since.
GET /api/v1/meetings/{id}meetings:readOne meeting.
GET /api/v1/meetings/{id}/agendaagendas:readThe meeting's agenda items, in order.
GET /api/v1/documentsdocuments:readDocument 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:readOne document's details. A document limited to chosen people answers 404.
GET /api/v1/action-itemsaction-items:readAction items, newest first. Filter by board_id, meeting_id, status, priority, updated_since.
GET /api/v1/action-items/{id}action-items:readOne action item.
GET /api/v1/resolutionsresolutions:readResolutions 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:readOne 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." } }
StatusCodeMeaning
400invalid_requestA query parameter is not valid.
401unauthorizedThe key is missing, not valid, revoked or expired.
403plan_requiredThe organisation is not on the Enterprise plan.
403insufficient_scopeThe key does not hold the scope this endpoint needs.
403ip_not_allowedThe organisation's IP allow list does not include your address.
403no_board_accessThe person who made the key no longer sits on its board.
404not_foundNo such record on a board this key may read.
429rate_limitedToo many requests. Wait for the seconds in Retry-After.
500internal_errorSomething 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