---
title: "Update a conference resource"
method: POST
path: "/texml/Accounts/{account_sid}/Conferences/{conference_sid}"
tags: ["TeXML REST Commands"]
---

# Update a conference resource

`POST /texml/Accounts/{account_sid}/Conferences/{conference_sid}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/texml/Accounts/{account_sid}/Conferences/{conference_sid}`
- Auth: HTTP bearer

Updates the specified conference resource, for example to modify its status, and returns the updated conference.

## Path parameters

- `account_sid` string, required
- `conference_sid` string, required

## Request body `application/x-www-form-urlencoded`

- CallScriptingUpdateConferenceRequestC75353cb83
  - `Status` string: The new status of the resource. Specifying `completed` will end the conference and hang up all participants.
  - `AnnounceUrl` string: 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` 'GET' | 'POST': The HTTP method used to call the `AnnounceUrl`. Defaults to `POST`.

## Response `200`

Conference resource.

- ConferenceResource
  - `account_sid` string: The id of the account the resource belongs to.
  - `api_version` string: The version of the API that was used to make the request.
  - `call_sid_ending_conference` string: Caller ID, if present.
  - `date_created` string: The timestamp of when the resource was created.
  - `date_updated` string: The timestamp of when the resource was last updated.
  - `friendly_name` string: A string that you assigned to describe this conference room.
  - `reason_conference_ended` 'participant-with-end-conference-on-exit-left' | 'last-participant-left' | 'conference-ended-via-api' | 'time-exceeded': The reason why a conference ended. When a conference is in progress, will be null.
  - `region` string: A string representing the region where the conference is hosted.
  - `sid` string: The unique identifier of the conference.
  - `status` 'init' | 'in-progress' | 'completed': The status of this conference.
  - `subresource_uris` object: A list of related resources identified by their relative URIs.
  - `uri` string: The relative URI for this conference.

## Other responses

- `404`: Resource not found

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)