---
title: "Ask a question"
method: GET
path: "/v1/ask"
---

# Ask a question

`GET /v1/ask`

## Request

- Base URL: `https://app.takibibase.com`
- URL: `https://app.takibibase.com/v1/ask`
- Auth: HTTP bearer

Requires ask capability. Returns verbatim passages and citations; may abstain. Jev failures can fall back to deterministic extraction.

## Query parameters

- `q` string, required
- `projectId` string, uuid
- `folderId` string, uuid
- `k` integer

## Response `200`

Successful response.

- AskAnswer
  - `spans` Span[], required
    - `text` string, required
    - `documentName` string, required
    - `title` string, required
    - `documentId` string, uuid, required
    - `chunkId` string, uuid, required
  - `citations` Citation[], required
    - `documentName` string, required
    - `title` string, required
    - `documentId` string, uuid, required
    - `chunkId` string, uuid, required
  - `support` number, required: Versioned evidence support; not confidence.
  - `supportVersion` string, required
  - `abstained` boolean, required
  - `candidateCount` integer, required
  - `answerability` 'answerable' | 'partial' | 'unanswerable' | 'unknown', required
  - `conflict` boolean, required

## Other responses

- `400`: Invalid request.
- `401`: Missing, invalid, paused or revoked key, or human-only route.
- `403`: Capability or access denied.
- `404`: Resource not found or not visible.
- `429`: Daily budget spent (error.code DAILY_BUDGET_EXCEEDED) or minute throttle (RATE_LIMITED).

---

[API](https://skmtc.dev/takibibase/apis/takibi-agent-api.md) · [All operations](https://skmtc.dev/takibibase/apis/takibi-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/takibibase/apis/takibi-agent-api/revisions/5eacec570cba?raw)