curl --fail-with-body https://api.sixtyfour.ai/v1/feedback \
-H 'X-API-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: docs-correction-001' \
-d '{"job_id": "JOB_ID", "comment": "She left Acme in March.", "corrections": [{"field": "email", "value": "jane@newco.com", "returned": "jane@acme.com", "source_url": "https://www.linkedin.com/in/janedoe"}]}'
import requests
response = requests.post(
"https://api.sixtyfour.ai/v1/feedback",
headers={"X-API-Key": "YOUR_API_KEY", "Idempotency-Key": "docs-correction-001"},
json={"job_id": "JOB_ID", "comment": "She left Acme in March.", "corrections": [{"field": "email", "value": "jane@newco.com", "returned": "jane@acme.com", "source_url": "https://www.linkedin.com/in/janedoe"}]},
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.sixtyfour.ai/v1/feedback", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY",
"Content-Type": "application/json",
"Idempotency-Key": "docs-correction-001",
},
body: JSON.stringify({"job_id": "JOB_ID", "comment": "She left Acme in March.", "corrections": [{"field": "email", "value": "jane@newco.com", "returned": "jane@acme.com", "source_url": "https://www.linkedin.com/in/janedoe"}]}),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"feedback_id": "9b1e7f02-6c4d-4e8a-a3f5-2d7c0b8e1f94",
"already_submitted": false,
"created_at": "2026-11-05T18:25:40Z",
"corrections_recorded": 1,
"job_id": "job_7d1c0e52-5b8f-4c1a-9f0e-3a2b1c4d5e6f"
}
Fields
| Field | What it holds |
|---|---|
comment | What happened, in your own words. |
rating | positive or negative. |
corrections | Fields that were wrong, outdated, or missed. |
corrections[].field | The result key or workflow column, such as email. |
corrections[].value | The right value as JSON. null means the field should be empty. |
corrections[].kind | wrong, outdated, or missed. Default: wrong. |
corrections[].returned | What the API returned. Omit if you are not sending it; null means empty. |
corrections[].source_url | A public page that shows the right value. |
job_id | The Job the feedback is about. |
category | incorrect_data, outdated_data, missing_data, wrong_match, error, slow, confusing, missing_feature, billing, privacy, or other. |
impact | blocked, worked_around, or minor. |
goal | What you were trying to do. |
operation | The endpoint or tool, such as POST /v1/people/contacts. |
source | Who wrote it: kind (human, agent, or automated), plus optional agent_name, model, and reviewer. |
reply_to | An email address where Sixtyfour may reply. |
comment, rating, and corrections. Corrections need a job_id. Replace JOB_ID in the example with the job_id of one of your Jobs.
The original POST /feedback route keeps working. It also accepts task_id, dispatch_id and workflow_row.
Limits
| Limit | Value |
|---|---|
| Request body | 256 KB as JSON |
comment | 2,000 characters |
corrections | 200, each field once |
value / returned | 10,000 characters as JSON |
source_url | 2,048 characters, http or https |
Idempotency-Key | Same key and body returns the first receipt. A different body is 409. |