Updates a PlayerStreamer resource identified by a SID

POST /v1/PlayerStreamers/{Sid}

Account sid auth token

A PlayerStreamer resource provides the ability to send a livestream to a JavaScript, iOS, or Android Player SDK.

Updates a PlayerStreamer resource identified by a SID.

Path parameters

Sid string Required

The SID of the PlayerStreamer resource to update.

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^VJ[0-9a-fA-F]{32}$.

application/x-www-form-urlencoded

Body

Status string Required

The status the PlayerStreamer should be transitioned to. Can be: ended.

Value is ended.

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- account_sid string | null
  
  The SID of the Account that created the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- date_created string(date-time) | null
  
  The ISO 8601 date and time in GMT when the resource was created
- date_updated string(date-time) | null
  
  The ISO 8601 date and time in GMT when the resource was last updated
- ended_reason string | null
  
  The reason why a PlayerStreamer ended
  
  Values are ended-via-api, max-duration-exceeded, stream-disconnected-by-source, or unexpected-failure.
- links object(uri-map) | null
  
  The URLs of related resources
- max_duration integer | null
  
  Maximum PlayerStreamer duration in seconds
- sid string | null
  
  The unique string that identifies the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^VJ[0-9a-fA-F]{32}$.
- status string | null
  
  The status of the PlayerStreamer
  
  Values are created, started, ended, or failed.
- status_callback string(uri) | null
  
  The URL to which Twilio will send PlayerStreamer event updates
- status_callback_method string(http-method) | null
  
  The HTTP method Twilio should use to call the status_callback URL
  
  Values are HEAD, GET, POST, PATCH, PUT, or DELETE.
- url string(uri) | null
  
  The absolute URL of the resource
- video boolean | null
  
  Whether the PlayerStreamer is configured to stream video

POST /v1/PlayerStreamers/{Sid}

curl \
 --request POST 'https://media.twilio.com/v1/PlayerStreamers/{Sid}' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'Status=ended'

Response examples (200)

{
  "account_sid": "string",
  "date_created": "2026-05-04T09:42:00Z",
  "date_updated": "2026-05-04T09:42:00Z",
  "ended_reason": "ended-via-api",
  "links": {},
  "max_duration": 42,
  "sid": "string",
  "status": "created",
  "status_callback": "https://example.com",
  "status_callback_method": "HEAD",
  "url": "https://example.com",
  "video": true
}