API Reference

A REST API for understanding code

Predictable resources for paths, diffs, diagnosis, and verification. Authenticated with bearer tokens.

Base URLhttps://api.cause.studio
  • POST
    /v1/paths
    Extract execution paths from a code snippet or repo.
  • POST
    /v1/diff
    Run differential analysis between two refs and surface risky changes.
  • POST
    /v1/diagnose
    Localize a failure from logs, stack traces, or CI output.
  • POST
    /v1/spec
    Reconstruct intended behavior from Gherkin or examples.
  • POST
    /v1/verify
    Generate the next best checks to validate a change.
  • GET
    /v1/runs/{id}
    Retrieve a previous analysis run.
Example request
curl https://api.cause.studio/v1/diagnose \
  -H "Authorization: Bearer $CAUSE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "diff": "HEAD~1..HEAD", "logs": "..." }'