Update conference

POST /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json

Voice call conferences

Path parameters

  • AccountSid string Required

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

  • Sid string Required

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

application/x-www-form-urlencoded

Body

  • AnnounceMethod string(http-method)

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

    Values are HEAD, GET, POST, PATCH, PUT, or DELETE.

  • AnnounceUrl string(uri)

    The URL we should call to announce something into the conference. The URL can return an MP3, a WAV, or a TwiML document with <Play> or <Say>.

  • Status string

    The new status of the resource. Can be: Can be: init, in-progress, or completed. Specifying completed will end the conference and hang up all participants

    Value is completed.

Responses

  • • 200

    OK

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

      The SID of the Account that created this resource

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

    • api_version string | null

      The API version used to create this conference

    • 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}$.

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

      The RFC 2822 date and time in GMT that this resource was created

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

      The RFC 2822 date and time in GMT that this resource was last updated

    • friendly_name string | null

      A string that you assigned to describe this conference room

    • reason_conference_ended string | null

      The reason why a conference ended.

      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.

    • region string | null

      A string that represents the Twilio Region where the conference was mixed

    • sid string | null

      The unique string that identifies this resource

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

    • status string | null

      The status of this conference

      Values are init, in-progress, or completed.

    • subresource_uris object(uri-map) | null

      A list of related resources identified by their relative URIs

    • uri string | null

      The URI of this resource, relative to https://api.twilio.com
POST /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json 
curl \
 -X POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'AnnounceMethod=HEAD&AnnounceUrl=https%3A%2F%2Fexample.com&Status=completed'
Request example 
{
  "AnnounceMethod": "HEAD",
  "AnnounceUrl": "https://example.com",
  "Status": "completed"
}
Response examples (200) 
{
  "account_sid": "string",
  "api_version": "string",
  "call_sid_ending_conference": "string",
  "date_created": "string",
  "date_updated": "string",
  "friendly_name": "string",
  "reason_conference_ended": "conference-ended-via-api",
  "region": "string",
  "sid": "string",
  "status": "init",
  "subresource_uris": {},
  "uri": "string"
}