---
search:
  tags:
    - Feedback
    - POST
seo:
  description: >-
    Sends feedback about the Sibi Public API to the Sibi team: a question, an
    error you are receiving,… Reference for the POST /feedback endpoint in the
    Sibi API.
sidebar:
  label: Send feedback
  badge: POST
title: Send feedback
type: openapi-operation
---
Sends feedback about the Sibi Public API to the Sibi team: a question, an error you are receiving, a missing capability, or anything else.

We read every submission, and we use the token to identify the user and organization that sent it, so you do not need to include them. We do not reply through the API. If we need more detail, we contact you through your usual Sibi channel.

The body is one plain-text `message`. When you report an error, include the method and path you called, the time of the request, and the response you received, so we can find the request.

Each user can send about 5 messages per minute and about 20 per hour. Above that, the endpoint returns 429 with a `Retry-After` header. A short burst of requests can also get a 429 without a body; wait a few seconds and send again.

`POST /feedback`

**Request body** (`application/json`, required)

- `message` (string, required) — Your feedback, question, or error report, in plain text, up to 4000 characters. When you report an error, include the method and path you called, the time of the request, and the response you received.

Request body example:

```json
{
  "message": "POST /orders returns 500 when a line item has a paint color option, at about 14:05 UTC on 2026-10-01."
}
```

**Responses**

- `202` — We received the feedback.
- `400` — Bad request - the body is not valid JSON, has fields other than \`message\`, or the message is empty or too long
- `401` — Unauthorized - Missing or invalid authentication
- `403` — Forbidden - the token was minted for the other environment, is not a Public REST API token, or does not carry the \`create:feedback\` scope
- `413` — Payload too large - the request body is larger than 16384 bytes
- `415` — Unsupported media type - the body is not sent as \`application/json\`
- `429` — Too many requests - this user sent too much feedback in a short time. Wait for the number of seconds in \`Retry-After\`.
- `500` — Internal server error
- `503` — Service unavailable - we could not record the feedback. Send it again later.

Response example, 202:

```json
{
  "id": "fb_3f0c2a9e-6d1b-4c47-9a35-0e8f2b7d5c11",
  "receivedAt": "2026-10-01T16:04:11.000Z"
}
```

Response example, 400:

```json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input parameters"
}
```

Response example, 401:

```json
{
  "code": "UNAUTHORIZED",
  "message": "Missing authentication token"
}
```

Response example, 403 · environmentMismatch:

```json
{
  "code": "TOKEN_ENVIRONMENT_MISMATCH",
  "message": "A test token was used against the production API. Test tokens only work against the Sibi test environment; use a production token here."
}
```

Response example, 403 · restTokenRequired:

```json
{
  "code": "REST_TOKEN_REQUIRED",
  "message": "This endpoint only accepts Public REST API tokens. Create one at https://developer.sibipro.com."
}
```

Response example, 403 · insufficientScope:

```json
{
  "code": "INSUFFICIENT_SCOPE",
  "message": "The presented token is missing the `create:feedback` scope, which this endpoint requires. Create a token with the scopes you need at https://developer.sibipro.com."
}
```

Response example, 413:

```json
{
  "code": "PAYLOAD_TOO_LARGE",
  "message": "The request body is larger than 16384 bytes"
}
```

Response example, 415:

```json
{
  "code": "UNSUPPORTED_MEDIA_TYPE",
  "message": "Send the request body as application/json"
}
```

Response example, 429:

```json
{
  "code": "RATE_LIMITED",
  "message": "Too many feedback requests. Try again later."
}
```

Response example, 500:

```json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred"
}
```

Response example, 503:

```json
{
  "code": "FEEDBACK_UNAVAILABLE",
  "message": "Feedback could not be delivered. Try again later."
}
```