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

# How do spreadsheet clients request user authorisation?

> Authorise spreadsheet clients using a user-approved challenge exchange.

Authorise spreadsheet clients using a user-approved challenge exchange.

Read [authentication](/docs/developers/authentication), [pagination and filters](/docs/developers/pagination-and-filters), and [safe writes and retries](/docs/developers/safe-writes) before integrating. Each endpoint below includes its request parameters, response schema, and code examples.

## Endpoints

* [Create an authorisation challenge](/docs/api-reference/client-authorisation/post-v2-metrics-client-auth-challenges) — `POST /api/v2/metrics/client-auth/challenges`
* [Exchange an approved authorisation challenge](/docs/api-reference/client-authorisation/post-v2-metrics-client-auth-challenges-challenge-id-exchange) — `POST /api/v2/metrics/client-auth/challenges/{challengeId}/exchange`

[Download the complete OpenAPI specification](/docs/openapi.json) for client generation and schema validation.