> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Feedback API

> Submit in-app product feedback from the dashboard Feedback dialog

# Feedback API

Submit in-app product feedback from the dashboard Feedback dialog

**Base path:** `/api/v1/feedback`

**Endpoint count:** 1

### Submit product feedback

<Note>
  `POST /api/v1/feedback`
</Note>

<ParamField body="category" type="string (enum: idea|issue|other)" required>
  Feedback category shown in the dialog's selector — `idea` for a suggestion, `issue` for something not working, or `other` for general feedback.
</ParamField>

<ParamField body="message" type="string" required>
  The free-text feedback message (1–4000 characters).
</ParamField>

<ParamField body="pagePath" type="string">
  Dashboard page the feedback was sent from (e.g. `/contacts`), up to 512 characters. Included as context in the feedback email.
</ParamField>

<ParamField body="locale" type="string">
  Active dashboard locale (e.g. `en`), up to 32 characters. Included as context in the feedback email.
</ParamField>

The message is delivered to the Devotel feedback inbox as a transactional email
with the authenticated submitter's address set as reply-to. The response
reports whether delivery succeeded: `delivered` is `true` when the email was
sent (or durably queued for retry) and `false` when transactional email is not
configured, in which case the dashboard falls back to its copy / mail-client
hand-off.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.orbit.devotel.io/api/v1/feedback" \
    -H "X-API-Key: dv_live_sk_your_key_here" \
    -H "Content-Type: application/json" \
    -d '{
    "category": "idea",
    "message": "It would be great to bulk-export contacts as CSV.",
    "pagePath": "/contacts",
    "locale": "en"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": { "delivered": true },
    "meta": {
      "request_id": "req_...",
      "timestamp": "2026-07-03T00:00:00.000Z"
    }
  }
  ```
</ResponseExample>