Merge branch 'main' into public_oauth_tests

AsabuHere · web-flow · commit 01c74156ff73 · 2024-11-27T12:22:40.000+05:30
diff --git a/CHANGES.md b/CHANGES.md
@@ -1,6 +1,20 @@
 twilio-csharp Changelog
 =======================
 
+[2024-11-15] Version 7.7.0
+--------------------------
+**Library - Feature**
+- [PR #769](https://github.com/twilio/twilio-csharp/pull/769): Adding example for using public OAuth. Thanks to [@AsabuHere](https://github.com/AsabuHere)!
+
+**Api**
+- Added `ivr-virtual-agent-custom-voices` and `ivr-virtual-agent-genai` to `usage_record` API.
+- Add open-api file tag to realtime_transcriptions
+
+**Taskrouter**
+- Add `api-tag` property to workers reservation
+- Add `api-tag` property to task reservation
+
+
 [2024-10-24] Version 7.6.0
 --------------------------
 **Library - Feature**
diff --git a/README.md b/README.md
@@ -72,8 +72,12 @@ var message = MessageResource.Create(
 );
 Console.WriteLine(message.Sid);
 ```
+## OAuth Feature for Twilio APIs
+We are introducing Client Credentials Flow-based OAuth 2.0 authentication. This feature is currently in beta and its implementation is subject to change.
 
-Examples on how to make rest calls with bearer token authentication is added [here](https://github.com/twilio/twilio-csharp/blob/orgs_api_uptake/examples/BearerTokenAuthentication.md)
+API examples [here](https://github.com/twilio/twilio-csharp/blob/main/examples/PublicOAuthAuthentication.md)
+
+Organisation API examples [here](https://github.com/twilio/twilio-csharp/blob/main/examples/BearerTokenAuthentication.md)
 
 ## Specify Region and/or Edge
 
diff --git a/examples/BearerTokenAuthentication.md b/examples/BearerTokenAuthentication.md
@@ -13,7 +13,7 @@ class Program
     static void Main(string[] args)
     {
     
-        CredentialProvider credentialProvider = new ClientCredentialProvider(CLIENT_ID, CLIENT_SECRET);
+        CredentialProvider credentialProvider = new OrgsClientCredentialProvider(CLIENT_ID, CLIENT_SECRET);
         TwilioClient.Init(credentialProvider);
         
         Twilio.Base.ResourceSet<Twilio.Rest.PreviewIam.Organizations.AccountResource> accountList = null;
diff --git a/examples/PublicOAuthAuthentication.md b/examples/PublicOAuthAuthentication.md
@@ -0,0 +1,25 @@
+```csharp
+using Twilio;
+using Twilio.Credential;
+using Twilio.Rest.Api.V2010.Account;
+
+//Find client id, client secret of the OAuth App
+//Message sid in this example is the sid of any previously sent message
+class Program
+{
+    static void Main(string[] args)
+    {
+        CredentialProvider credentialProvider = new ClientCredentialProvider(CLIENT_ID, CLIENT_SECRET);
+        TwilioClient.Init(credentialProvider, ACCOUNT_SID);
+
+        /*
+         * Or use the following if accountSid is not required as a path parameter for an API or when setting accountSid in the API.
+           TwilioClient.init(new ClientCredentialProvider(CLIENT_ID, CLIENT_SECRET));
+         */
+        
+        FetchMessageOptions fm = new FetchMessageOptions(MESSAGE_SID);
+        MessageResource m = MessageResource.Fetch(fm);
+        Console.WriteLine(m.Body);
+    }
+}
+```
diff --git a/src/Twilio/Properties/AssemblyInfo.cs b/src/Twilio/Properties/AssemblyInfo.cs
@@ -10,5 +10,5 @@
 
 internal class AssemblyInfomation
 {
-    public const string AssemblyInformationalVersion = "7.6.0";
+    public const string AssemblyInformationalVersion = "7.7.0";
 }
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/AllTimeResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/AllTimeResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/DailyResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/DailyResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/LastMonthResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/LastMonthResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/MonthlyResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/MonthlyResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/ThisMonthResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/ThisMonthResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/TodayResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/TodayResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/YearlyResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/YearlyResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/Record/YesterdayResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/Record/YesterdayResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/RecordResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/RecordResource.cs
@@ -88,6 +88,8 @@ public static implicit operator CategoryEnum(string value)
             public static readonly CategoryEnum GroupRoomsParticipantMinutes = new CategoryEnum("group-rooms-participant-minutes");
             public static readonly CategoryEnum GroupRoomsRecordedMinutes = new CategoryEnum("group-rooms-recorded-minutes");
             public static readonly CategoryEnum ImpV1Usage = new CategoryEnum("imp-v1-usage");
+            public static readonly CategoryEnum IvrVirtualAgentCustomVoices = new CategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly CategoryEnum IvrVirtualAgentGenai = new CategoryEnum("ivr-virtual-agent-genai");
             public static readonly CategoryEnum Lookups = new CategoryEnum("lookups");
             public static readonly CategoryEnum Marketplace = new CategoryEnum("marketplace");
             public static readonly CategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new CategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Api/V2010/Account/Usage/TriggerResource.cs b/src/Twilio/Rest/Api/V2010/Account/Usage/TriggerResource.cs
@@ -103,6 +103,8 @@ public static implicit operator UsageCategoryEnum(string value)
             public static readonly UsageCategoryEnum GroupRoomsParticipantMinutes = new UsageCategoryEnum("group-rooms-participant-minutes");
             public static readonly UsageCategoryEnum GroupRoomsRecordedMinutes = new UsageCategoryEnum("group-rooms-recorded-minutes");
             public static readonly UsageCategoryEnum ImpV1Usage = new UsageCategoryEnum("imp-v1-usage");
+            public static readonly UsageCategoryEnum IvrVirtualAgentCustomVoices = new UsageCategoryEnum("ivr-virtual-agent-custom-voices");
+            public static readonly UsageCategoryEnum IvrVirtualAgentGenai = new UsageCategoryEnum("ivr-virtual-agent-genai");
             public static readonly UsageCategoryEnum Lookups = new UsageCategoryEnum("lookups");
             public static readonly UsageCategoryEnum Marketplace = new UsageCategoryEnum("marketplace");
             public static readonly UsageCategoryEnum MarketplaceAlgorithmiaNamedEntityRecognition = new UsageCategoryEnum("marketplace-algorithmia-named-entity-recognition");
diff --git a/src/Twilio/Rest/Content/V1/ContentResource.cs b/src/Twilio/Rest/Content/V1/ContentResource.cs
@@ -1179,6 +1179,7 @@ public static implicit operator CallToActionActionType(string value)
             public static readonly CallToActionActionType PhoneNumber = new CallToActionActionType("PHONE_NUMBER");
             public static readonly CallToActionActionType CopyCode = new CallToActionActionType("COPY_CODE");
             public static readonly CallToActionActionType VoiceCall = new CallToActionActionType("VOICE_CALL");
+            public static readonly CallToActionActionType VoiceCallRequest = new CallToActionActionType("VOICE_CALL_REQUEST");
 
         }
 
diff --git a/src/Twilio/Rest/Conversations/V1/ConversationWithParticipantsOptions.cs b/src/Twilio/Rest/Conversations/V1/ConversationWithParticipantsOptions.cs
@@ -64,7 +64,7 @@ public class CreateConversationWithParticipantsOptions : IOptions<ConversationWi
         ///<summary> The default name that will be used when sending outbound emails in this conversation. </summary> 
         public string BindingsEmailName { get; set; }
 
-        ///<summary> 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. </summary> 
+        ///<summary> The participant to be added to the conversation in JSON format. The JSON object attributes are as parameters 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. </summary> 
         public List<string> Participant { get; set; }
 
 
diff --git a/src/Twilio/Rest/Conversations/V1/ConversationWithParticipantsResource.cs b/src/Twilio/Rest/Conversations/V1/ConversationWithParticipantsResource.cs
@@ -112,7 +112,7 @@ public static async System.Threading.Tasks.Task<ConversationWithParticipantsReso
         /// <param name="timersClosed"> ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes. </param>
         /// <param name="bindingsEmailAddress"> The default email address that will be used when sending outbound emails in this conversation. </param>
         /// <param name="bindingsEmailName"> The default name that will be used when sending outbound emails in this conversation. </param>
-        /// <param name="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. </param>
+        /// <param name="participant"> The participant to be added to the conversation in JSON format. The JSON object attributes are as parameters 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. </param>
         /// <param name="xTwilioWebhookEnabled"> The X-Twilio-Webhook-Enabled HTTP request header </param>
         /// <param name="client"> Client to make requests to Twilio </param>
         /// <returns> A single instance of ConversationWithParticipants </returns>
@@ -149,7 +149,7 @@ public static ConversationWithParticipantsResource Create(
         /// <param name="timersClosed"> ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes. </param>
         /// <param name="bindingsEmailAddress"> The default email address that will be used when sending outbound emails in this conversation. </param>
         /// <param name="bindingsEmailName"> The default name that will be used when sending outbound emails in this conversation. </param>
-        /// <param name="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. </param>
+        /// <param name="participant"> The participant to be added to the conversation in JSON format. The JSON object attributes are as parameters 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. </param>
         /// <param name="xTwilioWebhookEnabled"> The X-Twilio-Webhook-Enabled HTTP request header </param>
         /// <param name="client"> Client to make requests to Twilio </param>
         /// <returns> Task that resolves to A single instance of ConversationWithParticipants </returns>
diff --git a/src/Twilio/Rest/Conversations/V1/Service/ConversationWithParticipantsOptions.cs b/src/Twilio/Rest/Conversations/V1/Service/ConversationWithParticipantsOptions.cs
@@ -67,7 +67,7 @@ public class CreateConversationWithParticipantsOptions : IOptions<ConversationWi
         ///<summary> The default name that will be used when sending outbound emails in this conversation. </summary> 
         public string BindingsEmailName { get; set; }
 
-        ///<summary> 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. </summary> 
+        ///<summary> The participant to be added to the conversation in JSON format. The JSON object attributes are as parameters 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. </summary> 
         public List<string> Participant { get; set; }
 
 
diff --git a/src/Twilio/Rest/Conversations/V1/Service/ConversationWithParticipantsResource.cs b/src/Twilio/Rest/Conversations/V1/Service/ConversationWithParticipantsResource.cs
diff --git a/src/Twilio/Rest/Insights/V1/ConferenceResource.cs b/src/Twilio/Rest/Insights/V1/ConferenceResource.cs
diff --git a/src/Twilio/Rest/Insights/V1/Room/ParticipantResource.cs b/src/Twilio/Rest/Insights/V1/Room/ParticipantResource.cs
diff --git a/src/Twilio/Rest/Insights/V1/RoomResource.cs b/src/Twilio/Rest/Insights/V1/RoomResource.cs
diff --git a/src/Twilio/Rest/Numbers/V1/WebhookOptions.cs b/src/Twilio/Rest/Numbers/V1/WebhookOptions.cs
diff --git a/src/Twilio/Rest/Numbers/V1/WebhookResource.cs b/src/Twilio/Rest/Numbers/V1/WebhookResource.cs
diff --git a/src/Twilio/Twilio.csproj b/src/Twilio/Twilio.csproj

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ class Program`
`13`	`13`	`static void Main(string[] args)`
`14`	`14`	`{`
`15`	`15`
`16`		`- CredentialProvider credentialProvider = new ClientCredentialProvider(CLIENT_ID, CLIENT_SECRET);`
	`16`	`+ CredentialProvider credentialProvider = new OrgsClientCredentialProvider(CLIENT_ID, CLIENT_SECRET);`
`17`	`17`	`TwilioClient.Init(credentialProvider);`
`18`	`18`
`19`	`19`	`Twilio.Base.ResourceSet<Twilio.Rest.PreviewIam.Organizations.AccountResource> accountList = null;`
Original file line number	Diff line number	Diff line change
`@@ -10,5 +10,5 @@`
`10`	`10`
`11`	`11`	`internal class AssemblyInfomation`
`12`	`12`	`{`
`13`		`- public const string AssemblyInformationalVersion = "7.6.0";`
	`13`	`+ public const string AssemblyInformationalVersion = "7.7.0";`
`14`	`14`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1179,6 +1179,7 @@ public static implicit operator CallToActionActionType(string value)`
`1179`	`1179`	`public static readonly CallToActionActionType PhoneNumber = new CallToActionActionType("PHONE_NUMBER");`
`1180`	`1180`	`public static readonly CallToActionActionType CopyCode = new CallToActionActionType("COPY_CODE");`
`1181`	`1181`	`public static readonly CallToActionActionType VoiceCall = new CallToActionActionType("VOICE_CALL");`
	`1182`	`+ public static readonly CallToActionActionType VoiceCallRequest = new CallToActionActionType("VOICE_CALL_REQUEST");`
`1182`	`1183`
`1183`	`1184`	`}`
`1184`	`1185`