# Reference overview

> How to read the generated operation reference: queries, mutations, arguments, and return types.

Product: Clad API
Source: https://docs.useclad.ai/api/reference

---

A complete, generated reference for every query and mutation in the API, grouped by domain. Each entry shows the operation signature, its arguments, and the return type. Reads are **queries**; writes are **mutations**. Every list argument follows the [pagination](#pagination) convention, every mutation returns an `error` you should check (see [Errors](#errors)), and every operation is gated by a [scope](#scopes--permissions).

> This reference is generated directly from the GraphQL schema, so it always matches the live contract. You can also browse the same schema interactively in the API Explorer.