Analyses
Analyses
Create diagnoses, ask follow-ups, generate postmortems, and rate accuracy
The analyses endpoints are the core of the API surface. Use them to trigger a diagnosis, fetch the result, ask follow-up questions on an existing diagnosis, or generate a postmortem from one.
Endpoints
| Method + path | Purpose |
|---|---|
POST /v1/analyses | Create an analysis |
GET /v1/analyses | List analyses for the project |
GET /v1/analyses/{id} | Fetch one analysis by id |
POST /v1/analyses/{id}/followup | Ask a follow-up on a complete analysis |
POST /v1/analyses/{id}/feedback | Rate an analysis for accuracy |
GET /v1/analyses/{id}/similar | Find similar past analyses — Pro+ |
POST /v1/analyses/{id}/postmortem | Generate a postmortem in Markdown |
POST /v1/analyses/{id}/postmortem/polish | AI-polish a postmortem — Pro+ |
Result schema
Every analysis returns the same shape, regardless of how it was triggered. See the result-schema deep-dive for field-level guidance, or the create response for the JSON shape.
See also
- Conceptual walkthrough — Analyses Deep-dive
- Time windows — strategies for picking effective time ranges
- Authentication — required permissions per endpoint