---
title: "Intent router — describe what you need in natural language, get the right endpoint(s)"
method: GET
path: "/api/v1/route"
---

# Intent router — describe what you need in natural language, get the right endpoint(s)

`GET /api/v1/route`

## Request

- Base URL: `https://heatpulse.cc`
- URL: `https://heatpulse.cc/api/v1/route`
- Auth: none declared

Semantic matching over HeatPulse's curated knowledge-route table (internal endpoints + external authoritative sources). Use this first when unsure where a piece of AI knowledge lives.

## Query parameters

- `intent` string, required
- `limit` integer

## Response `200`

Ranked routes

- Routes
  - `intent` string
  - `routes` object[]
    - `type` 'internal' | 'external'
    - `url` string
    - `why` string
    - `score` number

## Other responses

- `400`: Missing intent

---

[API](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api.md) · [All operations](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api/revisions/13aa08eaae7e?raw)