OpenAI API (unofficial showcase)
POST/audio/voice_consents/{consent_id}

Update voice consent metadata

Updates the metadata for a voice consent recording. Supply the required name field to change its label; this operation does not update the recording itself.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
consent_idstringrequired
The identifier of the consent recording to update.

Metadata to update for the voice consent recording.

namestringrequired
The updated label for this consent recording.

3 status codes
200Returns the updated voice consent object with its identifier, name, language tag, and creation timestamp.
objectstringrequired
The object type, which is always `audio.voice_consent`.
Allowed:audio.voice_consent
idstringrequired
The consent recording identifier.
namestringrequired
The label provided when the consent recording was uploaded.
languagestringrequired
The BCP 47 language tag for the consent phrase (for example, `en-US`).
created_atintegerrequired
The Unix timestamp (in seconds) for when the consent recording was created.
400Returned when the consent recording ID or update is invalid.
errorobjectrequired
404Returned when the endpoint is unavailable or the consent recording was not found.
errorobjectrequired

Error handling

A 400 is returned when the consent recording ID or update is invalid. A 404 is returned when the endpoint is unavailable or the consent recording cannot be found. The consent_id path parameter identifies the recording, and name is required in the request body.