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/get-transcript-assistant-turn.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

Get an edit assistant turn
Reads one edit-assistant turn: processing while it runs, complete once reply, proposals, and moments are ready, or failed with error.
GET https:/
- Key scope:
generations:read - Auth header:
Authorization: Bearer <apiKey> - Body: None
Request
Pass project_id, generation_id, and turn_id in the path; takes no request body.
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; omit to act across the whole account. |
Request
import os
from diffio import DiffioClient
key = os.environ["DIFFIO_API_KEY"]
client = DiffioClient(api_key=key)
turn = client.assistant.get_turn(
"73118d99-36cf-4039-8005-b962d522fff7",
"73c84c4a-c1ca-5485-b396-171ab632d4b7",
"8f14e45fceea4e6b9d2c7a1b3e5d9f02",
)Response
Returns the transcript_assistant_turn, merged with answer fields once status is complete.
Success: 200OK.
Response fields
| Field | Type | Present | Description |
|---|---|---|---|
#object | string | Always | Resource type, always "transcript_assistant_turn".transcript_assistant_turn |
#id | string | Always | Unique identifier of the assistant turn. |
#project_id | string | Always | Identifier of the parent project. |
#generation_id | string | Always | Identifier of the Pro generation. |
#status | string | Always | Turn state: processing while running, complete when answer fields are populated, or failed when error is set.processingcompletefailed |
#created_at | string | null | Always | ISO 8601 UTC timestamp when the turn was created, or null. |
#completed_at | string | null | Always | ISO 8601 UTC timestamp when the turn finished, or null while processing. |
#error | object | null | Always | Failure details when status is failed, or null otherwise. |
Show all 23 fields (15 more)
| Field | Type | Present | Description |
|---|---|---|---|
#error. | string | Always | Stable snake_case turn failure code (rate_limited, assistant_timeout, assistant_unavailable, not_editable, invalid_field, permission_denied, unauthenticated, project_not_found, or internal_error). |
#error. | string | Always | Human-readable message explaining why the turn failed. |
#reply | string | Sometimes | Assistant reply text to show the user (present when status is complete, up to 1,200 characters). |
#proposals | array | Sometimes | Proposed transcript edit groups referencing words[].id (present when status is complete).Fields below |
#moments | array | Sometimes | Notable timestamps referenced in the answer (up to 8 items, present when status is complete).Fields below |
#unclear_word_ids | array | Sometimes | Word IDs that an audio listening pass found hard to understand. |
#speaker_turns | array | Sometimes | Detected speaker turn starts keyed by word_id. |
#speaker_turns[] | string | Sometimes | First word ID of the speaker turn. |
#speaker_turns[] | string | Sometimes | Speaker label for the turn. |
#shortening | object | null | Sometimes | Suggested tighten settings for audio projects, or null.Fields below |
#feedback_offer | object | null | Sometimes | Optional prompt inviting user feedback when the assistant detects a product report, or null; send the report with Send assistant feedback. |
#feedback_offer. | string | Sometimes | Feedback category (bug, feature, or other).bugfeatureother |
#feedback_offer. | string | Sometimes | Suggested one-line summary for the feedback report. |
#notices | array | Sometimes | Informational notices returned alongside the answer. |
#windows_total | integer | Sometimes | Total 30-second windows that the current draft plus all proposals would restore. |
proposals[] 13 fields
| Field | Type | Present | Description |
|---|---|---|---|
#proposals[] | string | Sometimes | Identifier of the proposal. |
#proposals[] | string | Sometimes | Short title summarizing the proposed edits. |
#proposals[] | string | Sometimes | Category icon identifier for the proposal.fillerreplacerephrasemuteregenerategrammarcleanupinsert |
#proposals[] | array | Sometimes | Ordered word-level changes in this proposal. |
#proposals[] | string | Sometimes | Identifier of the change. |
#proposals[] | string | Sometimes | Change action: replace, remove, insert, or regenerate.replaceremoveinsertregenerate |
#proposals[] | array | Sometimes | Ordered words[].id values covered by this change. |
#proposals[] | string | Sometimes | Original words before the change. |
#proposals[] | string | Sometimes | Words after the change, or "" when removing words. |
#proposals[] | string | Sometimes | Short reason explaining the change. |
#proposals[] | number | null | Sometimes | Start timestamp in seconds on the recording, or null. |
#proposals[] | number | null | Sometimes | End timestamp in seconds on the recording, or null. |
#proposals[] | integer | Sometimes | Additional 30-second restore windows this proposal adds to an edit. |
moments[] 4 fields
| Field | Type | Present | Description |
|---|---|---|---|
#moments[] | number | Sometimes | Moment start time in seconds. |
#moments[] | number | null | Sometimes | Moment end time in seconds, or null. |
#moments[] | string | Sometimes | Short label describing the moment. |
#moments[] | string | null | Sometimes | Associated words[].id, or null. |
shortening 4 fields
| Field | Type | Present | Description |
|---|---|---|---|
#shortening. | boolean | Sometimes | Whether to close silence left by removed words. |
#shortening. | number | null | Sometimes | Suggested maximum pause length in seconds, or null. |
#shortening. | number | Sometimes | Estimated seconds saved by applying the shortening. |
#shortening. | string | Sometimes | Explanation for the shortening suggestion. |
Response 200OK.
{
"object": "transcript_assistant_turn",
"id": "8f14e45fceea4e6b9d2c7a1b3e5d9f02",
"project_id": "73118d99-36cf-4039-8005-b962d522fff7",
"generation_id": "73c84c4a-c1ca-5485-b396-171ab632d4b7",
"status": "complete",
"created_at": "2026-11-13T00:40:00.418207Z",
"completed_at": "2026-11-13T00:40:06.902114Z",
"error": null,
"reply": "No filler words were found in this transcript.",
"proposals": [],
"moments": [],
"unclear_word_ids": []
}Return codes
200OK.Returns the assistant turn (
processing, or 2 more causes- Returns the assistant turn (
processing completefailed)
- Returns the assistant turn (
400Bad request.Diffio-End-Userexceeds 128 characters.invalid_header403Forbidden: the key lacks permission.Key is inactive or lacksgenerations:read.permission_denied404Not found.Project not found, or 2 more causes
- Project not found
- Generation not found
- Turn not found
project_not_foundgeneration_not_foundtranscript_assistant_turn_not_found401Unauthorized: 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
- A turn that listens to the audio can take up to a few minutes; any turn still
processingafter 600 seconds reportsstatus: "failed"witherror.code: "assistant_timeout". - There is no list-turns endpoint; keep
idfrom Ask the edit assistant or listen fortranscript_assistant_turn.completedandtranscript_assistant_turn.failedwebhooks.