A conference participant is instantiated in the following situations:1. When a new participant is dialed and added to a conference via the REST APIAPI reference: dial-a-new-conference-participant.When your application requests to dial a new party into an existing conference using the REST API, a conference participant resource for the new call leg is created.2. When a call leg is added to a conference via <Dial> with <Conference> in TeXMLDocumentation: <Conference>When a TeXML <Dial> verb that contains a <Conference> element is executed, the call leg joins the specified conference. At that point, Telnyx creates a conference participant object associated with that call leg.
Certain situations cause the participant API to return no participant records, even if the call or conference previously existed. Telnyx will return no participant objects under the following conditions:1. The conference has been completedOnce a conference ends (e.g., all participants disconnect or the session is terminated), Telnyx no longer returns participant objects associated with that completed conference.2. A participant’s call leg is no longer active (i.e., has been hung up)If a participant disconnects - whether intentionally, due to call failure, or because of application logic - their call leg is considered complete, and the participant object is no longer returned by the API.3. The participant has been explicitly removed via the REST APIAPI reference: delete-a-conference-participant4. The participant’s call leg has been given new TeXML instructions via the REST APIAPI reference: update-callIf a call leg that was previously in a conference is updated with new TeXML instructions via the REST API, it effectively leaves the conference context. As a result, it is no longer included in participant API responses.
