# Toolhouse Workers API

**Canonical:** https://apis.io/apis/toolhouse/workers-api/  
**Provider:** Toolhouse — https://apis.io/providers/toolhouse/  
**Base URL:** https://agents.toolhouse.ai  
**Documentation:** https://docs.toolhouse.ai/toolhouse/developers/workers-api

Toolhouse Workers API is one of 8 APIs that [Toolhouse](https://apis.io/providers/toolhouse/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include AI Agents, AI Workers, Attachments, Conversations, and Execution. The published artifact set on APIs.io includes API documentation and authentication docs.

The Toolhouse Workers API (historically the "Agents API") enables HTTP execution of any deployed Toolhouse worker. Workers defined via the Agent Editor or as code are reachable at https://agents.toolhouse.ai/{agent_id} with POST to start a new task, PUT /{agent_id}/{run_id} to continue an existing conversation, and GET /{agent_id}/{run_id} to retrieve full history. NDJSON variants under /ndjson/ stream the worker's output plus out-of-band tool-call and debug signals. Conversation continuity is keyed by the X-Toolhouse-Run-ID response header. Attachments are supported via URL (30-second download timeout) or base64-encoded direct upload (10 MB max per attachment). Public workers require no authentication; private workers use HTTPBearer with a Toolhouse API key.

## Machine-readable artifacts (5)

- **Documentation** — https://docs.toolhouse.ai/toolhouse/developers/workers-api
- **Authentication** — https://docs.toolhouse.ai/toolhouse/developers/authentication
- **Documentation** — https://docs.toolhouse.ai/toolhouse/developers/worker-statefulness
- **Documentation** — https://docs.toolhouse.ai/toolhouse/developers/attachments
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/toolhouse/refs/heads/main/apis.yml

## Other Toolhouse APIs (7)

- [Toolhouse Agent Runs API](https://apis.io/apis/toolhouse/toolhouse-agent-runs-api/)
- [Toolhouse API Keys API](https://apis.io/apis/toolhouse/toolhouse-api-keys-api/)
- [Toolhouse Backoffice API](https://apis.io/apis/toolhouse/toolhouse-backoffice-api/)
- [Toolhouse Logs API](https://apis.io/apis/toolhouse/toolhouse-logs-api/)
- [Toolhouse Metrics API](https://apis.io/apis/toolhouse/toolhouse-metrics-api/)
- [Toolhouse SDK API API](https://apis.io/apis/toolhouse/toolhouse-sdk-api-api/)
- [Toolhouse User API API](https://apis.io/apis/toolhouse/toolhouse-user-api-api/)

## Tags

AI Agents, AI Workers, Attachments, Conversations, Execution, Statefulness, Streaming

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/toolhouse/workers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/toolhouse/.