---
title: "Report friction with the API or MCP tools"
method: POST
path: "/v2/feedback"
tags: ["Feedback"]
---

# Report friction with the API or MCP tools

`POST /v2/feedback`

## Request

- Base URL: `https://api.sync.so`
- URL: `https://api.sync.so/v2/feedback`
- Auth: API key in header `x-api-key`

Tell the sync. team about an error that did not say what to fix, a wrong result, a missing capability or a workaround you needed. Send one report per problem; the team reviews reports daily. Works with an API key, an OAuth access token or a Studio session. Does not change, retry or cancel any job.

## Request body

- SubmitAgentFeedbackDto
  - `kind` 'confusing_error' | 'bug' | 'missing_capability' | 'workaround' | 'docs' | 'other', required: confusing_error: an error that did not say what to fix. bug: a wrong result or crash. missing_capability: an endpoint, tool or option you needed. workaround: extra steps you had to take. docs: documentation or a description that misled you.
  - `message` string, required: What you tried, what happened, and what would have helped. Include the exact error text. No personal data or secrets.
  - `severity` 'blocker' | 'major' | 'minor': blocker: you could not finish. major: you finished with a workaround. minor: an annoyance.
  - `tool` string: MCP tool or API operation the feedback is about.
  - `errorCode` string: Error code you received, such as an errorCode field.
  - `generationId` string, uuid: Generation the feedback is about.
  - `jobId` string: Other job the feedback is about: an import, transcription or translation id.
  - `source` 'api' | 'mcp': Where the report comes from. The sync. MCP server sends mcp.
  - `mcpVersion` string: sync. MCP server version, sent by the MCP server.
  - `client` object
    - `name` string, required: Your client or agent, such as an MCP host name.
    - `version` string

## Response `202`

Report received

- AgentFeedbackReceiptDto
  - `id` string, uuid, required: Reference for this report.
  - `received` true, required

## Other responses

- `400`: Invalid report
- `401`: Missing, invalid or revoked credentials
- `429`: Too many reports

## Changes

- **2026-11-05** `26662c96c138`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sync/apis/sync-api-v2/changes/v2/feedback/post.md)

---

[API](https://skmtc.dev/sync/apis/sync-api-v2.md) - [All operations](https://skmtc.dev/sync/apis/sync-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/sync/apis/sync-api-v2/revisions/26662c96c138?raw)