Get Speaker Name Inference Suggestions Route
GET/v2/audios/{audio_id}/speaker-name-inference/suggestions
Return the stored speaker-name inference suggestions for an audio.
Populated automatically after a contact-center recording finishes
processing, or after the recording is tagged as a contact-center call.
Row shape matches POST .../speaker-name-inference/suggestions. No charge
is applied for this stored block.
404 when no suggestions block is stored, when the speaker set has changed since it was generated, when an accepted name has been committed (that write clears the block; nothing re-runs it except tagging the audio as a contact-center call again), or when the audio is not a contact-center call. An all-rejected completed run still 200s. Committing a role does not update this proposal.
Auth matches the trigger POST: owner or a caller holding media:write.
This is not a share-link surface.
Error Responses
- 401 Unauthorized: User is not authenticated or not authorized to access this audio
- 404 Not Found: Audio not found, no suggestions block is stored, the speaker set changed since generation, an accepted name was committed, or the audio is not a contact-center call
Request
Responses
- 200
- 401
- 404
- 422
Successful Response
Missing, malformed or rejected credentials — no X-API-Key / Authorization: Bearer <jwt>, an expired token, or a caller that lacks the role the route requires. Note that this API answers authorization failures with 401 as well as 403 (see the 403 entry where a route declares both).
No such resource, or it is not visible to this caller. Ownership failures are reported as 404 rather than 403 so the API does not confirm the existence of another account's records.
Validation Error