> ## 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

<CardGroup cols={2}>
  <Card title="Ask a Question" icon="message-question" href="/api-reference/api/ask-a-question">
    Submit a natural-language question to the ClarityQ agent.
  </Card>

  <Card title="Get Conversation Status" icon="spinner" href="/api-reference/api/get-conversation-status">
    Poll for the status of an ongoing conversation.
  </Card>

  <Card title="Get Conversation Summary" icon="file-lines" href="/api-reference/api/get-conversation-summary">
    Retrieve the summary of a completed conversation.
  </Card>

  <Card title="Get Last Completed Task Run Summary" icon="list-check" href="/api-reference/api/get-last-completed-task-run-summary">
    Get the summary of the last completed task run.
  </Card>

  <Card title="Get Prompt Usage" icon="chart-column" href="/api-reference/api/get-prompt-usage">
    Pull org-wide prompt usage by product, broken down by user, origin and day.
  </Card>
</CardGroup>