---
title: Answer a question
description: Answers a question about one bucket, with a citation marker for each source, on the same call.
doc_version: 0.1.0-preview
last_updated: 2026-09-14
---

# Answer a question

`POST /v1/workspaces/{workspaceId}/answer`

Answers a question about one bucket, with a citation marker for each source, on the same call. It always runs in Standard mode: usually seconds, and at most 120 seconds, or 165 with an image. Requires the viewer role. The bucket must have indexing enabled. Nothing is stored, so a dropped call loses its answer: ask again. An image is a premium feature.

## Authentication

Send `Authorization: Bearer <GRAPHON_API_KEY>`. Read the key from the
GRAPHON_API_KEY environment variable. Never print it.

## Path parameters

- `workspaceId` (string) — The workspace id.

## Request body

- `bucketId` (string) — The bucket id. The bucket must be in the workspace and have indexing enabled.
- `query` (string) — The question to answer. It must contain text. At most 32,000 characters.
- `history` (object[] (optional)) — Earlier turns, oldest first. At most 32. Graphon does not store them. Defaults to none.
- `image` (object (optional)) — Premium. A picture to ask about: PNG, JPEG, or WebP, at most 4 MiB. It adds up to 45 seconds. Graphon keeps no copy.

## Example request

```bash
curl \
  --url "https://api.beta.graphon.ai/v1/workspaces/wspq7ws2np5l8z4/answer" \
  --header "Authorization: Bearer $GRAPHON_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"bucketId":"bktA1b2C3d4E5","query":"Why did checkout stall after the 3 October deploy?","history":[]}'
```

## Example response

```json
{
  "answer": "Release 4.18 raised checkout workers from 8 to 24 but left the database pool at 200 [[SRC:0001]].",
  "sources": [
    {
      "ref": "SRC:0001",
      "key": "incidents/2026-10-03-checkout.pdf",
      "versionId": "ver_3f9c2a7d1e4b4c8a9f0d6b2e5a1c7d3f",
      "score": 0.86,
      "cited": true,
      "location": {
        "page": 2,
        "snippet": "Release 4.18 raised CHECKOUT_WORKERS from 8 to 24. DB_POOL_SIZE stayed at 200."
      }
    }
  ],
  "warnings": [],
  "imageDescription": null,
  "timingMs": {
    "total": 6412
  }
}
```

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.