Provisioning
Create Provision Key
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_emailAn email address for reaching the agent or operator. Not verified.
integrator_nameOptional identifier for the agent platform issuing the call (e.g., "anthropic-mcp"). Stored as metadata for attribution.
Create Provision Key › Responses
Created
Create Account
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.
Headers
AuthorizationThe 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
emailThe initial user's email. Becomes the admin of the new organization.
nameThe initial user's full name.
org_nameName of the new organization.
Create Account › Responses
Created