Quickstart

Create a workspace, mint an API key, and file your first issue — in a few API calls.

Quickstart

This walks the hosted path. Self-hosting on your own Cloudflare account is in Self-hosting.

Create an account and workspace

Sign up at https://<your-pile-host>. The onboarding flow creates your first workspace; grab its ID from Settings, or list workspaces:

curl -s https://<host>/workspaces \
  -H "Authorization: Bearer $PILE_API_KEY"

Mint a workspace API key

Agents and scripts authenticate with API keys pinned to one organization. Create one in Settings → Developer, or:

curl -s -X POST https://<host>/api/auth/api-keys \
  -H "Cookie: <session>" \
  -H "Content-Type: application/json" \
  -d '{"name":"ci-agent","metadata":{"organizationId":"org_..."}}'

A key cannot act outside its workspace — it is the only credential an agent needs.

File your first issue

curl -s -X POST "https://<host>/workspaces/org_.../issues" \
  -H "Authorization: Bearer $PILE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Hello Pile","description":"filed by the API"}'

Connect it to something

The point of Pile is the graph. Link the issue to a document, a customer, a deal:

curl -s -X POST \
  "https://<host>/workspaces/org_.../entities/document/<doc-id>/links" \
  -H "Authorization: Bearer $PILE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"toType":"issue","toId":"<issue-id>"}'

See Entity links for the full model.

Where next

An agent, not curl? Agent setup — MCP, CLI, SDK.
What can I link? Data model.
The whole API? API reference.