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.

View as Markdown

Authentication

Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.

Authorization: Bearer <GRAPHON_API_KEY>

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":[]}'

Request

Loading your session…

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
  }
}

Path parameters

workspaceIdstring

The workspace id.

Request body

bucketIdstring

The bucket id. The bucket must be in the workspace and have indexing enabled.

querystring

The question to answer. It must contain text. At most 32,000 characters.

historyobject[] (optional)

Earlier turns, oldest first. At most 32. Graphon does not store them. Defaults to none.

imageobject (optional)Premium

Premium. A picture to ask about: PNG, JPEG, or WebP, at most 4 MiB. It adds up to 45 seconds. Graphon keeps no copy.

Was this page helpful?