API Documentation
← All tools
GET
/api/v1/merged/pathPath
mergedAvailable on FreeNo success wrapper
Returns the boundary of a multi-step traversal starting from one or more start nodes, following the requested step sequence. Call it to walk relationships across the merged graph from known starting points. Fails with 400 when start is empty, when steps cannot be parsed, or when required data is not loaded; returns 500 on internal errors.
When to use it
- Trace a multi-hop relationship path from known starting nodes
- Explore connected entities across several relationship steps
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Rate limit
Every call counts against your workspace’s daily quota for regulatoryApiCallsPerDay. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 30 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| start | string (comma-separated) | Yes | [comma-separated list] minimum length 1 |
| steps | string | Yes | minimum length 1 |
| limit | integer | No | Range 1-50000; default 20000 (range 1-50000; default 20000) Range: 1 to 50000 |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/merged/path?start=your_start&steps=your_steps"
Response envelope
This endpoint returns an implicit 2xx response - there is no success flag in the body.
{
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}
// No "success" flag on this endpoint - any 2xx JSON is a success.Catalog version mcp-2026-10-28 · generated from the live MCP catalog