For AI agents: every API docs page in one plain-text file is at /docs/llms-full.txt, and the documentation index is at /llms.txt. This page is available as Markdown at https://diffio.ai/docs/api-reference/create-transcript-assistant-feedback.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

Send assistant feedback
Sends the Diffio team a bug report, an idea or other feedback about the edit assistant on one generation (201 Created). Use it for the feedback form an assistant turn offers in feedback_offer.
POST https:/
- Key scope:
generations:write - Auth header:
Authorization: Bearer <apiKey> - Body: JSON
Request
Send a message, the conversation with include_conversation: true, or both; a report with neither is refused.
Path parameters
Headers
| Field | Type | Required | Description |
|---|---|---|---|
#Diffio-End-User | string | Required: No | Optional end-user identifier (up to 128 characters). Scopes the request to that end user's projects and counts the report against that end user's limit; omit to act across the whole account. |
Body fields
| Field | Type | Required | Description |
|---|---|---|---|
#kind | string | Required: No | What the report is: bug, feature (an idea) or other. Any other value is recorded as other.bugfeatureother |
#message | string | Required: No | The person's note (up to 4,000 characters; longer text is cut). |
#turn_id | string | Required: No | The assistant turn the report is about, from Ask the edit assistant; it must be a turn of this generation. |
#include_conversation | boolean | Required: No | Set true to attach conversation to the report; otherwise conversation is ignored. |
#conversation | array | Required: No | The chat as the person saw it, oldest first; the newest 80 turns are kept and malformed entries are dropped.Fields below |
#page_url | string | Required: No | The page the report was written on (up to 500 characters kept). |
#user_agent | string | Required: No | The person's browser (up to 300 characters kept). |
#source | string | Required: No | Where the report was written, for example panel (the default; up to 40 characters kept). |
conversation[] 5 fields
| Field | Type | Required | Description |
|---|---|---|---|
#conversation[] | string | Required: Yes | Who wrote the turn.userassistant |
#conversation[] | string | Required: No | The turn's text (up to 4,000 characters kept). |
#conversation[] | string | Required: No | An error shown with the turn, if any (up to 500 characters kept). |
#conversation[] | integer | Required: No | How many moments the answer showed. |
#conversation[] | array | Required: No | The answer's proposals as shown (up to 20): title, changes, accepted, skipped and examples. |
Request
The Python and Node.js SDKs have no helper for this endpoint yet; send it with cURL or any HTTP client.
curl -X POST "https://api.diffio.ai/v2/projects/73118d99-36cf-4039-8005-b962d522fff7/generations/73c84c4a-c1ca-5485-b396-171ab632d4b7/transcript/assistant/feedback" \
-H "Authorization: Bearer $DIFFIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kind": "feature",
"message": "I want to cut the intro down to ten seconds.",
"turn_id": "8f14e45fceea4e6b9d2c7a1b3e5d9f02",
"include_conversation": true,
"conversation": [
{
"role": "user",
"text": "Shorten the intro to ten seconds."
},
{
"role": "assistant",
"text": "I can remove or replace words, but I cannot trim a passage to a set length."
}
],
"source": "panel"
}'Response
Returns 201 Created with the recorded transcript_assistant_feedback.
Success: 201Created.
Response fields
| Field | Type | Present | Description |
|---|---|---|---|
#object | string | Always | Resource type, always "transcript_assistant_feedback".transcript_assistant_feedback |
#id | string | Always | Identifier of the recorded report. |
#project_id | string | Always | Identifier of the project. |
#generation_id | string | Always | Identifier of the generation. |
#turn_id | string | null | Always | The assistant turn the report is about, or null. |
#emailed | boolean | Always | true when the report reached the Diffio team by email; false when only the record was kept (the team still sees it). |
Response 201Created.
{
"object": "transcript_assistant_feedback",
"project_id": "73118d99-36cf-4039-8005-b962d522fff7",
"generation_id": "73c84c4a-c1ca-5485-b396-171ab632d4b7",
"id": "kV2mR8sTq4LwZ1bN6yPd",
"turn_id": "8f14e45fceea4e6b9d2c7a1b3e5d9f02",
"emailed": true
}Return codes
201Created.Report recorded (and emailed to the Diffio team whenemailedistrue).400Bad request.Malformed JSON, or 3 more causes
- Malformed JSON
- Neither a
messagenor an includedconversation - A
turn_idthat is not a turn id - Oversized header
invalid_jsoninvalid_fieldinvalid_header403Forbidden: the key lacks permission.Key is inactive or lacksgenerations:write.permission_denied404Not found.Project not found, or 2 more causes
- Project not found
- Generation not found
turn_idnames no turn of this generation
project_not_foundgeneration_not_foundtranscript_assistant_turn_not_found429Too many requests.More than 10 reports in an hour from this end user, or this account withoutDiffio-End-User.rate_limited502Bad gateway.Diffio could not record the report; retry with backoff.internal_error401Unauthorized: the API key is missing or invalid.405Client error.Same on every endpoint401Unauthorized: the API key is missing or invalid. Missing API key (code missing_api_key), or invalid API key (code invalid_api_key).405Client error. HTTP method not supported on this path; check the Allow header (code method_not_allowed).
Example error response
Errors are JSON: an error object with code, message and request_id. An unrecognized key returns 401Unauthorized: the API key is missing or invalid.:
{
"error": {
"code": "invalid_api_key",
"message": "Invalid API key.",
"request_id": "dead773b60e148fd9e22d680a22fa701"
}
}Notes
- When a completed turn has a
feedback_offer, show a form prefilled with itskindandsummary, then send what the person writes here with that turn'sidasturn_id. - Reports are not billed. Each end user (or the account, without
Diffio-End-User) can send 10 reports per hour.