# API reference

Every operation in the GetItDone public REST API, grouped by resource — organizations, tasks, projects, the daily plan, attachments, members, usage, API keys, and webhooks.

Every operation in the GetItDone public `/v1` REST API, generated from the
[OpenAPI 3.1 document](/docs/api/openapi.json) — the same document the `/v1`
handlers and the published TypeScript SDK are generated from, so the reference
cannot drift from the API.

Pick a resource in the sidebar, or start with the concepts:

- [Authentication](/docs/api#authentication) — `gid_` keys, Bearer auth, test keys.
- [Errors](/docs/api#errors) — RFC 9457 problem documents and the stable `code`.
- [Rate limits & quotas](/docs/api#rate-limits) — burst window vs billing-period allowance.
- [Pagination](/docs/api#pagination) — the cursor envelope.
- [Idempotency](/docs/api#idempotency) — safe retries on consequential POSTs.
- [Webhooks](/docs/api/webhooks) — signed outbound task events.

Every operation page shows the request shape, the response shape, a runnable
example, and the problem codes it can answer with.