Conference Streams

Update Conference Stream

Stops an active WebSocket audio stream for a voice conference by stream SID. This ends media delivery without ending the conference. Call audio streams and Video RTMP streams use separate operations.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice.

Learn more about API scopes.

post/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Streams/{Sid}

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account that created this conference.

ConferenceSidstring uuid required

Universal Unique Identifier.

The unique identifier for the conference this participant is in.

Sidstring uuid required

Universal Unique Identifier.

The unique identifier for the stream.

Response

The request has succeeded.

account_sidstring uuid required

Universal Unique Identifier.

conference_sidstring uuid required

Universal Unique Identifier.

date_updatedstring required

The date, in RFC 2822 GMT format, this stream was updated.

namestring nullable required

The name of the stream. May be null if not specified when creating the stream.

sidstring uuid required

Universal Unique Identifier.

status'queued' | 'in-progress' | 'stopped' required

Conference stream status.

uristring required

The URI for the stream.

Example response

{
  "date_updated": "Tue, 25 Sept 2018 20:00:00 +0000",
  "name": "my_conference_stream",
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Streams/b3877c40-da60-4998-90ad-b792e98472st.json"
}

Changes

Changed in 9 of the 40 revisions of this API.25431

  • 2916d5e3072e33See the full diff
    • the account_sid response's property type/format changed from string/uuid to / for status 200

      response-property-type-changed

    • the conference_sid response's property type/format changed from string/uuid to / for status 200

      response-property-type-changed

    • the sid response's property type/format changed from string/uuid to / for status 200

      response-property-type-changed

    • added uuid to the account_sid response property allOf list for the response status 200

      response-property-all-of-added

    • added uuid to the conference_sid response property allOf list for the response status 200

      response-property-all-of-added

    • added uuid to the sid response property allOf list for the response status 200

      response-property-all-of-added

  • 5344c0c93a4c15See the full diff
    • added 'unevaluatedProperties' constraint to the request body

      request-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status 200

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status 400

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status 401

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status 404

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status 422

      response-body-unevaluated-properties-added

    • response property name list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

  • d5fbaaddfa3e39See the full diff
    • removed the enum value in-progress of the request property Status

      request-property-enum-value-removed

    • the response property name became nullable for the status 200

      response-property-became-nullable

    • the status response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • added the non-success response with the status 400

      response-non-success-status-added

    • added ConferenceStreamStatus to the status response property allOf list for the response status 200

      response-property-all-of-added

    • the response property account_sid became required for the status 200

      response-property-became-required

    • the response property conference_sid became required for the status 200

      response-property-became-required

    • the response property date_updated became required for the status 200

      response-property-became-required

    • the response property name became required for the status 200

      response-property-became-required

    • the response property sid became required for the status 200

      response-property-became-required

    • the response property status became required for the status 200

      response-property-became-required

    • the response property uri became required for the status 200

      response-property-became-required

    This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 50dab84bcf02231See the full diff
    • request body became required

      request-body-became-required

    • the errors/items/ response's property type/format changed from object/ to string/ for status 422

      response-property-type-changed

    • removed the optional property errors/items/code from the response with the 422 status

      response-optional-property-removed

    • removed the optional property errors/items/message from the response with the 422 status

      response-optional-property-removed

    • removed the optional property errors/items/more_info from the response with the 422 status

      response-optional-property-removed

    • the response property errors became required for the status 422

      response-property-became-required

  • 479ede876c8942See the full diff
    • removed the required property code from the response with the 422 status

      response-required-property-removed

    • removed the required property message from the response with the 422 status

      response-required-property-removed

    • removed the required property more_info from the response with the 422 status

      response-required-property-removed

    • removed the required property status from the response with the 422 status

      response-required-property-removed

    • request body became optional

      request-body-became-optional

    • added the optional property errors to the response with the 422 status

      response-optional-property-added

    • removed the optional property date_created from the response with the 200 status

      response-optional-property-removed

  • 07f73f74a61d11See the full diff
    • removed the media type application/json from the request body

      request-body-media-type-removed

    • added the media type application/x-www-form-urlencoded to the request body

      request-body-media-type-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 3c88f14db21e1010See the full diff
    • request body became required

      request-body-became-required

    • removed the media type application/x-www-form-urlencoded from the request body

      request-body-media-type-removed

    • the response property account_sid became optional for the status 200

      response-property-became-optional

    • the response property conference_sid became optional for the status 200

      response-property-became-optional

    • the response property date_updated became optional for the status 200

      response-property-became-optional

    • the response property name became optional for the status 200

      response-property-became-optional

    • the response property sid became optional for the status 200

      response-property-became-optional

    • the response property status became optional for the status 200

      response-property-became-optional

    • the response property uri became optional for the status 200

      response-property-became-optional

    • removed the required property errors from the response with the 422 status

      response-required-property-removed

    • added the media type application/json to the request body

      request-body-media-type-added

    • added the non-success response with the status 401

      response-non-success-status-added

    • added the non-success response with the status 404

      response-non-success-status-added

    • added the optional property date_created to the response with the 200 status

      response-optional-property-added

    • removed the in-progress enum value from the status response property for the response status 200

      response-property-enum-value-removed

    • removed the stopped enum value from the status response property for the response status 200

      response-property-enum-value-removed

    • added the required property code to the response with the 422 status

      response-required-property-added

    • added the required property message to the response with the 422 status

      response-required-property-added

    • added the required property more_info to the response with the 422 status

      response-required-property-added

    • added the required property status to the response with the 422 status

      response-required-property-added

    This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog