POST /api/v1/interactions/recheck

Re-runs a previous analysis (recheck) using the analysis_id returned by /interactions/check.

Each recheck is a billable transaction (price configurable in Admin). This endpoint may also trigger webhooks (analysis.completed) when configured.

Headers

• X-API-Key: sm_live_...
• Content-Type: application/json

Body

{
  "analysis_id": "returned-uuid-or-id",
  "patient_context": {
    "age": 65,
    "creatinine_clearance": 35
  }
}

Response 200

Uses the same contract as POST /api/v1/interactions/check, including analysis_status, prescription_risk_level, prescription_score, normalized_medications, interactions, unverified_pairs, source_coverage, analysis_metadata, warnings and safety_notice.

• Required scope: interactions:check.
• The recheck may return cached: true if a complete response is reused for the same context.
• The X-SafeMed-* diagnostic headers remain available for troubleshooting.

Response 404 (analysis_id not found / from another organization)

{ "detail": "Análise não encontrada" }

Other error responses

HTTP	detail
401	API key required
403	Scope insuficiente para esta API key
422	analysis_id missing/invalid (validation list)
429	Rate limit excedido
504	A análise excedeu o tempo limite. Tente novamente em instantes.

Full catalog: Responses & Error Codes.