Create a workspace, issue a scoped key, and send your first run.

Get started with GetRatchet

GetRatchet records agent tool execution and lets a separate worker resume durable work after a process stops. Your application still runs the agent and owns the external tools. Start with a workspace and a scoped API key; the console and API reference are available without access to the source repository.

1. Create a workspace and key

1. Create an account and verify its email.
2. Open Settings to choose a project and environment. A new account starts with a default project and development, staging, and production environments.
3. Create an INGEST key scoped to the project and environment. Copy the secret when it is shown, then store it on your server. It is not shown again. Add a separate READ key if your service needs to query runs.

Never put an API key in browser JavaScript, a mobile bundle, a public repository, or a URL. SDK and worker requests send Authorization: Bearer <key> over HTTPS.

2. Send a run

From a server process, create a run with your INGEST key:

curl https://getratchet.waelfz.com/api/v1/runs \
  -H "Authorization: Bearer $GETRATCHET_INGEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Customer onboarding"}'

The response contains a run.id. The project and environment come from your scoped key when omitted from the request. Open Runs to inspect it. A READ key can list runs with GET /api/v1/runs; see the API reference for request and response details.

3. Choose an execution mode

• Record a local call: The TypeScript SDK wrap() helper records attempts around a function in your own process. If that process dies, GetRatchet cannot restart its closure.
• Recover after a crash: Persist a named, versioned call with enqueue(), then run a separate long-lived durable worker that registers that exact name and version. A worker key needs the WORKER scope and an allowlist for the handlers it registers.

Durable jobs may run more than once after a worker crash. Pass a stable idempotency key to the destination service for payments, email, writes, and other external effects.

Where to go next

Read the TypeScript SDK or Python SDK examples, the worker guide, and the API reference. The observability guide explains metrics and traces. For account or key help, contact GetRatchet support.