# Warmup API (https://warmup.uriv.me)

Gradually warms up a Reddit account via Composio OAuth to 100+ karma by posting genuine, zero-link, non-promotional comments in safe, welcoming subreddits (gated by `ai-utils` decision models), then emails you via AgentMail when the account hits target karma and is cleared for Lurk.

## Authentication
Pass header:
`Authorization: Bearer <WARMUP_API_SECRET>`
on all `/api/*` requests.

## Quickstart for AI Agents (3 steps)

### 1. Register a Reddit username for warmup & get its Composio OAuth URL
`POST https://warmup.uriv.me/api/accounts`
```json
{
  "username": "anna_levin_dev",
  "notifyEmail": "owner@example.com",
  "targetKarma": 100,
  "maxPostsPerDay": 4,
  "topics": ["software engineering", "coffee", "cooking", "books"]
}
```
Response:
```json
{
  "ok": true,
  "isConnected": false,
  "connectUrl": "https://connect.composio.dev/link/lk_...",
  "account": {
    "username": "anna_levin_dev",
    "composioUserId": "warmup:anna_levin_dev",
    "notifyEmail": "owner@example.com",
    "targetKarma": 100,
    "currentKarma": 0,
    "status": "pending_auth"
  }
}
```
Share `connectUrl` with the human (or complete OAuth in an authenticated session) to link the Reddit account. Once authorized, the 30-minute Cloudflare Cron automatically detects the active connection, starts gentle warmup (4 safe comments/day across r/CasualConversation, r/NoStupidQuestions, r/AskReddit, r/cookingforbeginners, r/booksuggestions, r/productivity, r/learnprogramming, r/simpleliving, r/coffee, r/houseplants), monitors karma, stops at `targetKarma`, and sends an email to `notifyEmail`.

### 2. Check live karma & warmup status
`GET https://warmup.uriv.me/api/accounts/<username>?sync=true`
Returns live `currentKarma`, `commentKarma`, `linkKarma`, `status` (`pending_auth` | `warming` | `paused` | `completed` | `suspended`), and `recentComments`.

### 3. Optional control endpoints
- `GET https://warmup.uriv.me/api/accounts` — list all accounts
- `POST https://warmup.uriv.me/api/accounts/<username>/connect` — generate a fresh Composio OAuth `connectUrl` (`{ "callbackUrl"?: "..." }`)
- `POST https://warmup.uriv.me/api/accounts/<username>/sync` — sync live karma from Reddit now (and send completion email if target reached)
- `POST https://warmup.uriv.me/api/accounts/<username>/step` — trigger one warmup comment step immediately (`{ "force"?: true }` to bypass cooldown)
- `POST https://warmup.uriv.me/api/accounts/<username>/pause` — pause warmup
- `POST https://warmup.uriv.me/api/accounts/<username>/resume` — resume warmup
- `DELETE https://warmup.uriv.me/api/accounts/<username>` — delete warmup record and disconnect Composio session