---
title: "Query Rag Direct"
method: POST
path: "/api/v3/rag/query-direct"
tags: ["RAG"]
---

# Query Rag Direct

`POST /api/v3/rag/query-direct`

Convenience endpoint - combines preprocess and query

Args:
    unique_id: Institution's unique ID (e.g., "k12_602442")
    description: User's query/prompt
    search_category: Category to search (e.g., meeting_minutes, procurement_guidelines, youtube)
    keyword_config: Optional keywords and search logic (AND/OR)
    date_range: Optional date range filter

Returns:
    RAG response with content, citations, and summary

## Query parameters

- `unique_id` string, required
- `description` string, required
- `search_category` string, required

## Request body

- BodyQueryRagDirectApiV3RagQueryDirectPost
  - `keyword_config` AppRoutesV3RagKeywordConfig
    - `logic` 'AND' | 'OR', required
    - `keywords` string[], required
  - `date_range` AppRoutesV3RagDateRange
    - `from` string, date-time, nullable
    - `to` string, date-time, nullable

## Response `200`

Successful Response

- RagQueryResponse
  - `type` string, required
  - `content` string, required
  - `citations` object[], required
  - `summary` string, required
  - `is_starred` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)