---
title: Ask AI API Reference
---

import AskAIDeprecationNotice from '@site/src/components/mdx/ask-ai-deprecation-notice.jsx';

<AskAIDeprecationNotice />

:::warning
New and migrating integrations should use [Agent Studio](https://www.algolia.com/doc/guides/algolia-ai/agent-studio) instead of the Ask AI API.
If you call these endpoints today, configure your client to use Agent Studio completions.
For migration steps, see [Migrate Ask AI to Agent Studio](/docs/v4/v4/migrating-askai-to-agent-studio).
:::

The Ask AI API lets you build custom chat interfaces powered by an Algolia Ask AI assistant.
These endpoints search your Algolia index and generate contextual responses with your LLM provider.

Prefer Agent Studio for new work:

- [Integrate Agent Studio](https://www.algolia.com/doc/guides/algolia-ai/agent-studio/how-to/integration)
- [Agent Studio API](https://www.algolia.com/doc/rest-api/agent-studio)

This page is mainly for developers who built custom Ask AI HTTP clients.
If you use DocSearch, configure Agent Studio in DocSearch instead—
see [Migrate Ask AI to Agent Studio](/docs/v4/v4/migrating-askai-to-agent-studio).

## Legacy Ask AI API

Legacy Ask AI HTTP docs remain available for reference while you migrate:

**[Algolia Ask AI API Reference](https://www.algolia.com/doc/guides/algolia-ai/askai/reference/api)**

**Base URL:** `https://askai.algolia.com`

That reference covers the older Ask AI token, chat, and feedback endpoints. Prefer Agent Studio for all new work.

For DocSearch SDK setup (including `agentStudio: true`), see [Migrate Ask AI to Agent Studio](/docs/v4/v4/migrating-askai-to-agent-studio) and [Get started with Ask AI](/docs/v4/v4/askai).