Boards

List the authenticated user's boards

Returns every board the caller can see as a tree in a single response (not paginated): personal boards they own, boards they collaborate on, and boards from any Savee Teams workspace they're a member of. Only top-level boards appear at the root of data; a board's children are nested under its sub_boards array (single-level, so each sub-board is a leaf). Use the ownership_type field on each board to tell user-owned boards apart from team boards. The order at every level follows the caller's chosen boards-sort preference on savee.com.

get/v1/boards

Request

  • Base URL: https://api.savee.com
  • URL: https://api.savee.com/v1/boards
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://savee.com/oauth/authorize/, token URL https://savee.com/api/oauth/token/, scopes: boards:read)

Response

All boards visible to the caller, as a tree.

Example response

{
  "data": [
    {
      "id": "69fbaf96d242ec48009df59a",
      "short_id": "Lp9wQ2s",
      "name": "Posters",
      "slug": "posters",
      "url": "https://savee.com/aliceb/posters/",
      "saves_count": 128,
      "created_at": "2026-04-01T09:00:00.000Z",
      "og_image": "https://dm.savee.com/board-og/original/Lp9wQ2s.jpg",
      "ownership_type": "user"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.