API reference · Trust Fabric

Grade this run's path and attribute its failure

POST /fabric/trajectories/{chain_id}/analyse

Last reviewed 2026-10-02

POST /fabric/trajectories/{chain_id}/analyse

Hand a real trajectory to the two services that were built to consume one.

trajectorygate grades the *path* of a run (redundant calls, wasted branches) rather than its final answer. multi-agent-failure-tracer attributes a terminal failure to the step that caused it, via do-calculus over the dependency structure. Both have been live for weeks with no real trajectory to consume, because nothing correlated decisions into one.

Honest scope: the dependency structure handed to the tracer is the chain's linear parent/child order, which is what the fabric actually observed. If an agent fans out in parallel, the real structure is a DAG the gateway cannot see, and the attribution is correspondingly weaker. Reported, not hidden.

Parameters

Name	In	Type	Meaning
`chain_id` required	path	string

Responses

Status	Meaning	Body
`200`	Successful Response	JSON
`422`	Validation Error	`HTTPValidationError`
`401`	No key, or a key that is not valid	JSON `detail`
`429`	Rate limit for your plan reached; retry after the Retry-After seconds	JSON `detail`

Try it

Your API key X-API-Key Remember the key in this tab onlychain_id path

This call changes data in the account the key belongs to.

The request goes from your browser straight to this site. Your key is not stored unless you tick the box, and then only in this tab's session storage.

Code

curl -sS -X POST 'https://cainstudio.online/fabric/trajectories/<chain_id>/analyse' \
  -H "X-API-Key: $CAIN_API_KEY"

import json, os, urllib.request

req = urllib.request.Request('https://cainstudio.online/fabric/trajectories/<chain_id>/analyse', method='POST',
    headers={"X-API-Key": os.environ["CAIN_API_KEY"]})
with urllib.request.urlopen(req, timeout=60) as r:
    print(r.status, json.load(r))

const res = await fetch("https://cainstudio.online/fabric/trajectories/<chain_id>/analyse", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.CAIN_API_KEY!,
  },
});
console.log(res.status, await res.json());

Schemas used

HTTPValidationError · ValidationError

← Reconstruct one agent run, in order · all 79 Trust Fabric calls · Heuristic trust score, with its arithmetic shown →

Try CAIN-42 on your own agents

Create a free account and every new account starts with a 7-day trial of the full platform. Or try the sandbox first, with no account at all.

Create a free account → · Try the sandbox · See the whole ecosystem

Grade this run&#x27;s path and attribute its failure