> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breakcold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Breakcold API overview.

The Breakcold Public API is available under `/api/v1` on your Breakcold API base URL.

<Warning>
  Many public API requests consume Breakcold tokens. Most successful read requests cost 20 tokens, and successful write requests cost 40 tokens. Check each endpoint's token cost before running high-volume scripts or automations.
</Warning>

Use the API for records, tasks, notes, and basic inbox workflows. Permanent record deletion is intentionally not part of v1; archive and restore are available instead.

## Webhooks

Breakcold can send outbound webhooks when records, notes, tasks, relations, calls, or files change in your workspace. See [Webhooks](/api/webhooks) for delivery headers, signature verification, event types, and payload examples.

## API URL

Use this API URL for every workspace.

```txt theme={null}
https://rest.breakcold.com/api/v1
```

The API contract is generated from `packages/backend/convex/public_api/contract.ts`.