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

# API Reference

> ClarityQ public API endpoints, authenticated via API keys.

# API Reference

The ClarityQ API allows you to interact with ClarityQ programmatically using API keys. All endpoints require authentication via the `X-API-Key` header.

**Base URL:** `https://api.clarityq.ai`

## Endpoints

> [card] [Ask a Question](https://docs.clarityq.ai/api-reference/api/ask-a-question.md)
>
> Submit a natural-language question to the ClarityQ agent.

> [card] [Get Conversation Status](https://docs.clarityq.ai/api-reference/api/get-conversation-status.md)
>
> Poll for the status of an ongoing conversation.

> [card] [Get Conversation Summary](https://docs.clarityq.ai/api-reference/api/get-conversation-summary.md)
>
> Retrieve the summary of a completed conversation.

> [card] [Get Last Completed Task Run Summary](https://docs.clarityq.ai/api-reference/api/get-last-completed-task-run-summary.md)
>
> Get the summary of the last completed task run.

> [card] [Get Prompt Usage](https://docs.clarityq.ai/api-reference/api/get-prompt-usage.md)
>
> Pull org-wide prompt usage by product, broken down by user, origin and day.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.