Deliver feedback from the dialog

The dashboard’s Feedback dialog posts every in-app product note here. The dialog’s three categories (idea, issue, other) and free-text message travel as JSON, and two optional fields carry the reading context: pagePath (the screen the customer was on) and locale (the active dashboard language). Your API key identifies the submitter; the endpoint resolves their name and organization so the reply routed to the Devotel feedback inbox reads as a person, not an anonymous log line. The message is dispatched as a transactional email with the submitter’s address set as reply-to, and the response carries a delivered flag so the dialog renders the right confirmation.

{
  "data": {
    "delivered": true
  },
  "meta": {
    "request_id": "req_feedback",
    "timestamp": "2026-08-01T12:00:00.000Z"
  }
}

delivered: false means transactional email is not configured on the account — the dashboard falls back to a copy / mail-client hand-off instead of claiming a delivery that never happened. Either way the same [ data, meta ] envelope holds.

Worked request and response samples

Copy the request as written, substitute your own ids, and compare the response envelope — a success in the same shape the numbered error sections spell out.

Deliver product feedback

POST /api/v1/feedback

Send the note as the dashboard dialog sends it — category, message, and the optional reading context. Request fields

Field	Type	Required	Notes
`category`	string — one of `idea`, `issue`, `other`	yes	`idea` for a suggestion, `issue` for something not working, `other` for general feedback.
`message`	string	yes	Free-text feedback, 1–4000 characters after trimming.
`pagePath`	string	no	Dashboard page the feedback was sent from (e.g. `/contacts`), up to 512 characters.
`locale`	string	no	Active dashboard locale (e.g. `en`), up to 32 characters.

Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/feedback" \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "category": "idea",
  "message": "It would be great to bulk-export contacts as CSV.",
  "pagePath": "/contacts",
  "locale": "en"
}'

Node.js

const res = await fetch("https://api.orbit.devotel.io/api/v1/feedback", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ORBIT_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    category: "idea",
    message: "It would be great to bulk-export contacts as CSV.",
    pagePath: "/contacts",
    locale: "en",
  }),
});
console.log(await res.json());

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/feedback", bytes.NewBuffer([]byte(`{
  "category": "idea",
  "message": "It would be great to bulk-export contacts as CSV.",
  "pagePath": "/contacts",
  "locale": "en"
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Response

{
  "data": {
    "delivered": true
  },
  "meta": {
    "request_id": "req_9f2a4c6e1b7d3e8f",
    "timestamp": "2026-09-08T12:00:00Z"
  }
}

Response envelope fields

data.delivered is the only body field — there is no persisted feedback record, so no data.id confirmation exists for this endpoint. The delivery flag (or the dashboard’s copy / mailto fallback) is the entire contract.

Field	Type	Meaning
`data.delivered`	boolean	`true` when the feedback email was sent or durably queued for retry; `false` when transactional email is not configured on the account.
`meta.request_id`	string	Unique request identifier, echoed as the `X-Request-Id` response header — quote it when contacting support about a submission.
`meta.timestamp`	string	ISO-8601 server time of the response.
`meta.test_mode`	boolean	Present and `true` only when the call ran through the sandbox pipeline (a `dv_test_sk_*` key, or `X-Test-Mode: true` on a session-authenticated call).

API Reference

All Endpoints

Deliver feedback from the dialog