Update conference

POST /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json
Account sid auth token

Voice call conferences

Path parameters

  • AccountSid string Required

    The SID of the Account that created the Conference resource(s) to update.

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

  • Sid string Required

    The Twilio-provided string that uniquely identifies the Conference resource to update

application/x-www-form-urlencoded

Body

  • Status string

    Value is completed.

  • AnnounceUrl string(uri)

    The URL we should call to announce something into the conference. The URL may return an MP3 file, a WAV file, or a TwiML document that contains <Play>, <Say>, <Pause>, or <Redirect> verbs.

  • AnnounceMethod string(http-method)

    The HTTP method used to call announce_url. Can be: GET or POST and the default is POST

    Values are GET or POST.

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
    • account_sid string | null

      The SID of the Account that created this Conference 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-rfc-2822) | null

      The date and time in UTC that this resource was created specified in RFC 2822 format.

    • date_updated string(date-time-rfc-2822) | null

      The date and time in UTC that this resource was last updated, specified in RFC 2822 format.

    • api_version string | null

      The API version used to create this conference.

    • friendly_name string | null

      A string that you assigned to describe this conference room. Maximum length is 128 characters.

    • region string | null

      A string that represents the Twilio Region where the conference audio was mixed. May be us1, us2, ie1, de1, sg1, br1, au1, and jp1. Basic conference audio will always be mixed in us1. Global Conference audio will be mixed nearest to the majority of participants.

    • sid string | null

      The unique, Twilio-provided string used to identify this Conference resource.

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

    • status string

      The status of this conference. Can be: init, in-progress, or completed.

      Values are init, in-progress, or completed.

    • uri string | null

      The URI of this resource, relative to https://api.twilio.com.

    • subresource_uris object(uri-map) | null

      A list of related resources identified by their URIs relative to https://api.twilio.com.

    • reason_conference_ended string

      The reason why a conference ended. When a conference is in progress, will be null. When conference is completed, can be: conference-ended-via-api, participant-with-end-conference-on-exit-left, participant-with-end-conference-on-exit-kicked, last-participant-kicked, or last-participant-left.

      Values are conference-ended-via-api, participant-with-end-conference-on-exit-left, participant-with-end-conference-on-exit-kicked, last-participant-kicked, or last-participant-left.

    • call_sid_ending_conference string | null

      The call SID that caused the conference to end.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CA[0-9a-fA-F]{32}$.
POST /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json 
curl \
 --request POST 'https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'Status=completed'
Request examples 
{"Status"=>"completed"}
{"AnnounceUrl"=>"http://www.myapp.com/announce"}
Response examples (200) 
{
  "sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
  "region": "us1",
  "status": "completed",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "api_version": "2010-04-01",
  "date_created": "Mon, 22 Aug 2011 20:58:45 +0000",
  "date_updated": "Mon, 22 Aug 2011 20:58:46 +0000",
  "friendly_name": null,
  "subresource_uris": {
    "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings.json",
    "participants": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants.json"
  },
  "reason_conference_ended": "conference-ended-via-api",
  "call_sid_ending_conference": null
}
{
  "sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
  "region": "us1",
  "status": "in-progress",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "api_version": "2010-04-01",
  "date_created": "Mon, 08 Feb 2021 20:58:45 +0000",
  "date_updated": "Mon, 08 Feb 2021 20:58:46 +0000",
  "friendly_name": "MyRoom",
  "subresource_uris": {
    "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings.json",
    "participants": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants.json"
  },
  "reason_conference_ended": null,
  "call_sid_ending_conference": null
}