Twilio API (unofficial showcase)
POST/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Transcriptions/{Sid}.json

Stop a realtime transcription

Stops a realtime transcription associated with a call. Identify it by its transcription SID or by the name supplied when it was created, and set Status to stopped. The response contains the transcription object with its updated status.

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

3 parameters · 1 body field
AccountSidstringrequired
The account SID associated with the transcription, in the format `AC` followed by 32 hexadecimal characters.
CallSidstringrequired
The SID of the call associated with the transcription, in the format `CA` followed by 32 hexadecimal characters.
Sidstringrequired
The transcription SID or the name supplied when the transcription was created.

The transcription status to set.

Statusstringrequired
The status to set for the transcription: `stopped`.
Allowed:stopped

1 status code
200Returns the transcription object, including its SID, account SID, call SID, name, updated status, and update date.
sidstringoptional
The SID of the Transcription resource.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Transcription resource.
call_sidstringoptional
The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Transcription resource is associated with.
namestringoptional
The user-specified name of this Transcription, if one was given when the Transcription was created. This may be used to stop the Transcription.
statusstringoptional
The status - one of `stopped`, `in-flight`
Allowed:in-progressstopped
date_updatedstringoptional
The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
uristringoptional

Error handling

The Status body field is required and must be stopped. The AccountSid path parameter must be a 34-character account SID beginning with AC followed by 32 hexadecimal characters, and the CallSid path parameter must be a 34-character call SID beginning with CA followed by 32 hexadecimal characters. The Sid path parameter must identify the transcription by its SID or by the name used when it was created.