Savee Developers
Reference

Boards

GET
/v1/boards

List the authenticated user's boards

Returns every board the caller can see 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. Use the ownership_type field on each board to tell user-owned boards apart from team boards. The order follows the caller's chosen boards-sort preference on savee.com.

/v1/boards

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

Personal access token in the form sv_live_\<24 chars\>. Generate one at https://savee.com/developer/.

In: header

Status codeDescription
200All boards visible to the caller.
400Invalid input.
401Missing or invalid Bearer token.
402Authenticated but the user has no active subscription.
403The Public API is not enabled for this account.
429Rate limit exceeded.
curl -X GET "http://localhost:3060/v1/boards"

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "slug": "string",
      "url": "http://example.com",
      "is_private": true,
      "saves_count": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "og_image": "http://example.com",
      "ownership_type": "team"
    }
  ]
}

GET
/v1/boards/{boardID}/saves

List saves on a specific board

boardID is the board id returned by /v1/boards. Accessible by any user with a role on the board (owner, admin, editor, viewer) and by team members for team-owned boards. Returns 404 when the board does not exist or the caller has no role on it — the API does not confirm whether someone else’s board exists.

/v1/boards/{boardID}/saves

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

Personal access token in the form sv_live_\<24 chars\>. Generate one at https://savee.com/developer/.

In: header

Path Parameters

boardID
Required
string

The board id (the id returned by /v1/boards).

Query Parameters

limitinteger

Page size (default 30, max 100).

Example: 30Minimum: 1Maximum: 100

cursorstring

Opaque cursor returned in next_cursor from the previous page.

Status codeDescription
200A page of saves on the board.
400Invalid input.
401Missing or invalid Bearer token.
402Authenticated but the user has no active subscription.
403The Public API is not enabled for this account.
404Board not found or not accessible to the caller.
429Rate limit exceeded.
curl -X GET "http://localhost:3060/v1/boards/string/saves?limit=30&cursor=string"

{
  "data": [
    {
      "id": "string",
      "url": "http://example.com",
      "name": "string",
      "source_url": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "is_private": true,
      "total_saves": 0,
      "media": {
        "type": "image",
        "width": 0,
        "height": 0,
        "thumbnail": "http://example.com",
        "original": "http://example.com"
      },
      "user": {
        "id": "string",
        "username": "string",
        "name": "string",
        "url": "http://example.com",
        "avatar_url": "http://example.com"
      }
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Previous

Saves