Update the Recording Rules for the Room

POST /v1/Rooms/{RoomSid}/RecordingRules

Update the Recording Rules for the Room

Path parameters

  • RoomSid string Required

    The SID of the Room resource where the recording rules to update apply.

application/x-www-form-urlencoded

Body

  • Rules

    A JSON-encoded array of recording rules.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • room_sid string | null

      The SID of the Room resource for the Recording Rules

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

    • rules array[object(recording-rule)] | null

      A collection of Recording Rules that describe how to include or exclude matching tracks for recording

      Hide rules attributes Show rules attributes object(recording-rule)
      • type string
      • all boolean
      • publisher string
      • track string
      • kind string
    • date_created string(date-time) | null

      The date and time in GMT when the resource was created specified in ISO 8601 format.

    • date_updated string(date-time) | null

      The date and time in GMT when the resource was last updated specified in ISO 8601 format.

POST /v1/Rooms/{RoomSid}/RecordingRules
curl \
 --request POST 'https://video.twilio.com/v1/Rooms/{RoomSid}/RecordingRules' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'Rules=%255B%257B%2522type%2522%253A%2522exclude%2522%252C%2522all%2522%253A%2520true%257D%255D'
Request example
{"Rules"=>"%5B%7B%22type%22%3A%22exclude%22%2C%22all%22%3A%20true%7D%5D"}
Response examples (200)
{
  "rules": [
    {
      "all": true,
      "type": "include"
    }
  ],
  "room_sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "date_created": "2015-07-30T20:00:00Z",
  "date_updated": "2015-07-30T20:00:00Z"
}