# Cerca

> Build long-running agents on Cloudflare Workers with durable execution, custom tools, approvals, memory, and a cloud sandbox.

## Docs

- [Create agent](https://docs.cerca.dev/api-reference/agents/create-agent.md)
- [Delete agent](https://docs.cerca.dev/api-reference/agents/delete-agent.md)
- [List agents](https://docs.cerca.dev/api-reference/agents/list-agents.md)
- [Retrieve agent](https://docs.cerca.dev/api-reference/agents/retrieve-agent.md)
- [Retrieve config](https://docs.cerca.dev/api-reference/agents/retrieve-config.md)
- [Update agent](https://docs.cerca.dev/api-reference/agents/update-agent.md)
- [Update metadata](https://docs.cerca.dev/api-reference/agents/update-metadata.md)
- [Create approval](https://docs.cerca.dev/api-reference/approvals/create-approval.md)
- [Delete approval grant](https://docs.cerca.dev/api-reference/approvals/delete-approval-grant.md)
- [Delete approval grant](https://docs.cerca.dev/api-reference/approvals/delete-approval-grant-1.md)
- [List approval grants](https://docs.cerca.dev/api-reference/approvals/list-approval-grants.md)
- [List approval grants](https://docs.cerca.dev/api-reference/approvals/list-approval-grants-1.md)
- [List approvals](https://docs.cerca.dev/api-reference/approvals/list-approvals.md)
- [List fleets](https://docs.cerca.dev/api-reference/auth/list-fleets.md)
- [Retrieve context](https://docs.cerca.dev/api-reference/auth/retrieve-context.md)
- [Attach connection](https://docs.cerca.dev/api-reference/connections/attach-connection.md)
- [Create API key](https://docs.cerca.dev/api-reference/connections/create-api-key.md)
- [Delete connection](https://docs.cerca.dev/api-reference/connections/delete-connection.md)
- [Detach connection](https://docs.cerca.dev/api-reference/connections/detach-connection.md)
- [List connections](https://docs.cerca.dev/api-reference/connections/list-connections.md)
- [List connections](https://docs.cerca.dev/api-reference/connections/list-connections-1.md)
- [Delete context entry](https://docs.cerca.dev/api-reference/context/delete-context-entry.md)
- [List context entries](https://docs.cerca.dev/api-reference/context/list-context-entries.md)
- [Retrieve context entry](https://docs.cerca.dev/api-reference/context/retrieve-context-entry.md)
- [Search context](https://docs.cerca.dev/api-reference/context/search-context.md)
- [Update context entry](https://docs.cerca.dev/api-reference/context/update-context-entry.md)
- [Agent event stream](https://docs.cerca.dev/api-reference/events/agent-event-stream.md): Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.
- [Fleet event stream](https://docs.cerca.dev/api-reference/events/fleet-event-stream.md): Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.
- [List events](https://docs.cerca.dev/api-reference/events/list-events.md)
- [List events](https://docs.cerca.dev/api-reference/events/list-events-1.md)
- [List events](https://docs.cerca.dev/api-reference/events/list-events-2.md)
- [Thread event stream](https://docs.cerca.dev/api-reference/events/thread-event-stream.md): Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.
- [Thread message stream](https://docs.cerca.dev/api-reference/events/thread-message-stream.md): Server-Sent Events stream. Each SSE data frame is JSON matching this response schema.
- [List models](https://docs.cerca.dev/api-reference/models/list-models.md)
- [Start OAuth authorization](https://docs.cerca.dev/api-reference/oauth/start-oauth-authorization.md)
- [Execute sandbox command](https://docs.cerca.dev/api-reference/sandbox/execute-sandbox-command.md)
- [Read sandbox file](https://docs.cerca.dev/api-reference/sandbox/read-sandbox-file.md)
- [Write sandbox file](https://docs.cerca.dev/api-reference/sandbox/write-sandbox-file.md)
- [Create schedule](https://docs.cerca.dev/api-reference/schedules/create-schedule.md)
- [Delete schedule](https://docs.cerca.dev/api-reference/schedules/delete-schedule.md)
- [List schedules](https://docs.cerca.dev/api-reference/schedules/list-schedules.md)
- [Trigger schedule](https://docs.cerca.dev/api-reference/schedules/trigger-schedule.md)
- [Update schedule](https://docs.cerca.dev/api-reference/schedules/update-schedule.md)
- [Cancel thread](https://docs.cerca.dev/api-reference/threads/cancel-thread.md): Cancel a running or awaiting thread. The underlying runtime treats repeat cancellation as an idempotent lifecycle operation when possible.
- [Close thread](https://docs.cerca.dev/api-reference/threads/close-thread.md): Close an idle thread. Closing a running, awaiting, or already-closed thread returns a lifecycle conflict.
- [Compact thread](https://docs.cerca.dev/api-reference/threads/compact-thread.md): Force context compaction for an idle thread. Compacting a running thread returns a lifecycle conflict.
- [Create thread](https://docs.cerca.dev/api-reference/threads/create-thread.md)
- [Create turn](https://docs.cerca.dev/api-reference/threads/create-turn.md)
- [Get thread activity](https://docs.cerca.dev/api-reference/threads/get-thread-activity.md): Fetch compact current and recent activity for a thread without returning transcript content or runtime debug state.
- [List thread messages](https://docs.cerca.dev/api-reference/threads/list-thread-messages.md): List a bounded page of transcript messages for a thread, newest first. Use the returned `cursor` to page older messages.
- [List threads](https://docs.cerca.dev/api-reference/threads/list-threads.md)
- [Retrieve thread](https://docs.cerca.dev/api-reference/threads/retrieve-thread.md)
- [Steer thread](https://docs.cerca.dev/api-reference/threads/steer-thread.md): Steer a thread with another user message. Steering a closed thread returns a conflict; steering a running or awaiting thread queues the message.
- [Create tool](https://docs.cerca.dev/api-reference/tools/create-tool.md)
- [Delete tool source](https://docs.cerca.dev/api-reference/tools/delete-tool-source.md)
- [List tools](https://docs.cerca.dev/api-reference/tools/list-tools.md)
- [List tools](https://docs.cerca.dev/api-reference/tools/list-tools-1.md)
- [Retrieve tool source](https://docs.cerca.dev/api-reference/tools/retrieve-tool-source.md)
- [Update tool source](https://docs.cerca.dev/api-reference/tools/update-tool-source.md)
- [Create webhook](https://docs.cerca.dev/api-reference/webhooks/create-webhook.md)
- [Delete webhook](https://docs.cerca.dev/api-reference/webhooks/delete-webhook.md)
- [List webhooks](https://docs.cerca.dev/api-reference/webhooks/list-webhooks.md)
- [Retrieve webhook](https://docs.cerca.dev/api-reference/webhooks/retrieve-webhook.md)
- [Rotate webhook secret](https://docs.cerca.dev/api-reference/webhooks/rotate-webhook-secret.md)
- [Send test webhook](https://docs.cerca.dev/api-reference/webhooks/send-test-webhook.md)
- [Update webhook](https://docs.cerca.dev/api-reference/webhooks/update-webhook.md)
- [Authentication](https://docs.cerca.dev/authentication.md): Use organization-scoped API keys and connection-backed credentials.
- [Client libraries](https://docs.cerca.dev/client-libraries.md): Install the official Cerca SDKs and CLI.
- [Agents](https://docs.cerca.dev/concepts/agents.md): Durable workspaces with configuration, context, tools, and sandbox state.
- [Approvals](https://docs.cerca.dev/concepts/approvals.md): Gate risky tools with exact names, namespace wildcards, and timeouts.
- [Connections](https://docs.cerca.dev/concepts/connections.md): Reusable credentials that let agents act through the right account.
- [Sandbox](https://docs.cerca.dev/concepts/sandbox.md): A persistent cloud sandbox for commands, files, and artifacts.
- [Schedules](https://docs.cerca.dev/concepts/schedules.md): Let agents run future or recurring work through the runtime.
- [Threads](https://docs.cerca.dev/concepts/threads.md): Conversations or runs inside an agent workspace.
- [Tools](https://docs.cerca.dev/concepts/tools.md): Built-in runtime tools and fleet-owned external tools.
- [Webhooks](https://docs.cerca.dev/concepts/webhooks.md): How your product hears about agent activity it didn't directly trigger.
- [Webhook events](https://docs.cerca.dev/concepts/webhooks-events.md): Reference for every webhook event type, its payload, and what triggers it.
- [Building your first agent](https://docs.cerca.dev/guides/building-your-first-agent.md): A compact path from API key to a useful long-running workspace.
- [Receiving webhooks](https://docs.cerca.dev/guides/receiving-webhooks.md): Subscribe to events, verify deliveries, and handle retries idempotently.
- [Introduction](https://docs.cerca.dev/introduction.md): A cloud-native harness for long-running agents.
- [Quickstart](https://docs.cerca.dev/quickstart.md): Verify your key, create an agent, and start using the API.

## OpenAPI Specs

- [openapi.documented](https://app.stainless.com/api/spec/documented/cerca/openapi.documented.yml)
- [openapi](https://docs.cerca.dev/api-reference/openapi.json)