Savee · OAuth Scopes

Savee OAuth Scopes

OAuth 2.0 searched

Savee publishes 6 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Savee API on a user’s behalf.

Tokens are issued from https://savee.com/api/oauth/token/.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

Designvisual inspirationImageCreativeMoodboardsArtificial Intelligence (AI)

Scopes: 6 Flows: authorizationCode Method: searched

OAuth endpoints

Authorization URL
https://savee.com/oauth/authorize/

Token URL
https://savee.com/api/oauth/token/

Flows
authorizationCode

Scopes (6)

Scope	Description	Flows
boards:read	Read the user’s boards and the saves on them	authorizationCode
profile:read	Read the user’s username, name, and avatar	authorizationCode
saves:read	Read the user’s saves and home feed	authorizationCode
search:read	Search Savee’s public library on the user’s behalf	authorizationCode
saves:write	Save items to your account and change their privacy	authorizationCode
boards:write	Create and edit your boards, and add or remove saves on them	authorizationCode

📄 Provider scope reference: https://docs.savee.com/api/oauth

Source

OAuth Scopes

generated: '2026-09-03'
method: searched
source: openapi/savee-boards-api-openapi.yml, openapi/savee-saves-api-openapi.yml, openapi/savee-search-api-openapi.yml,
  openapi/savee-user-api-openapi.yml + https://docs.savee.com/api/oauth + https://savee.com/.well-known/oauth-authorization-server
  (probed 2026-09-03)
schemes:
- name: OAuth2
  source: openapi/savee-boards-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://savee.com/oauth/authorize/
    tokenUrl: https://savee.com/api/oauth/token/
  description: |-
    **OAuth access token** (`sv_at_…`) — obtained on one of your users’ behalf and limited to the scopes they approved. Use this when you’re building a product other people sign into with Savee. See https://docs.savee.com/api/oauth.

    Missing the scope below returns `403` with a `WWW-Authenticate: Bearer error="insufficient_scope"` header naming it.
- name: OAuth2
  source: openapi/savee-saves-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://savee.com/oauth/authorize/
    tokenUrl: https://savee.com/api/oauth/token/
  description: |-
    **OAuth access token** (`sv_at_…`) — obtained on one of your users’ behalf and limited to the scopes they approved. Use this when you’re building a product other people sign into with Savee. See https://docs.savee.com/api/oauth.

    Missing the scope below returns `403` with a `WWW-Authenticate: Bearer error="insufficient_scope"` header naming it.
- name: OAuth2
  source: openapi/savee-search-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://savee.com/oauth/authorize/
    tokenUrl: https://savee.com/api/oauth/token/
  description: |-
    **OAuth access token** (`sv_at_…`) — obtained on one of your users’ behalf and limited to the scopes they approved. Use this when you’re building a product other people sign into with Savee. See https://docs.savee.com/api/oauth.

    Missing the scope below returns `403` with a `WWW-Authenticate: Bearer error="insufficient_scope"` header naming it.
- name: OAuth2
  source: openapi/savee-user-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://savee.com/oauth/authorize/
    tokenUrl: https://savee.com/api/oauth/token/
  description: |-
    **OAuth access token** (`sv_at_…`) — obtained on one of your users’ behalf and limited to the scopes they approved. Use this when you’re building a product other people sign into with Savee. See https://docs.savee.com/api/oauth.

    Missing the scope below returns `403` with a `WWW-Authenticate: Bearer error="insufficient_scope"` header naming it.
scopes:
- scope: boards:read
  description: Read the user’s boards and the saves on them
  flows:
  - authorizationCode
  sources:
  - openapi/savee-boards-api-openapi.yml
  - openapi/savee-saves-api-openapi.yml
  - openapi/savee-search-api-openapi.yml
  - openapi/savee-user-api-openapi.yml
  default: true
- scope: profile:read
  description: Read the user’s username, name, and avatar
  flows:
  - authorizationCode
  sources:
  - openapi/savee-boards-api-openapi.yml
  - openapi/savee-saves-api-openapi.yml
  - openapi/savee-search-api-openapi.yml
  - openapi/savee-user-api-openapi.yml
  default: true
- scope: saves:read
  description: Read the user’s saves and home feed
  flows:
  - authorizationCode
  sources:
  - openapi/savee-boards-api-openapi.yml
  - openapi/savee-saves-api-openapi.yml
  - openapi/savee-search-api-openapi.yml
  - openapi/savee-user-api-openapi.yml
  default: true
- scope: search:read
  description: Search Savee’s public library on the user’s behalf
  flows:
  - authorizationCode
  sources:
  - openapi/savee-boards-api-openapi.yml
  - openapi/savee-saves-api-openapi.yml
  - openapi/savee-search-api-openapi.yml
  - openapi/savee-user-api-openapi.yml
  default: false
  note: Not in the default grant; reads the public library, not the user's account. Shares the account-wide
    20/5min + 200/week search budget.
- scope: saves:write
  description: Save items to your account and change their privacy
  flows:
  - authorizationCode
  default: false
  surfaces:
  - mcp
  sources:
  - https://savee.com/.well-known/oauth-authorization-server
  - https://docs.savee.com/mcp/permissions
  note: 'MCP-only: gates the save_items write tool. Not used by any REST operation.'
- scope: boards:write
  description: Create and edit your boards, and add or remove saves on them
  flows:
  - authorizationCode
  default: false
  surfaces:
  - mcp
  sources:
  - https://savee.com/.well-known/oauth-authorization-server
  - https://docs.savee.com/mcp/permissions
  note: 'MCP-only: gates create_board, update_board and remove_save_from_board. Not used by any REST operation.'
docs: https://docs.savee.com/api/oauth
notes: 'The authorization-server metadata advertises six scopes; the two write scopes are used only by
  the MCP server''s write tools (the REST API has no write surface). Requesting no scope grants the three
  account-read scopes (profile:read, saves:read, boards:read); search:read is never granted implicitly
  and must be asked for. Write scopes are marked separately on the consent screen and never granted implicitly.
  A call missing a scope returns 403 with WWW-Authenticate: Bearer error="insufficient_scope" naming the
  missing scope(s).'

Work with this as data

Every scope set here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for oauth scopes

4 MCP tools reach this

find_scopesBrowse and filter every scope set in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This scope set

curl "https://apis.io/api/v1/scopes/savee-scopes"

All oauth scopes

curl "https://apis.io/api/v1/scopes?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.