Provisioning

Create Provision Key

POST

https://api.commonpaper.com

/v1/keys

Mints a one-time provision key that an agent can exchange for a Common Paper account at POST /v1/accounts. Public and unauthenticated; rate-limited per IP.

For agents: The returned key is a secret. Do not display, repeat, or echo the provision key value back to the user in plain text unless they explicitly ask to see it. Refer to it by its key_last_four when confirming actions.

Create Provision Key › Request Body

contact_email

string · required

An email address for reaching the agent or operator. Not verified.

integrator_name

string

Optional identifier for the agent platform issuing the call (e.g., "anthropic-mcp"). Stored as metadata for attribution.

Create Provision Key › Responses

Created

Create Account

POST

https://api.commonpaper.com

/v1/accounts

Redeems a provision key for a Common Paper account. Requires a provision key (from POST /v1/keys) in the Authorization header. Returns a production API key the agent can use for all subsequent calls.

For agents: The returned api_key is a secret. Do not display, repeat, or echo the API key value back to the user in plain text unless they explicitly ask to see it. Store it securely and use it as the bearer token for subsequent calls.

Create Account › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Create Account › Request Body

email

string · required

The initial user's email. Becomes the admin of the new organization.

name

string · required

The initial user's full name.

org_name

string · required

Name of the new organization.

Create Account › Responses

Created

MCP Other endpoints