---
title: "Report a failed completion"
method: POST
path: "/api/report"
tags: ["telemetry"]
---

# Report a failed completion

`POST /api/report`

Report failed or problematic completions to help improve Morph's quality. Reference the completion by the id returned with the original response and describe the failure; the original request and response are already on file.

## Request body

- ReportRequest — A single problematic completion, identified by id and described by its failure.
  - `completion_id` string, required — The completion ID from the original request (found in response headers or logs)
  - `failure_reason` string, required — Description of what went wrong (Error message, traceback, etc.)
  - `user_query` string — Optional: The original user instruction that led to the problematic completion

## Response `200`

Report successfully recorded

- ReportResponse — Acknowledgement that the report was stored, with the internal record id.
  - `success` boolean, required — Whether the report was successfully recorded
  - `message` string, required — Confirmation message
  - `data` object — Additional response data
    - `request_log_id` string — Internal ID of the reported request
    - `reported_at` string, date-time — ISO timestamp when the report was recorded

## Other responses

- `400` — Malformed request — missing or invalid fields.
- `401` — Missing or invalid API key.
- `429` — Rate limited — retry after the interval in the Retry-After header.
- `500` — Internal error — safe to retry with backoff.

---

[API](https://skmtc.dev/morphllm/apis/morph-api.md) · [All operations](https://skmtc.dev/morphllm/apis/morph-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/morphllm/morph-api/revisions/b9a74274b2ab/schema)