Coding agent documentation index Fetch the complete documentation index at: https://docs.worklittle.com/docs-agent-manifest.json Use this file to discover all available pages before exploring further.

Libraries overview

Official Worklittle SDK and CLI for posting, ATS, organization, HR tools, and webhooks.

Overview

The SDK and CLI hit the same API as the Worklittle Business. Update candidates, listings, surveys, and other org data from a script or agent, and teammates see those changes in Worklittle.

For market job search and public apply helpers, see Jobs libraries.

Base URL

https://api.worklittle.com

Authentication

Bearer token. Create a key in the Worklittle Business under API keys.

Authorization: Bearer sk-wl-api01-...

For the SDK and CLI, set WORKLITTLE_API_KEY. Prefer the env var over --api-key so the key does not appear in process lists. Do not point --base-url at hosts you do not trust. Public board GETs and public survey submit do not require a key.

Clients

CLI

brew install worklittle/tap/worklittle

| Client | Install |
| --- | --- |
| TypeScript SDK | `npm install worklittle` ([docs](/business/libraries/sdk#typescript)) |
| Python SDK | `pip install worklittle` ([docs](/business/libraries/sdk#python)) |

OpenAPI: https://docs.worklittle.com/openapi/openapi.yaml · OpenAPI page

Published packages:

npm install worklittle
pip install worklittle

The TypeScript package is also on npm as @worklittle/sdk (same code). The CLI binary is worklittle (npm install -g worklittle). Homebrew remains the recommended CLI install.

Quickstart

export WORKLITTLE_API_KEY="sk-wl-api01-..."
brew install worklittle/tap/worklittle
worklittle candidates list --limit 3 --pretty

Or call the API directly:

curl -s "https://api.worklittle.com/candidates?limit=3" \
  -H "Authorization: Bearer $WORKLITTLE_API_KEY"

Surfaces

| Surface | Role |
| --- | --- |
| [CLI](/business/libraries/cli) | Shell; JSON on stdout |
| [SDK](/business/libraries/sdk) | In-process client |
| [MCP](/business/mcp) | JSON-RPC tools for MCP clients |
| [OpenAPI](/business/libraries/openapi) | Machine-readable REST catalog |

Coverage

| Area | Namespaces | Docs |
| --- | --- | --- |
| Post jobs | `listings`, `employer-jobs` | [Post a job](/business/api/post-a-job) |
| Public board | `boards` | [Public job board](/business/api/public-job-board) |
| ATS | `candidates`, `employees`, `email`, `offers` | [Manage candidates](/business/api/manage-candidates) |
| HR | `documents`, `attendance`, `surveys` | [Surveys](/business/api/surveys) · [Documents](/business/api/documents) · [Attendance](/business/api/attendance) |
| Automation | `webhooks` | [Webhooks](/business/webhooks/overview) |

Billing

Paid routes return 402 when the balance is empty. Scopes and rate limits: API keys. Pricing: Pricing.