Skip to main content
POST
/
feedback
Create Feedback
curl --request POST \
  --url https://analyst.heyhumm.ai/feedback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "message_helpfulness",
  "feedback_type": "thumbs_up",
  "thread_id": "<string>",
  "organization_id": "<string>",
  "score": 123,
  "value": "<string>",
  "comment": "<string>",
  "langsmith_run_id": "<string>",
  "langsmith_trace_id": "<string>"
}
'
{
  "key": "<string>",
  "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "langsmith_synced": true,
  "deleted": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "score": 123,
  "value": "<string>",
  "comment": "<string>",
  "langsmith_run_id": "<string>",
  "langsmith_trace_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request model for creating feedback.

Required fields:

  • key: Feedback category (e.g., 'helpfulness', 'accuracy')
  • feedback_type: Type of feedback (thumbs_up, thumbs_down, rating, comment, custom)
  • thread_id: Thread to provide feedback on
  • organization_id: Organization context
​
key
string
required

Feedback category key, such as message_helpfulness or answer_accuracy.

Example:

"message_helpfulness"

​
feedback_type
enum<string>
required

Feedback input type. Use thumbs_up/thumbs_down for binary sentiment, rating for scored feedback, comment for free text, or custom for app-specific values.

Available options:
thumbs_up,
thumbs_down,
rating,
comment,
custom
Example:

"thumbs_up"

​
thread_id
string
required

Thread UUID the feedback applies to.

Example:

"11111111-1111-1111-1111-111111111111"

​
organization_id
string
required

Organization UUID that owns the thread being rated.

Example:

"22222222-2222-2222-2222-222222222222"

​
score
number | null
​
value
string | null
​
comment
string | null
​
langsmith_run_id
string | null
​
langsmith_trace_id
string | null

Response

Successful Response

Response model for feedback.

​
key
string
required

Feedback key/category (e.g., 'helpfulness', 'accuracy')

​
feedback_type
enum<string>
required

Type of feedback

Available options:
thumbs_up,
thumbs_down,
rating,
comment,
custom
​
thread_id
string<uuid>
required

Internal thread ID

​
organization_id
string<uuid>
required

Organization ID

​
user_id
string<uuid>
required

User who provided the feedback

​
id
string<uuid>
required
​
langsmith_synced
boolean
required
​
deleted
boolean
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
score
number | null

Numeric score (0-1 for thumbs, 1-5 for rating)

​
value
string | null

String value for the feedback

​
comment
string | null

Additional text comment

​
langsmith_run_id
string | null

LangSmith run ID

​
langsmith_trace_id
string | null

LangSmith trace ID