[ surfaces · rest ]JSON over HTTPS

Plain HTTP for automation and CI.

The Hydrant REST API is plain JSON over HTTPS for webhooks, CI runners, and services that should not install a binary or host an MCP client. Same object model as MCP and CLI, same identifiers, same dependency graph.

Get a personal access tokenView setup
Base URL
https://hydrant.dev/v1
Auth header
Authorization: Bearer hyd_sk_your-token-here
Bearer personal access tokens — revocable from Hydrant settings.
Same /v1 surface for browser, server, and CI clients.
Errors return JSON with a stable `code` and `message`.
Protocol
JSON over HTTPS

One /v1 surface for browser, server, and CI clients.

Auth
Bearer PAT

Revocable tokens you mint in Hydrant settings.

Surface
Read + write

File issues, set dependencies, fetch execution bundles.

[ resource catalogue ]

The objects you can read and write.

The REST surface mirrors the same resources exposed over MCP and CLI. Endpoints below are representative — see the full reference for parameters, response shapes, and edge cases.

Issues

5 endpoints

Create, list, update, and ice issues across spaces.

GET /v1/issuesPOST /v1/issuesGET /v1/issues/{id}PATCH /v1/issues/{id}POST /v1/issues/{id}/ice

Decisions

4 endpoints

Capture decisions and propagate them across linked work.

GET /v1/decisionsPOST /v1/decisionsGET /v1/decisions/{id}PATCH /v1/decisions/{id}

Notes

5 endpoints

Long-form context: specs, briefs, and reference material.

GET /v1/notesPOST /v1/notesGET /v1/notes/{id}PATCH /v1/notes/{id}GET /v1/folders

Cycles

4 endpoints

Plan and read cycles, including their issue lists.

GET /v1/cyclesPOST /v1/cyclesGET /v1/cycles/{id}/issuesGET /v1/cycles/{id}/stats

Milestones

4 endpoints

Group issues into outcomes and track milestone progress.

GET /v1/milestonesPOST /v1/milestonesGET /v1/milestones/{id}/issuesPOST /v1/milestones/{id}/dependencies

Files

4 endpoints

Upload and reference attachments tied to issues and notes.

POST /v1/files/upload-urlPOST /v1/filesGET /v1/files/{id}GET /v1/files

Search & Bundle

4 endpoints

Search the graph and assemble execution bundles for agents.

GET /v1/searchPOST /v1/bundles/previewPOST /v1/bundlesGET /v1/bundles/{id}

Dependencies

4 endpoints

First-class dependency graph for issues and milestones.

POST /v1/issues/{id}/dependenciesPATCH /v1/dependencies/{id}DELETE /v1/dependencies/{id}POST /v1/milestones/{id}/dependencies
[ examples ]

Three calls to learn the shape.

File an issue, wire its dependencies, and pull the bundle an agent needs to execute on it. Same auth header, same identifiers, same response shapes.

Create an issue

post/v1/issues

File a ticket from a CI runner or webhook with priority, labels, and blockers.

curl https://hydrant.dev/v1/issues \
  -H "Authorization: Bearer hyd_sk_your-token-here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Audit logout on stale tokens",
    "priority": "high",
    "blocks": ["HYD-489"],
    "labels": ["auth", "security"]
  }'

Set dependencies

post/v1/issues/{id}/dependencies

Wire blockers, blocks, and related issues in a single call.

curl -X POST https://hydrant.dev/v1/issues/HYD-88/dependencies \
  -H "Authorization: Bearer hyd_sk_your-token-here" \
  -H "Content-Type: application/json" \
  -d '{
    "blockedBy": ["HYD-12"],
    "blocks": ["HYD-89"],
    "relatesTo": ["HYD-77"]
  }'

Fetch an execution bundle

get/v1/bundles/{id}

Pull the full execution context — decisions, notes, files, linked issues — for an agent.

curl https://hydrant.dev/v1/bundles/HYD-88 \
  -H "Authorization: Bearer hyd_sk_your-token-here" \
  -H "Accept: application/json"
[ setup ]

Mint a token, send a request.

Create a personal access token in Hydrant, send it as a Bearer header, and you are talking to the same surface that powers MCP and CLI. Rate limits and pagination are documented in the API reference.

First request

Authenticate with a Bearer PAT and list issues you can see.

curl https://hydrant.dev/v1/issues \
  -H "Authorization: Bearer hyd_sk_your-token-here" \
  -H "Accept: application/json"
[ Closed beta · invite only ]

Wire Hydrant into the systems
your agents already touch.

Join the wait listRead the API reference