> ## Documentation Index
> Fetch the complete documentation index at: https://datum-4926dda5-docs-api-reference-demo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTPRoute skill

> Teach agents to configure HTTP routing rules — path matching, traffic splitting, redirects, rewrites, and header manipulation on Datum Cloud.

The HTTPRoute skill helps agents configure HTTP routing rules in Datum Cloud. It covers [AI Edge](/ai-edge/overview) route definitions — matching requests by path, headers, method, and query parameters, then forwarding, splitting, redirecting, rewriting, or mirroring traffic using `HTTPRoute` resources attached to a Gateway.

## Install

<CodeGroup>
  ```bash Claude Code theme={null}
  /plugin marketplace add datum-cloud/skills
  /plugin install datum-cloud@datum-cloud
  ```

  ```bash npx skills theme={null}
  npx skills add https://github.com/datum-cloud/skills
  ```

  ```bash Cursor theme={null}
  # Settings → Rules → Add Rule → Remote Rule (GitHub)
  # Repository: datum-cloud/skills
  ```
</CodeGroup>

<Note>
  Once installed, the skill activates automatically when you ask an agent to configure HTTP routing on Datum. No further configuration needed.
</Note>

## Capabilities

* Route traffic by path (exact, prefix, regex), HTTP method, headers, and query parameters
* Split traffic across multiple backends by weight (canary, A/B, blue-green deployments)
* Redirect HTTP to HTTPS and issue permanent or temporary redirects
* Rewrite URL paths and hostnames before forwarding to backends
* Add, set, or remove request and response headers per route rule
* Mirror (shadow) a percentage of traffic to a secondary backend without affecting responses
* Configure per-route request and backend timeouts
* List, inspect, and update routes across a project
* Preview changes before applying with `datumctl diff`
* Delete routes safely
* Check permissions before acting

## How it relates to other Datum surfaces

* **Product docs:** [AI Edge](/ai-edge/overview) — the human-facing reference for gateways and routing
* **Datum MCP:** [Datum MCP](/datum-mcp) — for agents that need live read/write access to HTTPRoute resources during a session
* **`datumctl`:** [datumctl overview](/datumctl/overview) — `get`, `describe`, `apply`, `diff`, `delete` commands the skill teaches agents to use

## View the full skill

The canonical SKILL.md lives in the [datum-cloud/skills](https://github.com/datum-cloud/skills) repo:

<CardGroup cols={2}>
  <Card title="On GitHub" icon="github" href="https://github.com/datum-cloud/skills/blob/main/skills/httproute/SKILL.md">
    Browse the skill source, including frontmatter and full instructions.
  </Card>

  <Card title="Raw SKILL.md" icon="file-code" href="https://raw.githubusercontent.com/datum-cloud/skills/main/skills/httproute/SKILL.md">
    Direct URL for agents that fetch skills by URL.
  </Card>
</CardGroup>