Create article feedback

Records a reader’s helpful-or-not verdict on an article, the same signal the help center collects.

POST /v1/feedback

Bearer token scope content:write

curl 'https://api.ferndesk.com/v1/feedback' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "article_id": "art_01JXY9AZK4KV",
  "type": "positive",
  "feedback": "This walkthrough was clear and accurate.",
  "email": "[email protected]"
}'

{
  "id": "artfb_01JXY9AZK4KV",
  "articleId": "article_01JXY9AZK4KV",
  "articleTitle": "Getting started with API keys",
  "type": "positive",
  "feedback": "This walkthrough was clear and accurate.",
  "email": "[email protected]",
  "resolved": false,
  "createdAt": "2026-01-15T18:25:43.511Z",
  "user": {
    "id": "hcusr_01JXYB3S2Y8C",
    "name": "Alice Example",
    "email": "[email protected]"
  }
}

Created feedback

Body

required application/json

article_id string required

Article identifier.

type string · enum required

Whether the reader found the article helpful.

values

positive
negative

feedback string · min length: 1· max length: 5000 required

Reader’s free text; treat as untrusted.

email string · email · pattern

Submitter address; a match links the feedback to that help center user.

Body

Responses