Skip to main content
The Shareable REST API authenticates with an API key passed as a bearer token.
Authorization: Bearer sm_your_key

Creating a key

API keys are created in the app — sign in at useshareable.comDevelopersCreate key.
  • Keys are shown once at creation. Copy and store it securely.
  • Name keys after where they live (e.g. “Claude Code — laptop”) so you can revoke the right one later.
  • Revoke a key anytime from the same screen; it stops working immediately.
Keys are stored only as a SHA-256 hash on our side — we can’t show you a key again after creation, so keep your copy safe.

Using the key

Every request to /api/v1/* must include the Authorization header:
curl https://useshareable.com/api/v1/pages \
  -H "Authorization: Bearer sm_your_key"
A missing or invalid key returns:
{ "error": "Unauthorized" }
with status 401.

Scope

A key acts on behalf of the account that created it. It can:
  • Create, read, update, and delete that account’s pages
  • Publish / unpublish pages and set access
It cannot access other accounts’ pages or manage other API keys.