---
title: "Queue a user-approved feedback report"
method: POST
path: "/feedback"
tags: ["Feedback"]
---

# Queue a user-approved feedback report

`POST /feedback`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/feedback`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

Only the message and optional screenshot and diagnostics selected by the user are queued.

## Request body

- SubmitFeedbackInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `category` 'bug' | 'idea' | 'question', required: Report category
  - `diagnostics` Diagnostics
    - `browser` string, required
    - `component` string
    - `errors` ClientError[], nullable, required
      - `message` string, required
      - `name` string, required
      - `timestamp` string, required
    - `failed_requests` FailedAPIRequest[], nullable, required
      - `duration_ms` integer, required
      - `method` string, required
      - `path` string, required
      - `status` integer, required
      - `timestamp` string, required
    - `navigation` string[], nullable, required
    - `route_path` string, required
    - `viewport` Viewport, required
      - `height` integer, required
      - `pixel_ratio` number, double, required
      - `width` integer, required
  - `message` string, required: User-written report
  - `screenshot` Screenshot
    - `data` string, required
    - `mime_type` string, required

## Response `200`

OK

- SubmitFeedbackOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `job_id` string, required
  - `queued` boolean, required
  - `recipient` string, required

## Other responses

- `400`: Bad Request
- `413`: Request Entity Too Large
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)