Docs/Trace/Core Engine API

Core Engine API

Interact directly with the Trace Core Engine. These are the endpoints used by the SDK, CLI, and Extension.

https://api.probe.sh/v1

Authentication

Authenticate requests by setting the x-api-key header.

curl -H "x-api-key: YOUR_KEY" https://api.probe.sh/v1/plan

Engine Endpoints

POST/plan

The Planner. Given a user's intent, the engine decides which tools need to be executed to gather necessary information.

Input

{
  "query": "Why is the login button disabled?"
}

Output (Plan)

{
  "steps": [
    { "tool": "get_dom_element", "selector": "#login-btn" },
    { "tool": "check_local_storage", "key": "auth_token" }
  ]
}

POST/analyze

The Analyst. Given the results from the executed tools, the engine provides a human-readable explanation and fix suggestions.

Input

{
  "query": "Why is the login button disabled?",
  "tool_results": [
    { "tool": "get_dom_element", "result": { "disabled": true, "className": "btn-disabled" } }
  ]
}

Output (Answer)

{
  "explanation": "The button is disabled because it has the 'btn-disabled' class, likely waiting for input validation.",
  "suggestion": "Check if form validation logic is failing."
}

Management Endpoints

Standard endpoints for managing project data.

GET/projects

GET/events