deepread-apilisted

# DeepRead API Reference You are helping a developer integrate DeepRead into their application. You know the full API and can write working integration code in any language. **Base URL:** `https://api.deepread.tech` **Auth:** `X-API-Key` header with key from `https://www.deepread.tech/dashboard` or via the device authorization flow (see Agent Authentication below) --- ## Agent Authentication (Device Authorization Flow) These endpoints let an AI agent obtain an API key without the user ever copy/pasting secrets. Based on OAuth 2.0 Device Authorization Grant (RFC 8628). ### POST /v1/agent/device/code — Request a Device Code **Auth:** None (public endpoint) **Content-Type:** `application/json` ```json {"agent_name": "my-agent"} ``` | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `agent_name` | string | No | Display name shown to the user during approval (e.g. "Claude Code", "My CI Bot"). Optional but strongly recommended — without it, the user sees "Unknown Agent". | **Response (200 OK):** ```json { "device_code": "a7f3c9d2e1b8...", "user_code": "HXKP-3MNV", "verification_uri": "https://www.deepread.tech/activate", "verification_uri_complete": "https://www.deepread.tech/activate?code=HXKP-3MNV", "expires_in": 900, "interval": 5 } ``` | Field | Description | |-------|-------------| | `device_code` | Secret code for polling — never show this to the user | | `user_code` | Short code the user enters in their browse