---
title: "Call AI"
description: "Call AI APIs give programmatic access to conversation intelligence data, including recordings, transcripts, themes, and insights, through a GraphQL endpoint."
contentType: "overview"
url: "https://developer.mindtickle.com/docs/call-ai/"
---

Call AI APIs give you programmatic access to conversation intelligence data with GraphQL. Unlike the standard REST endpoints, this API lets you query specific fields, such as call recordings, transcripts, and insights, in a single request.

## Key capabilities

- **Recording retrieval:** Fetch detailed metadata for meetings, including participants, duration, host details, and call scores.
- **Conversation insights:** Access full-text transcripts and analyze spoken or heard themes to measure conversation quality and compliance.
- **Media export:** Generate secure, pre-signed URLs to download audio or video files for offline backup and migration.

## Prerequisites and shared context

- **Authentication:** Call AI uses its own OAuth 2.0 flow, not the standard REST bearer token. Generate an access token and pass it in the header of your GraphQL requests. See [Authentication](/docs/call-ai/authentication/).
- **Base URL:** Send all GraphQL requests to `https://api-gateway.callai.mindtickle.com/public/graphapi`.
- **Credentials:** Contact [Mindtickle Support](mailto:support@mindtickle.com) for your client credentials, tenant details, authentication base URL, and explicit approval to access specific fields or data sets within the Call AI API.
- **Download permission:** To access the download URLs for media files, you must have a specific permission enabled for your client ID. Contact [Mindtickle Support](mailto:support@mindtickle.com) to request it.

:::note
Call AI API access is scoped based on user roles and recording permissions. Users can only access Call AI data for call recordings they are authorized to view within Call AI.
:::

## In this category

- [Authentication](/docs/call-ai/authentication/): the OAuth 2.0 token lifecycle for Call AI requests.
  - [Get an authorization code](/docs/call-ai/authentication/get-an-authorization-code/): obtain the temporary code used to request a token.
  - [Generate an access token](/docs/call-ai/authentication/generate-an-access-token/): exchange the authorization code for an access token and a refresh token.
  - [Refresh an access token](/docs/call-ai/authentication/refresh-an-access-token/): regenerate an access token with the refresh token.
  - [Validate a token](/docs/call-ai/authentication/validate-a-token/): retrieve the user and client details associated with an active token.
- [GraphQL API](/docs/call-ai/graphql-api/): the GraphQL endpoint, query mechanics, and error handling.
  - [Query call data](/docs/call-ai/graphql-api/query-call-data/): fetch recordings, participants, transcripts, themes, and scores with the `recordingsV2` query.
  - [Download call recordings](/docs/call-ai/graphql-api/download-call-recordings/): retrieve pre-signed URLs for audio and video files.

## Related

- [API overview](/docs/getting-started/api-overview/): what the Mindtickle API suite covers.
- [Authentication and setup](/docs/getting-started/authentication-and-setup/): base URLs, authentication, rate limits, and status codes for the REST APIs.