API & developer

REST endpoints.

The base URL. The auth header. The shape of every resource.

Base URL: https://api.paitho.ai/v1. Auth: Authorization: Bearer <token>, where the token is a workspace-scoped PAT created at Workspace → Settings → API tokens.

Resources

Resource	Endpoints
Leads	`GET /leads`, `POST /leads`, `GET /leads/{id}`
Runs	`POST /runs`, `GET /runs/{id}`, `GET /runs/{id}/leads`
Packs	`GET /packs`, `GET /packs/{slug}`, `POST /packs/{slug}/fork`
Prompts	`GET /prompts/{name}`, `GET /prompts/{name}/versions/{semver}`, `POST /prompts/{name}/fork`
Providers	`GET /providers`, `POST /providers/{slug}`, `DELETE /providers/{slug}`
Audit	`GET /audit` with cursor pagination

Quick example

curl https://api.paitho.ai/v1/runs \
          -H "Authorization: Bearer $PAITHO_TOKEN" \
          -H "Content-Type: application/json" \
          -d '{
            "pack": "devtools-infra",
            "leads_csv_url": "s3://your-bucket/list.csv",
            "stop_after": "draft_email"
          }'

Rate limits

120 requests per minute per token. Burst to 240. Returns 429 with Retry-After on overrun. Limits scale with plan; talk to support if you hit them often.