POST/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Streams/{Sid}.json

Stop a media Stream

Stops a Stream associated with a call. Set Status to stopped, and identify the Stream by its SID or the name used when it was created.

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

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

Form-encoded settings for stopping the Stream.

Statusstringrequired
The Stream status to set; the only allowed value is `stopped`.
Allowed:stopped

1 status code
200Returns the updated Stream resource, including its SIDs, name, status, last-updated timestamp, and URI.
sidstringoptional
The SID of the Stream resource.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Stream resource.
call_sidstringoptional
The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Stream resource is associated with.
namestringoptional
The user-specified name of this Stream, if one was given when the Stream was created. This can be used to stop the Stream.
statusstringoptional
The status of the Stream. Possible values are `stopped` and `in-progress`.
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
The URI of the resource, relative to `https://api.twilio.com`.

Error handling

Status is required and must be stopped. The AccountSid path parameter must match the 34-character AC SID format, the CallSid path parameter must match the 34-character CA SID format, and the Sid path parameter must identify the Stream by its SID or creation name.