Audio Emotion API

Get Speaker Name Inference Suggestions Route

Changed on

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
get/v2/audios/{audio_id}/speaker-name-inference/suggestions

Request

  • Base URL
    https://api.imentiv.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Path parameters

audio_idstring required

Unique identifier of the audio.

Response

Successful Response

generated_atstring nullable
audio_idstring required
video_idstring nullable

Changes