Api-Key

Supernotes

API Reference

Go to App

Community

 Modify Webhook

PutWebhook

OAuth2PasswordBearer

APIKeyHeader

WebhookResponse

AuthError

BasicError

CardError

PermError

RecaptchaError

ValidationError

NumericError

Welcome to the Supernotes Developer Documentation

Introduction

Custom Collections (Upcoming)

Supernotes to Drafts

ChatGPT iOS Shortcut

Youtube to iOS Shortcut

Readwise to Supernotes

Scriptable iOS Pinned Widget

Here's how to get started with the Supernotes API

Getting Started

Overview of API resource limits for different Supernotes plans.

 Get Card

The "base query" for retrieving cards (memberships) – supports selecting, filtering, and
ordering by any implemented metric

NOTE: This is a "POST-GET" endpoint – the method is POST (for the payload) but it GETs data

 Get Selected Cards

Get the full card memberships of all the card IDs passed in the request body

NOTE: This is a "POST-GET" endpoint – the method is POST (for the payload) but it GETs data

 Get Specified Cards

Get the full card memberships for any cards that have changed since `since_when`

 Get Cards Since

Get a list of recently deleted card IDs for this user

 Get Deleted Cards

Create a single card with the minimum amount of data required

 Simple Create Card

Create cards with full control over properties

 Create Cards

 Update Cards

Enroll in a card – the current user will be given access to all child cards(that have been
published) within the specified card. If the user has already enrolled, this endpoint will
return all child cards to provide idempotency.

 Enroll In Card

Completely remove access to cards for the current user

 Remove Cards For Me

Completely (and irreversibly) delete cards from the Supernotes platform

 Delete Cards For Everyone

 Set Preferences

Sets a boolean preference flag for the user

 Set Preference Flag

Sets a boolean feature preview flag for the user

 Set Feature Preview Flag

Check if using a valid authentication token and return the associated User ID

 Check Auth

Check if the access token is 'fresh' and return the associated User ID

 Check If Fresh Access Token

Get the authenticated user's information, including subscription details

 Get Current User

Update the authenticated user's personal information

 Update Current User

Update a public user's profile bio and image

 Update Current User Bio And Pic

 Get Pins

 Put Pins

 Get Users Tags

Get the authenticated user's public profile

 Get Current User Profile

Get the public profiles for all card owners the current user knows

 Get Known Owner Profiles

 Get Other User Profile

Get the public profiles for a specified list of users

 Get Specified User Profiles

 Get Comments

Update the specified comment on the specified card

 Edit Comment

Create a new comment on the specified card

 Create Comment

Delete the specified comment from the specified card

 Delete Comment

Get data about members of this card (permissions, statuses, etc)

 Get Members

Attempt to join a card (based on having access to some arbitrary ancestor card)

 Attempt Join

Invite a friend directly to an existing card

 Invite Member

 Respond To Invite

 Modify Member

Delete the member from the specified card

 Delete Member

 Get Friends

 Send Friend Request

 Get Incoming Requests

 Get Outgoing Requests

 Accept Friendship

 Delete Friendship

 Get Share Codes For Card

Create a new share code (if user has permission)

 Create Share Code

Modify an existing share code (if user has permission)

 Update Share Code

Delete an existing share code (if user has permission)

 Delete Share Code

Retrieve card data (and share code metadata) by specifying a share code.

 Find Card With Share Code

Retrieve card data (and share code metadata) by specifying a share code.
Check for auth headers and if the user already has access to this card, return a 409 error.

Cards

User

Tags

Profiles

Comments

Members

Friends

Share

Templates

API Keys

Webhooks

Modify Webhook

Authorizations

Path Parameters

Body

Response