curl -X POST 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/knowledge/ask' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"question": "Which contracts renew before March and what notice do they need?"}'

from anyformat import Client

client = Client(api_key="YOUR_API_KEY")
answer = client.ask(
    "0686bb97-8c30-70f0-8000-97669e000eb8",
    "Which contracts renew before March and what notice do they need?",
)

print(answer)
for citation in answer.citations:
    print(f"  {citation.path} p.{citation.page}: {citation.quote}")

const response = await fetch(
  'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/knowledge/ask',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      question: 'Which contracts renew before March and what notice do they need?',
    }),
  },
);

if (!response.ok) {
  throw new Error(`API error: ${response.status}`);
}

const { answer, citations } = await response.json();
console.log(answer);

{
  "answer": "Two contracts renew before March. Meridian MSA renews 2026-02-01 and needs ninety days' notice to terminate. Aldrete supply agreement renews 2026-02-14 with thirty days' notice.",
  "citations": [
    {
      "path": "2026-07/meridian-msa-2024.md",
      "quote": "Either Party may terminate upon ninety (90) days' notice.",
      "file_id": "0192f0c1-a2b3-4c5d-8000-abcdef012345",
      "block_id": "block-2",
      "page": 2,
      "bbox": { "x0": 0.08, "y0": 0.31, "x1": 0.92, "y1": 0.36 }
    }
  ],
  "path": [
    { "tool": "kb_grep", "args": { "pattern": "renewal" } },
    { "tool": "kb_read", "args": { "path": "2026-07/meridian-msa-2024.md" } }
  ],
  "steps_used": 2,
  "thread_id": null
}

{
  "error": "Knowledge base not enabled",
  "detail": "This workflow has no knowledge base. Add a knowledge node to the workflow to start indexing its documents.",
  "error_code": "KNOWLEDGE_NOT_ENABLED",
  "retryable": false
}

{
  "error": "Payment required",
  "detail": "insufficient_credit",
  "error_code": "PAYMENT_REQUIRED",
  "retryable": false
}