API Reference

REST API for programmatic workspace access — chats, messages, and orchestration.

The OpenPieces v1 API lets you manage chats and send messages from external scripts, CI/CD pipelines, or integrations. All endpoints live under /api/v1.

Authentication

All requests require a Bearer token in the Authorization header. An API key is scoped to a single workspace — the workspace is derived from the key itself, so you never need to pass workspaceId in the request.

curl -H "Authorization: Bearer op_api_your_key_here" \

Endpoints