---
title: "RECOMMENDED: Natural language query router"
method: GET
path: "/api/v1/ask"
---

# RECOMMENDED: Natural language query router

`GET /api/v1/ask`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/ask`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

High-level router for any question about the user's Google Workspace data. Automatically determines which APIs to call. Use when user asks about 'my files', 'my drive', 'my emails', 'my storage', 'my quota', etc. Returns AUTHORITATIVE LIVE data from the user's actual Google account.

## Query parameters

- `question` string, required

## Response `200`

Answer with live data

- AskResponse: Response from natural language query router
  - `user` string
  - `question` string: Original question asked
  - `answer` object: Results containing relevant data (drive_storage, drive_files, emails, etc.)
  - `used_tools` string[]: Which operations were called to answer the question
  - `_meta` object
    - `source` string
    - `authoritative` boolean
    - `data_is_current` boolean
  - `next_suggested_actions` object[]
    - `tool` string
    - `params` object
    - `reason` string

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)