[Librarian] Regenerated @ 2e932f6c59e0f9fb6cb96952802e5ebedd83b6f0 18…

…52557f82faade033dbd5bd0615c9e1aa4d9fae

CHANGES.md

@@ -3,6 +3,12 @@ twilio-python Changelog
 
 Here you can see the full list of changes between each twilio-python release.
 
+[2024-10-24] Version 9.3.5
+--------------------------
+**Conversations**
+- Expose ConversationWithParticipants resource that allows creating a conversation with participants
+
+
 [2024-10-17] Version 9.3.4
 --------------------------
 **Api**

twilio/rest/conversations/v1/__init__.py

@@ -18,6 +18,9 @@
 from twilio.rest.conversations.v1.address_configuration import AddressConfigurationList
 from twilio.rest.conversations.v1.configuration import ConfigurationList
 from twilio.rest.conversations.v1.conversation import ConversationList
+from twilio.rest.conversations.v1.conversation_with_participants import (
+    ConversationWithParticipantsList,
+)
 from twilio.rest.conversations.v1.credential import CredentialList
 from twilio.rest.conversations.v1.participant_conversation import (
     ParticipantConversationList,
@@ -39,6 +42,9 @@ def __init__(self, domain: Domain):
         self._address_configurations: Optional[AddressConfigurationList] = None
         self._configuration: Optional[ConfigurationList] = None
         self._conversations: Optional[ConversationList] = None
+        self._conversation_with_participants: Optional[
+            ConversationWithParticipantsList
+        ] = None
         self._credentials: Optional[CredentialList] = None
         self._participant_conversations: Optional[ParticipantConversationList] = None
         self._roles: Optional[RoleList] = None
@@ -63,6 +69,14 @@ def conversations(self) -> ConversationList:
             self._conversations = ConversationList(self)
         return self._conversations
 
+    @property
+    def conversation_with_participants(self) -> ConversationWithParticipantsList:
+        if self._conversation_with_participants is None:
+            self._conversation_with_participants = ConversationWithParticipantsList(
+                self
+            )
+        return self._conversation_with_participants
+
     @property
     def credentials(self) -> CredentialList:
         if self._credentials is None:

twilio/rest/conversations/v1/conversation_with_participants.py

@@ -0,0 +1,243 @@
+r"""
+    This code was generated by
+   ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+    |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+    |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+
+    Twilio - Conversations
+    This is the public Twilio REST API.
+
+    NOTE: This class is auto generated by OpenAPI Generator.
+    https://openapi-generator.tech
+    Do not edit the class manually.
+"""
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional, Union
+from twilio.base import deserialize, serialize, values
+
+from twilio.base.instance_resource import InstanceResource
+from twilio.base.list_resource import ListResource
+from twilio.base.version import Version
+
+
+class ConversationWithParticipantsInstance(InstanceResource):
+
+    class State(object):
+        INACTIVE = "inactive"
+        ACTIVE = "active"
+        CLOSED = "closed"
+
+    class WebhookEnabledType(object):
+        TRUE = "true"
+        FALSE = "false"
+
+    """
+    :ivar account_sid: The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation.
+    :ivar chat_service_sid: The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to.
+    :ivar messaging_service_sid: The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to.
+    :ivar sid: A 34 character string that uniquely identifies this resource.
+    :ivar friendly_name: The human-readable name of this conversation, limited to 256 characters. Optional.
+    :ivar unique_name: An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL.
+    :ivar attributes: An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified.  **Note** that if the attributes are not set \"{}\" will be returned.
+    :ivar state: 
+    :ivar date_created: The date that this resource was created.
+    :ivar date_updated: The date that this resource was last updated.
+    :ivar timers: Timer date values representing state update for this conversation.
+    :ivar links: Contains absolute URLs to access the [participants](https://www.twilio.com/docs/conversations/api/conversation-participant-resource), [messages](https://www.twilio.com/docs/conversations/api/conversation-message-resource) and [webhooks](https://www.twilio.com/docs/conversations/api/conversation-scoped-webhook-resource) of this conversation.
+    :ivar bindings: 
+    :ivar url: An absolute API resource URL for this conversation.
+    """
+
+    def __init__(self, version: Version, payload: Dict[str, Any]):
+        super().__init__(version)
+
+        self.account_sid: Optional[str] = payload.get("account_sid")
+        self.chat_service_sid: Optional[str] = payload.get("chat_service_sid")
+        self.messaging_service_sid: Optional[str] = payload.get("messaging_service_sid")
+        self.sid: Optional[str] = payload.get("sid")
+        self.friendly_name: Optional[str] = payload.get("friendly_name")
+        self.unique_name: Optional[str] = payload.get("unique_name")
+        self.attributes: Optional[str] = payload.get("attributes")
+        self.state: Optional["ConversationWithParticipantsInstance.State"] = (
+            payload.get("state")
+        )
+        self.date_created: Optional[datetime] = deserialize.iso8601_datetime(
+            payload.get("date_created")
+        )
+        self.date_updated: Optional[datetime] = deserialize.iso8601_datetime(
+            payload.get("date_updated")
+        )
+        self.timers: Optional[Dict[str, object]] = payload.get("timers")
+        self.links: Optional[Dict[str, object]] = payload.get("links")
+        self.bindings: Optional[Dict[str, object]] = payload.get("bindings")
+        self.url: Optional[str] = payload.get("url")
+
+    def __repr__(self) -> str:
+        """
+        Provide a friendly representation
+
+        :returns: Machine friendly representation
+        """
+
+        return "<Twilio.Conversations.V1.ConversationWithParticipantsInstance>"
+
+
+class ConversationWithParticipantsList(ListResource):
+
+    def __init__(self, version: Version):
+        """
+        Initialize the ConversationWithParticipantsList
+
+        :param version: Version that contains the resource
+
+        """
+        super().__init__(version)
+
+        self._uri = "/ConversationWithParticipants"
+
+    def create(
+        self,
+        x_twilio_webhook_enabled: Union[
+            "ConversationWithParticipantsInstance.WebhookEnabledType", object
+        ] = values.unset,
+        friendly_name: Union[str, object] = values.unset,
+        unique_name: Union[str, object] = values.unset,
+        date_created: Union[datetime, object] = values.unset,
+        date_updated: Union[datetime, object] = values.unset,
+        messaging_service_sid: Union[str, object] = values.unset,
+        attributes: Union[str, object] = values.unset,
+        state: Union[
+            "ConversationWithParticipantsInstance.State", object
+        ] = values.unset,
+        timers_inactive: Union[str, object] = values.unset,
+        timers_closed: Union[str, object] = values.unset,
+        bindings_email_address: Union[str, object] = values.unset,
+        bindings_email_name: Union[str, object] = values.unset,
+        participant: Union[List[str], object] = values.unset,
+    ) -> ConversationWithParticipantsInstance:
+        """
+        Create the ConversationWithParticipantsInstance
+
+        :param x_twilio_webhook_enabled: The X-Twilio-Webhook-Enabled HTTP request header
+        :param friendly_name: The human-readable name of this conversation, limited to 256 characters. Optional.
+        :param unique_name: An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL.
+        :param date_created: The date that this resource was created.
+        :param date_updated: The date that this resource was last updated.
+        :param messaging_service_sid: The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to.
+        :param attributes: An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified.  **Note** that if the attributes are not set \\\"{}\\\" will be returned.
+        :param state:
+        :param timers_inactive: ISO8601 duration when conversation will be switched to `inactive` state. Minimum value for this timer is 1 minute.
+        :param timers_closed: ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes.
+        :param bindings_email_address: The default email address that will be used when sending outbound emails in this conversation.
+        :param bindings_email_name: The default name that will be used when sending outbound emails in this conversation.
+        :param participant: The participant to be added to the conversation in JSON format. The parameters are as in [Participant Resource](https://www.twilio.com/docs/conversations/api/conversation-participant-resource). The maximum number of participants that can be added in a single request is 10.
+
+        :returns: The created ConversationWithParticipantsInstance
+        """
+
+        data = values.of(
+            {
+                "FriendlyName": friendly_name,
+                "UniqueName": unique_name,
+                "DateCreated": serialize.iso8601_datetime(date_created),
+                "DateUpdated": serialize.iso8601_datetime(date_updated),
+                "MessagingServiceSid": messaging_service_sid,
+                "Attributes": attributes,
+                "State": state,
+                "Timers.Inactive": timers_inactive,
+                "Timers.Closed": timers_closed,
+                "Bindings.Email.Address": bindings_email_address,
+                "Bindings.Email.Name": bindings_email_name,
+                "Participant": serialize.map(participant, lambda e: e),
+            }
+        )
+        headers = values.of(
+            {
+                "X-Twilio-Webhook-Enabled": x_twilio_webhook_enabled,
+                "Content-Type": "application/x-www-form-urlencoded",
+            }
+        )
+
+        payload = self._version.create(
+            method="POST", uri=self._uri, data=data, headers=headers
+        )
+
+        return ConversationWithParticipantsInstance(self._version, payload)
+
+    async def create_async(
+        self,
+        x_twilio_webhook_enabled: Union[
+            "ConversationWithParticipantsInstance.WebhookEnabledType", object
+        ] = values.unset,
+        friendly_name: Union[str, object] = values.unset,
+        unique_name: Union[str, object] = values.unset,
+        date_created: Union[datetime, object] = values.unset,
+        date_updated: Union[datetime, object] = values.unset,
+        messaging_service_sid: Union[str, object] = values.unset,
+        attributes: Union[str, object] = values.unset,
+        state: Union[
+            "ConversationWithParticipantsInstance.State", object
+        ] = values.unset,
+        timers_inactive: Union[str, object] = values.unset,
+        timers_closed: Union[str, object] = values.unset,
+        bindings_email_address: Union[str, object] = values.unset,
+        bindings_email_name: Union[str, object] = values.unset,
+        participant: Union[List[str], object] = values.unset,
+    ) -> ConversationWithParticipantsInstance:
+        """
+        Asynchronously create the ConversationWithParticipantsInstance
+
+        :param x_twilio_webhook_enabled: The X-Twilio-Webhook-Enabled HTTP request header
+        :param friendly_name: The human-readable name of this conversation, limited to 256 characters. Optional.
+        :param unique_name: An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL.
+        :param date_created: The date that this resource was created.
+        :param date_updated: The date that this resource was last updated.
+        :param messaging_service_sid: The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to.
+        :param attributes: An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified.  **Note** that if the attributes are not set \\\"{}\\\" will be returned.
+        :param state:
+        :param timers_inactive: ISO8601 duration when conversation will be switched to `inactive` state. Minimum value for this timer is 1 minute.
+        :param timers_closed: ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes.
+        :param bindings_email_address: The default email address that will be used when sending outbound emails in this conversation.
+        :param bindings_email_name: The default name that will be used when sending outbound emails in this conversation.
+        :param participant: The participant to be added to the conversation in JSON format. The parameters are as in [Participant Resource](https://www.twilio.com/docs/conversations/api/conversation-participant-resource). The maximum number of participants that can be added in a single request is 10.
+
+        :returns: The created ConversationWithParticipantsInstance
+        """
+
+        data = values.of(
+            {
+                "FriendlyName": friendly_name,
+                "UniqueName": unique_name,
+                "DateCreated": serialize.iso8601_datetime(date_created),
+                "DateUpdated": serialize.iso8601_datetime(date_updated),
+                "MessagingServiceSid": messaging_service_sid,
+                "Attributes": attributes,
+                "State": state,
+                "Timers.Inactive": timers_inactive,
+                "Timers.Closed": timers_closed,
+                "Bindings.Email.Address": bindings_email_address,
+                "Bindings.Email.Name": bindings_email_name,
+                "Participant": serialize.map(participant, lambda e: e),
+            }
+        )
+        headers = values.of(
+            {
+                "X-Twilio-Webhook-Enabled": x_twilio_webhook_enabled,
+                "Content-Type": "application/x-www-form-urlencoded",
+            }
+        )
+
+        payload = await self._version.create_async(
+            method="POST", uri=self._uri, data=data, headers=headers
+        )
+
+        return ConversationWithParticipantsInstance(self._version, payload)
+
+    def __repr__(self) -> str:
+        """
+        Provide a friendly representation
+
+        :returns: Machine friendly representation
+        """
+        return "<Twilio.Conversations.V1.ConversationWithParticipantsList>"

twilio/rest/conversations/v1/service/__init__.py

@@ -23,6 +23,9 @@
 from twilio.rest.conversations.v1.service.binding import BindingList
 from twilio.rest.conversations.v1.service.configuration import ConfigurationList
 from twilio.rest.conversations.v1.service.conversation import ConversationList
+from twilio.rest.conversations.v1.service.conversation_with_participants import (
+    ConversationWithParticipantsList,
+)
 from twilio.rest.conversations.v1.service.participant_conversation import (
     ParticipantConversationList,
 )
@@ -135,6 +138,13 @@ def conversations(self) -> ConversationList:
         """
         return self._proxy.conversations
 
+    @property
+    def conversation_with_participants(self) -> ConversationWithParticipantsList:
+        """
+        Access the conversation_with_participants
+        """
+        return self._proxy.conversation_with_participants
+
     @property
     def participant_conversations(self) -> ParticipantConversationList:
         """
@@ -186,6 +196,9 @@ def __init__(self, version: Version, sid: str):
         self._bindings: Optional[BindingList] = None
         self._configuration: Optional[ConfigurationList] = None
         self._conversations: Optional[ConversationList] = None
+        self._conversation_with_participants: Optional[
+            ConversationWithParticipantsList
+        ] = None
         self._participant_conversations: Optional[ParticipantConversationList] = None
         self._roles: Optional[RoleList] = None
         self._users: Optional[UserList] = None
@@ -288,6 +301,18 @@ def conversations(self) -> ConversationList:
             )
         return self._conversations
 
+    @property
+    def conversation_with_participants(self) -> ConversationWithParticipantsList:
+        """
+        Access the conversation_with_participants
+        """
+        if self._conversation_with_participants is None:
+            self._conversation_with_participants = ConversationWithParticipantsList(
+                self._version,
+                self._solution["sid"],
+            )
+        return self._conversation_with_participants
+
     @property
     def participant_conversations(self) -> ParticipantConversationList:
         """