---
title: "Report a problem with one version"
method: POST
path: "/v1/diagrams/{id}/reports"
tags: ["Diagrams"]
---

# Report a problem with one version

`POST /v1/diagrams/{id}/reports`

## Request

- Base URL: `https://api.zindex.ai`
- URL: `https://api.zindex.ai/v1/diagrams/{id}/reports`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Sends one version (default the latest) to Zindex support with a one-line problem. A report is its own record: the diagram's visibility doesn't change. Anonymized unless anonymize is false: Zindex keeps the anonymized copy and staff see only that. Pass the seed from POST /v1/diagrams/{id}/reports/preview so the copy is exactly the one previewed. Every staff view is logged. Withdraw with DELETE /v1/diagrams/{id}/reports/{reportId}.

## Path parameters

- `id` string, required

## Headers

- `X-Zindex-Client` string

## Request body

- object
  - `problem` string: What is wrong, in one line
  - `revision` integer: The version that is wrong; default the latest
  - `anonymize` boolean
  - `seed` integer: The seed the report preview returned

## Response `201`

{ reportId, id, revision, reported: true, anonymized }. reportId names the report for GET and DELETE /v1/diagrams/{id}/reports/{reportId}.

## Other responses

- `400`: INVALID_REQUEST
- `401`: Missing or invalid API key. Response includes a `code` field that distinguishes the failure mode so clients (dashboard, MCP server) can render actionable copy: `AUTH_REQUIRED` (no key or session was sent), `API_KEY_INVALID` (key not found), `API_KEY_REVOKED` (key was revoked, or its person is no longer in its workspace), `API_KEY_EXPIRED` (key passed its expires_at), and for the site's session cookie `SESSION_EXPIRED` (past its 24 hours), `SESSION_REVOKED` (the account's sessions were ended, for example by a password reset) and `SESSION_INVALID` (not a session this server signed).
- `403`: EMAIL_NOT_VERIFIED: verify the account's email first; READ_ONLY: a read key or a viewer
- `404`: NOT_FOUND
- `429`: RATE_LIMITED: over the request rate limit (see Rate Limiting). Wait retryAfter seconds (also the Retry-After header), then try again.

---

[API](https://skmtc.dev/zindex/apis/zindex-api.md) · [All operations](https://skmtc.dev/zindex/apis/zindex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zindex/apis/zindex-api/revisions/1d21bd5bbf8e?raw)