feat: Updated OpenAPI spec

src/libs/Braintrust/Generated/Braintrust.ApiKeysClient.GetApiKey.g.cs

@@ -62,7 +62,8 @@ partial void ProcessGetApiKeyResponseContent(
 
         /// <summary>
         /// List api_keys<br/>
-        /// List out all api_keys. The api_keys are sorted by creation date, with the most recently-created api_keys coming first
+        /// List out all API keys. They are sorted by creation date, with the most recently-created keys coming first.<br/>
+        /// To create new API keys, go to [**Settings &gt; API keys**](https://www.braintrust.dev/app/~/configuration/org/api-keys) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return
@@ -112,7 +113,8 @@ partial void ProcessGetApiKeyResponseContent(
         }
         /// <summary>
         /// List api_keys<br/>
-        /// List out all api_keys. The api_keys are sorted by creation date, with the most recently-created api_keys coming first
+        /// List out all API keys. They are sorted by creation date, with the most recently-created keys coming first.<br/>
+        /// To create new API keys, go to [**Settings &gt; API keys**](https://www.braintrust.dev/app/~/configuration/org/api-keys) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return

src/libs/Braintrust/Generated/Braintrust.IApiKeysClient.GetApiKey.g.cs

@@ -6,7 +6,8 @@ public partial interface IApiKeysClient
     {
         /// <summary>
         /// List api_keys<br/>
-        /// List out all api_keys. The api_keys are sorted by creation date, with the most recently-created api_keys coming first
+        /// List out all API keys. They are sorted by creation date, with the most recently-created keys coming first.<br/>
+        /// To create new API keys, go to [**Settings &gt; API keys**](https://www.braintrust.dev/app/~/configuration/org/api-keys) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return
@@ -42,7 +43,8 @@ public partial interface IApiKeysClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// List api_keys<br/>
-        /// List out all api_keys. The api_keys are sorted by creation date, with the most recently-created api_keys coming first
+        /// List out all API keys. They are sorted by creation date, with the most recently-created keys coming first.<br/>
+        /// To create new API keys, go to [**Settings &gt; API keys**](https://www.braintrust.dev/app/~/configuration/org/api-keys) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return

src/libs/Braintrust/Generated/Braintrust.IOrganizationsClient.PatchOrganizationMembers.g.cs

@@ -6,7 +6,8 @@ public partial interface IOrganizationsClient
     {
         /// <summary>
         /// Modify organization membership<br/>
-        /// Modify organization membership
+        /// Modify organization membership.<br/>
+        /// Organization owners can use this endpoint to create service accounts, but service tokens for those accounts must be created in the Braintrust UI, at [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens).
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -19,7 +20,8 @@ public partial interface IOrganizationsClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Modify organization membership<br/>
-        /// Modify organization membership
+        /// Modify organization membership.<br/>
+        /// Organization owners can use this endpoint to create service accounts, but service tokens for those accounts must be created in the Braintrust UI, at [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens).
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -32,7 +34,8 @@ public partial interface IOrganizationsClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Modify organization membership<br/>
-        /// Modify organization membership
+        /// Modify organization membership.<br/>
+        /// Organization owners can use this endpoint to create service accounts, but service tokens for those accounts must be created in the Braintrust UI, at [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens).
         /// </summary>
         /// <param name="inviteUsers">
         /// Users to invite to the organization

src/libs/Braintrust/Generated/Braintrust.IServiceTokensClient.GetServiceToken.g.cs

@@ -6,7 +6,8 @@ public partial interface IServiceTokensClient
     {
         /// <summary>
         /// List service_tokens<br/>
-        /// List out all service_tokens. The service_tokens are sorted by creation date, with the most recently-created service_tokens coming first
+        /// List out all service tokens. They are sorted by creation date, with the most recently-created tokens coming first.<br/>
+        /// To create service tokens, organization owners can go to [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return
@@ -42,7 +43,8 @@ public partial interface IServiceTokensClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// List service_tokens<br/>
-        /// List out all service_tokens. The service_tokens are sorted by creation date, with the most recently-created service_tokens coming first
+        /// List out all service tokens. They are sorted by creation date, with the most recently-created tokens coming first.<br/>
+        /// To create service tokens, organization owners can go to [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return

src/libs/Braintrust/Generated/Braintrust.Models.PatchOrganizationMembersInviteUsers.g.cs

@@ -21,7 +21,7 @@ public sealed partial class PatchOrganizationMembersInviteUsers
         public global::System.Collections.Generic.IList<string>? Emails { get; set; }
 
         /// <summary>
-        /// Service accounts to create
+        /// Service accounts to create. Users with organization-owner permissions can create service accounts via the API, but the service tokens required to authenticate those accounts must be created in the Braintrust UI.
         /// </summary>
         [global::System.Text.Json.Serialization.JsonPropertyName("service_accounts")]
         public global::System.Collections.Generic.IList<global::Braintrust.PatchOrganizationMembersInviteUsersServiceAccount>? ServiceAccounts { get; set; }
@@ -72,7 +72,7 @@ public sealed partial class PatchOrganizationMembersInviteUsers
         /// Emails of users to invite
         /// </param>
         /// <param name="serviceAccounts">
-        /// Service accounts to create
+        /// Service accounts to create. Users with organization-owner permissions can create service accounts via the API, but the service tokens required to authenticate those accounts must be created in the Braintrust UI.
         /// </param>
         /// <param name="sendInviteEmails">
         /// If true, send invite emails to the users who wore actually added

src/libs/Braintrust/Generated/Braintrust.Models.PatchOrganizationMembersInviteUsersServiceAccount.g.cs

@@ -16,7 +16,7 @@ public sealed partial class PatchOrganizationMembersInviteUsersServiceAccount
         public required string Name { get; set; }
 
         /// <summary>
-        /// 
+        /// Omit this field and create the token in the Braintrust UI ([**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens)). If you include this field, the API call will return a 403.
         /// </summary>
         [global::System.Text.Json.Serialization.JsonPropertyName("token_name")]
         public string? TokenName { get; set; }
@@ -31,7 +31,9 @@ public sealed partial class PatchOrganizationMembersInviteUsersServiceAccount
         /// Initializes a new instance of the <see cref="PatchOrganizationMembersInviteUsersServiceAccount" /> class.
         /// </summary>
         /// <param name="name"></param>
-        /// <param name="tokenName"></param>
+        /// <param name="tokenName">
+        /// Omit this field and create the token in the Braintrust UI ([**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens)). If you include this field, the API call will return a 403.
+        /// </param>
 #if NET7_0_OR_GREATER
         [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers]
 #endif

src/libs/Braintrust/Generated/Braintrust.OrganizationsClient.PatchOrganizationMembers.g.cs

@@ -52,7 +52,8 @@ partial void ProcessPatchOrganizationMembersResponseContent(
 
         /// <summary>
         /// Modify organization membership<br/>
-        /// Modify organization membership
+        /// Modify organization membership.<br/>
+        /// Organization owners can use this endpoint to create service accounts, but service tokens for those accounts must be created in the Braintrust UI, at [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens).
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -75,7 +76,8 @@ partial void ProcessPatchOrganizationMembersResponseContent(
         }
         /// <summary>
         /// Modify organization membership<br/>
-        /// Modify organization membership
+        /// Modify organization membership.<br/>
+        /// Organization owners can use this endpoint to create service accounts, but service tokens for those accounts must be created in the Braintrust UI, at [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens).
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -638,7 +640,8 @@ partial void ProcessPatchOrganizationMembersResponseContent(
         }
         /// <summary>
         /// Modify organization membership<br/>
-        /// Modify organization membership
+        /// Modify organization membership.<br/>
+        /// Organization owners can use this endpoint to create service accounts, but service tokens for those accounts must be created in the Braintrust UI, at [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens).
         /// </summary>
         /// <param name="inviteUsers">
         /// Users to invite to the organization

src/libs/Braintrust/Generated/Braintrust.ServiceTokensClient.GetServiceToken.g.cs

@@ -62,7 +62,8 @@ partial void ProcessGetServiceTokenResponseContent(
 
         /// <summary>
         /// List service_tokens<br/>
-        /// List out all service_tokens. The service_tokens are sorted by creation date, with the most recently-created service_tokens coming first
+        /// List out all service tokens. They are sorted by creation date, with the most recently-created tokens coming first.<br/>
+        /// To create service tokens, organization owners can go to [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return
@@ -112,7 +113,8 @@ partial void ProcessGetServiceTokenResponseContent(
         }
         /// <summary>
         /// List service_tokens<br/>
-        /// List out all service_tokens. The service_tokens are sorted by creation date, with the most recently-created service_tokens coming first
+        /// List out all service tokens. They are sorted by creation date, with the most recently-created tokens coming first.<br/>
+        /// To create service tokens, organization owners can go to [**Settings &gt; Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens) in the Braintrust UI.
         /// </summary>
         /// <param name="limit">
         /// Limit the number of objects to return

src/libs/Braintrust/openapi.yaml

@@ -9618,14 +9618,15 @@
                     },
                     "token_name": {
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "description": "Omit this field and create the token in the Braintrust UI ([**Settings > Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens)). If you include this field, the API call will return a 403."
                     }
                   },
                   "required": [
                     "name"
                   ]
                 },
-                "description": "Service accounts to create"
+                "description": "Service accounts to create. Users with organization-owner permissions can create service accounts via the API, but the service tokens required to authenticate those accounts must be created in the Braintrust UI."
               },
               "send_invite_emails": {
                 "type": "boolean",
@@ -26284,7 +26285,7 @@
         "tags": [
           "Organizations"
         ],
-        "description": "Modify organization membership",
+        "description": "Modify organization membership.\n\nOrganization owners can use this endpoint to create service accounts, but service tokens for those accounts must be created in the Braintrust UI, at [**Settings > Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens).",
         "summary": "Modify organization membership",
         "security": [
           {
@@ -26462,7 +26463,7 @@
         "tags": [
           "ApiKeys"
         ],
-        "description": "List out all api_keys. The api_keys are sorted by creation date, with the most recently-created api_keys coming first",
+        "description": "List out all API keys. They are sorted by creation date, with the most recently-created keys coming first.\n\nTo create new API keys, go to [**Settings > API keys**](https://www.braintrust.dev/app/~/configuration/org/api-keys) in the Braintrust UI.",
         "summary": "List api_keys",
         "security": [
           {
@@ -27071,7 +27072,7 @@
         "tags": [
           "ServiceTokens"
         ],
-        "description": "List out all service_tokens. The service_tokens are sorted by creation date, with the most recently-created service_tokens coming first",
+        "description": "List out all service tokens. They are sorted by creation date, with the most recently-created tokens coming first.\n\nTo create service tokens, organization owners can go to [**Settings > Service tokens**](https://www.braintrust.dev/app/~/configuration/org/service-tokens) in the Braintrust UI.",
         "summary": "List service_tokens",
         "security": [
           {