Open Context Protocol is live! 🚀 Read the launch post

updateConference

Voice call conferences

Details

  • Method: POST
  • Path: /2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json
  • Operation ID: UpdateConference

Parameters

{
  "AccountSid": {
    "description": "The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Conference resource(s) to update.",
    "required": true,
    "location": "path",
    "type": "string"
  },
  "Sid": {
    "description": "The Twilio-provided string that uniquely identifies the Conference resource to update",
    "required": true,
    "location": "path",
    "type": "string"
  }
}

Response Schema

{
  "type": "object",
  "properties": {
    "account_sid": {
      "type": "string",
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^AC[0-9a-fA-F]{32}$",
      "nullable": true,
      "description": "The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Conference resource."
    },
    "date_created": {
      "type": "string",
      "format": "date-time-rfc-2822",
      "nullable": true,
      "description": "The date and time in UTC that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."
    },
    "date_updated": {
      "type": "string",
      "format": "date-time-rfc-2822",
      "nullable": true,
      "description": "The date and time in UTC that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."
    },
    "api_version": {
      "type": "string",
      "nullable": true,
      "description": "The API version used to create this conference."
    },
    "friendly_name": {
      "type": "string",
      "nullable": true,
      "description": "A string that you assigned to describe this conference room. Maximum length is 128 characters."
    },
    "region": {
      "type": "string",
      "nullable": true,
      "description": "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": {
      "type": "string",
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^CF[0-9a-fA-F]{32}$",
      "nullable": true,
      "description": "The unique, Twilio-provided string used to identify this Conference resource."
    },
    "status": {
      "type": "string",
      "enum": [
        "init",
        "in-progress",
        "completed"
      ],
      "description": "The status of this conference. Can be: `init`, `in-progress`, or `completed`."
    },
    "uri": {
      "type": "string",
      "nullable": true,
      "description": "The URI of this resource, relative to `https://api.twilio.com`."
    },
    "subresource_uris": {
      "type": "object",
      "format": "uri-map",
      "nullable": true,
      "description": "A list of related resources identified by their URIs relative to `https://api.twilio.com`."
    },
    "reason_conference_ended": {
      "type": "string",
      "enum": [
        "conference-ended-via-api",
        "participant-with-end-conference-on-exit-left",
        "participant-with-end-conference-on-exit-kicked",
        "last-participant-kicked",
        "last-participant-left"
      ],
      "description": "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`."
    },
    "call_sid_ending_conference": {
      "type": "string",
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^CA[0-9a-fA-F]{32}$",
      "nullable": true,
      "description": "The call SID that caused the conference to end."
    }
  }
}

Usage

from ocp_agent import OCPAgent

agent = OCPAgent()
await agent.register_api('twilio')

# Call this tool
result = await agent.call_tool('updateConference', {
    # Add required parameters here
})