> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useshareable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Authenticate API requests with a bearer key.

The Shareable REST API authenticates with an **API key** passed as a bearer token.

```bash theme={null}
Authorization: Bearer sm_your_key
```

## Creating a key

API keys are created in the app — sign in at [useshareable.com](https://useshareable.com) → **Developers** → **Create 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.

<Note>
  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.
</Note>

## Using the key

Every request to `/api/v1/*` must include the `Authorization` header:

```bash theme={null}
curl https://useshareable.com/api/v1/pages \
  -H "Authorization: Bearer sm_your_key"
```

A missing or invalid key returns:

```json theme={null}
{ "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.