---
title: "Query Cache"
method: POST
path: "/cache/{name}/query"
tags: ["Cache"]
---

# Query Cache

`POST /cache/{name}/query`

Generate a completion using a pre-populated cache.

Args:
    name: Name of the cache to query.
    query: Prompt text to send to the model.
    max_tokens: Optional maximum number of tokens to generate.
    temperature: Optional sampling temperature for the model.
    auth: Authentication context for permission checks.

Returns:
    A :class:`CompletionResponse` object containing the model output.

## Path parameters

- `name` string, required

## Query parameters

- `query` string, required
- `max_tokens` integer, nullable
- `temperature` number, nullable

## Headers

- `authorization` string

## Response `200`

Successful Response

- CompletionResponse — Response from completion generation
  - `completion` union, required
    - string
    - StructuredCompletion — Structured completion object for schema-based responses
  - `usage` object, required
  - `finish_reason` string, nullable
  - `sources` ChunkSource[]
    - `document_id` string, required
    - `chunk_number` integer, required
    - `score` number, nullable
  - `metadata` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/morphik-org/apis/fastapi.md) · [All operations](https://skmtc.dev/morphik-org/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/morphik-org/fastapi/revisions/9ade02dd7b1d/schema)