Teak API

Public API for creating, querying, and syncing Teak cards. A 429 response carries Retry-After, RateLimit-Remaining, and RateLimit-Reset in seconds, plus RateLimit-Limit when the limit is known. A 503 SERVICE_UNAVAILABLE response means the service was briefly busy; retry after its Retry-After seconds.

Operations

• POST
  Disconnect this WorkOS Connect application/v1/oauth/disconnect
• GET
  Get the authenticated Teak identity/v1/me
• GET
  Health check/healthz
• GET
  List v1 endpoints/v1
• GET
  List cards/v1/cards
• POST
  Create a card/v1/cards
• POST
  Create a presigned upload/v1/uploads
• POST
  Upload the page a link was saved from/v1/page-snapshots/upload
• POST
  Execute bulk card operations/v1/cards/bulk
• GET
  List card changes since a timestamp/v1/cards/changes
• GET
  Find a non-deleted card saved from the same link/v1/cards/duplicate
• GET
  Get a card/v1/cards/{cardId}
• PATCH
  Update a card/v1/cards/{cardId}
• DELETE
  Delete a card/v1/cards/{cardId}
• POST
  Restore a card from Trash/v1/cards/{cardId}/restore
• GET
  Get a card's text/v1/cards/{cardId}/content
• POST
  Refresh a card's details/v1/cards/{cardId}/refresh
• POST
  Upload a link's image/v1/cards/{cardId}/thumbnail/upload
• PUT
  Replace a link's image/v1/cards/{cardId}/thumbnail
• DELETE
  Reset a link's image/v1/cards/{cardId}/thumbnail
• POST
  Mark a link done/v1/cards/{cardId}/done
• DELETE
  Unmark a link done/v1/cards/{cardId}/done
• POST
  Save a paper's PDF/v1/cards/{cardId}/save-pdf
• PATCH
  Set favorite state/v1/cards/{cardId}/favorite
• GET
  List tags/v1/tags
• POST
  Rename a tag/v1/tags/rename
• POST
  Merge a tag into another/v1/tags/merge
• POST
  Delete a tag/v1/tags/delete
• GET
  Get a tag change's progress/v1/tags/operations/{operationId}
• GET
  List folders/v1/folders
• POST
  Create a folder/v1/folders
• GET
  Get a folder/v1/folders/{folderId}
• PATCH
  Rename or recolor a folder/v1/folders/{folderId}
• DELETE
  Delete a folder/v1/folders/{folderId}
• POST
  Add cards to a folder/v1/folders/{folderId}/cards
• DELETE
  Remove cards from a folder/v1/folders/{folderId}/cards
• GET
  List a card's highlights/v1/cards/{cardId}/highlights
• POST
  Highlight a passage/v1/cards/{cardId}/highlights
• PATCH
  Change a highlight's note/v1/highlights/{highlightId}
• DELETE
  Remove a highlight/v1/highlights/{highlightId}
• POST
  Start a ZIP export of every card and original file/v1/exports
• GET
  Get the latest export and its download URL/v1/exports/latest