documenso-install-auth

# Documenso Install & Auth ## Overview Set up the Documenso SDK and configure API authentication for document signing. Covers the TypeScript SDK (`@documenso/sdk-typescript`), the Python SDK (`documenso-sdk-python`), and raw REST API usage. Documenso exposes two API versions: **v1** (legacy, documents only) and **v2** (envelopes, multi-document, recommended for new work). ## Prerequisites - Node.js 18+ or Python 3.10+ - Package manager (npm, pnpm, yarn, pip, or uv) - Documenso account — cloud at `app.documenso.com` or self-hosted instance - API key generated from the Documenso dashboard ## Instructions ### Step 1: Install the SDK **TypeScript / Node.js:** ```bash npm install @documenso/sdk-typescript # or pnpm add @documenso/sdk-typescript ``` **Python:** ```bash pip install documenso-sdk-python # or uv pip install documenso-sdk-python ``` ### Step 2: Generate an API Key 1. Log in to your Documenso dashboard (`https://app.documenso.com` or your self-hosted URL). 2. Click your avatar (top-right) and select **User settings** (or **Team settings** for team-scoped keys). 3. Navigate to the **API tokens** tab. 4. Click **Create API Key**, give it a descriptive name (e.g. `ci-pipeline-prod`). 5. Copy the key immediately — it is shown only once. Team API keys inherit the team's document and template access. Personal keys only access your own documents. ### Step 3: Store the Key Securely ```bash # .env (never commit this file) DOCUMENSO_API_KEY=api_xxxxxxxxxxxxxxxxxxxx...