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

# Validio GraphQL API Reference

> Every query, mutation, and type in the Validio GraphQL API, generated from the schema.

This reference documents every query, mutation, and type in the Validio GraphQL API. For the endpoint, authentication, and when to use the GraphQL API rather than the CSV Export API, see [About Validio API](https://docs.validio.io/developer/validio-api.md). If you're unfamiliar with GraphQL, start with [GraphQL basics](https://docs.validio.io/developer/validio-api/graphql-api/graphql-basics.md).

> **[Queries](https://docs.validio.io/api-reference/graphql/queries/sourcesList.md)**
>
> Operations that read data, one page per query.

> **[Mutations](https://docs.validio.io/api-reference/graphql/mutations/sourceCreate.md)**
>
> Operations that create, update, and delete resources.

> **[Types](https://docs.validio.io/api-reference/graphql/types/Source.md)**
>
> The objects, inputs, interfaces, enums, and unions that operations use.

## How this reference is organized

The reference is generated from the Validio GraphQL schema, and has three sections, each listed alphabetically:

* **Queries:** One page per query, with its arguments, its return type, and an example request with variables and a sample response.
* **Mutations:** One page per mutation, in the same format.
* **Types:** One page per type, including input types, enums, interfaces, and unions.

Permission requirements appear in each operation's description. For example, `channelCreate` requires `CHANNELS_WRITE`.

| Task | Operation |
| :- | :- |
| List your sources | [`sourcesList`](https://docs.validio.io/api-reference/graphql/queries/sourcesList) |
| Fetch one source by ID | [`source`](https://docs.validio.io/api-reference/graphql/queries/source) |
| List your validators | [`validatorsList`](https://docs.validio.io/api-reference/graphql/queries/validatorsList) |
| Review incidents | [`incidentGroups`](https://docs.validio.io/api-reference/graphql/queries/incidentGroups) |
| List your credentials | [`credentialsList`](https://docs.validio.io/api-reference/graphql/queries/credentialsList) |

## Snapshot

The reference is a snapshot of the schema in [Validio 11.2.0](https://docs.validio.io/changelogs/11-2.md), released on 15 October 2026.
