diff --git a/.openapi-generator/FILES b/.openapi-generator/FILES
index 40c344d..f2ebb69 100644
--- a/.openapi-generator/FILES
+++ b/.openapi-generator/FILES
@@ -30,7 +30,6 @@ docs/AIConfigVariationPatch.md
docs/AIConfigVariationPost.md
docs/AIConfigVariationsResponse.md
docs/AIConfigs.md
-docs/AIConfigsApi.md
docs/AIConfigsSummary.md
docs/AITool.md
docs/AIToolPatch.md
@@ -47,6 +46,13 @@ docs/AccountMembersApi.md
docs/AccountUsageBetaApi.md
docs/ActionInput.md
docs/ActionOutput.md
+docs/AdaptiveTrigger.md
+docs/AdaptiveTriggerInstruction.md
+docs/AdaptiveTriggerResourceKind.md
+docs/AdaptiveTriggerTask.md
+docs/AdaptiveTriggers.md
+docs/AdaptiveTriggersApi.md
+docs/AdaptiveTriggersPaginatedLinks.md
docs/AgentControlApi.md
docs/AgentGraph.md
docs/AgentGraphEdge.md
@@ -149,7 +155,9 @@ docs/BulkEditTeamsRep.md
docs/CallerIdentityRep.md
docs/CapabilityConfigPost.md
docs/CapabilityConfigRep.md
+docs/Classifier.md
docs/Clause.md
+docs/CleanupBehavior.md
docs/Client.md
docs/ClientCollection.md
docs/ClientSideAvailability.md
@@ -170,11 +178,8 @@ docs/ContextAttributeValuesCollection.md
docs/ContextInstanceEvaluation.md
docs/ContextInstanceEvaluationReason.md
docs/ContextInstanceEvaluations.md
-docs/ContextInstanceRecord.md
-docs/ContextInstanceSearch.md
docs/ContextInstanceSegmentMembership.md
docs/ContextInstanceSegmentMemberships.md
-docs/ContextInstances.md
docs/ContextKindEnvironmentObservation.md
docs/ContextKindRep.md
docs/ContextKindsCollectionRep.md
@@ -188,13 +193,14 @@ docs/CoreLink.md
docs/CountBucket.md
docs/CountBucketsResult.md
docs/CovariateInfoRep.md
+docs/CreateAdaptiveTriggerRequest.md
docs/CreateAnnouncementBody.md
docs/CreateApprovalRequestRequest.md
docs/CreateCopyFlagConfigApprovalRequestRequest.md
docs/CreateFlagConfigApprovalRequestRequest.md
docs/CreateIpAllowlistEntryRequest.md
docs/CreatePhaseInput.md
-docs/CreateReleaseInput.md
+docs/CreatePipelineReleaseInput.md
docs/CreateReleasePipelineInput.md
docs/CreateWorkflowTemplateInput.md
docs/CustomProperty.md
@@ -208,6 +214,14 @@ docs/CustomWorkflowOutput.md
docs/CustomWorkflowStageMeta.md
docs/CustomWorkflowsListingOutput.md
docs/DataExportDestinationsApi.md
+docs/DataExportProjectIdentityIncompleteError.md
+docs/DataExportProjectIdentityIncompleteErrorRep.md
+docs/DataExportProjectRankComponentsRep.md
+docs/DataExportProjectRankRep.md
+docs/DataExportProjectRankingPageRep.md
+docs/DataExportProjectRankingRep.md
+docs/DataExportProjectRankingScopeRep.md
+docs/DataExportSeriesListRep.md
docs/DefaultClientSideAvailability.md
docs/DefaultClientSideAvailabilityPost.md
docs/Defaults.md
@@ -216,20 +230,43 @@ docs/DependentExperimentRep.md
docs/DependentFlag.md
docs/DependentFlagEnvironment.md
docs/DependentFlagsByEnvironment.md
-docs/DependentMeasuredRolloutRep.md
docs/DependentMetricGroupRep.md
docs/DependentMetricGroupRepWithMetrics.md
docs/DependentMetricOrMetricGroupRep.md
+docs/DependentReleasePhaseRep.md
docs/DeploymentCollectionRep.md
docs/DeploymentRep.md
docs/Destination.md
docs/DestinationPost.md
docs/Destinations.md
+docs/DynamicOptionFiltersItems.md
docs/DynamicOptions.md
docs/DynamicOptionsParser.md
+docs/DynamicOptionsSource.md
docs/Endpoint.md
docs/Environment.md
docs/EnvironmentPost.md
+docs/EnvironmentRelease.md
+docs/EnvironmentReleaseAdvancementMode.md
+docs/EnvironmentReleaseClause.md
+docs/EnvironmentReleaseCollection.md
+docs/EnvironmentReleaseExistingRulePhaseInput.md
+docs/EnvironmentReleaseLink.md
+docs/EnvironmentReleaseMetricInput.md
+docs/EnvironmentReleaseNewRulePhaseInput.md
+docs/EnvironmentReleasePhase.md
+docs/EnvironmentReleasePhaseInput.md
+docs/EnvironmentReleaseResolution.md
+docs/EnvironmentReleaseStepInput.md
+docs/EnvironmentReleasesAccess.md
+docs/EnvironmentReleasesAccessAllowedRep.md
+docs/EnvironmentReleasesAccessDenied.md
+docs/EnvironmentReleasesBetaApi.md
+docs/EnvironmentReleasesFilter.md
+docs/EnvironmentReleasesMemberSummary.md
+docs/EnvironmentReleasesMetricDenominatorRep.md
+docs/EnvironmentReleasesMetricListingRep.md
+docs/EnvironmentReleasesModification.md
docs/EnvironmentSummary.md
docs/Environments.md
docs/EnvironmentsApi.md
@@ -268,6 +305,7 @@ docs/ExperimentEnvironmentSettingRep.md
docs/ExperimentInfoRep.md
docs/ExperimentPatchInput.md
docs/ExperimentPost.md
+docs/ExperimentationLink.md
docs/ExperimentsApi.md
docs/ExpiringTarget.md
docs/ExpiringTargetError.md
@@ -477,6 +515,7 @@ docs/NewMemberForm.md
docs/NotFoundErrorRep.md
docs/OAuth2ClientsApi.md
docs/OauthClientPost.md
+docs/ObservabilityAlertSource.md
docs/OptionsArray.md
docs/OtherApi.md
docs/PaginatedLinks.md
@@ -500,6 +539,14 @@ docs/PermissionGrantInput.md
docs/PersistentStoreIntegrationsBetaApi.md
docs/Phase.md
docs/PhaseInfo.md
+docs/PipelineRelease.md
+docs/PipelineReleaseAudience.md
+docs/PipelineReleaseAudienceConfigInput.md
+docs/PipelineReleaseGuardianConfiguration.md
+docs/PipelineReleaseGuardianConfigurationInput.md
+docs/PipelineReleasePhase.md
+docs/PipelineReleaseProgression.md
+docs/PipelineReleaseProgressionCollection.md
docs/PostApprovalRequestApplyRequest.md
docs/PostApprovalRequestReviewRequest.md
docs/PostDeploymentEventInput.md
@@ -541,15 +588,14 @@ docs/RelayAutoConfigCollectionRep.md
docs/RelayAutoConfigPost.md
docs/RelayAutoConfigRep.md
docs/RelayProxyConfigurationsApi.md
-docs/Release.md
-docs/ReleaseAudience.md
-docs/ReleaseGuardianConfiguration.md
-docs/ReleaseGuardianConfigurationInput.md
+docs/ReleaseHealthCheckFailure.md
+docs/ReleaseHealthCheckKind.md
docs/ReleaseMethod.md
-docs/ReleasePhase.md
+docs/ReleaseMetric.md
+docs/ReleaseMetricStatus.md
docs/ReleasePipeline.md
docs/ReleasePipelineCollection.md
-docs/ReleasePipelinesBetaApi.md
+docs/ReleasePipelinesDeprecatedApi.md
docs/ReleasePoliciesAccess.md
docs/ReleasePoliciesAccessAllowedReason.md
docs/ReleasePoliciesAccessAllowedRep.md
@@ -561,10 +607,10 @@ docs/ReleasePoliciesResponse.md
docs/ReleasePolicy.md
docs/ReleasePolicyScope.md
docs/ReleasePolicyStage.md
-docs/ReleaseProgression.md
-docs/ReleaseProgressionCollection.md
-docs/ReleaserAudienceConfigInput.md
-docs/ReleasesBetaApi.md
+docs/ReleaseStatus.md
+docs/ReleaseStatusReason.md
+docs/ReleaseStep.md
+docs/ReleaseType.md
docs/RepositoryCollectionRep.md
docs/RepositoryPost.md
docs/RepositoryRep.md
@@ -589,6 +635,8 @@ docs/SdkKeyKind.md
docs/SdkKeyListItem.md
docs/SdkKeyPatch.md
docs/SdkKeyPost.md
+docs/SdkKeyViewsPut.md
+docs/SdkKeys.md
docs/SdkKeysEnvironmentSummary.md
docs/SdkKeysForGetSdkKeys.md
docs/SdkKeysSelfLink.md
@@ -613,6 +661,8 @@ docs/SourceFlag.md
docs/StageInput.md
docs/StageOutput.md
docs/StaleFlagData.md
+docs/StartEnvironmentReleaseBadRequest.md
+docs/StartEnvironmentReleaseRequest.md
docs/Statement.md
docs/StatementPost.md
docs/StatisticCollectionRep.md
@@ -621,6 +671,7 @@ docs/StatisticsRoot.md
docs/StatusConflictErrorRep.md
docs/StatusResponse.md
docs/StatusServiceUnavailable.md
+docs/StopEnvironmentReleaseRequest.md
docs/StoreIntegrationError.md
docs/SubjectDataRep.md
docs/SubscriptionPost.md
@@ -658,6 +709,7 @@ docs/TrustPolicyDetails.md
docs/TrustPolicyStatement.md
docs/UnauthorizedErrorRep.md
docs/UnlinkResourceSuccessResponse.md
+docs/UpdateAdaptiveTriggerRequest.md
docs/UpdatePhaseStatusInput.md
docs/UpdateReleasePipelineInput.md
docs/UpsertContextKindPayload.md
@@ -707,7 +759,7 @@ docs/ViewsAccessAllowedRep.md
docs/ViewsAccessDenied.md
docs/ViewsAccessDeniedReason.md
docs/ViewsAccessRep.md
-docs/ViewsBetaApi.md
+docs/ViewsApi.md
docs/ViewsLink.md
docs/ViewsMaintainerMember.md
docs/ViewsMaintainerTeam.md
diff --git a/README.md b/README.md
index a07bc3d..dba9e63 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ This REST API is for custom integrations, data export, or automating your featur
This client library is only compatible with the latest version of our REST API. Previous versions of this client library are compatible with earlier versions of our REST API. When you create an access token, you can set the REST API version associated with the token. By default, API requests you send using the token will use the specified API version. To learn more, read [Versioning](https://apidocs.launchdarkly.com/#section/Overview/Versioning).
View our [sample code](#sample-code) for example usage.
-## launchdarkly-api-typescript@24.0.0
+## launchdarkly-api-typescript@25.0.0
This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
@@ -44,7 +44,7 @@ navigate to the folder of your consuming project and run one of the following co
_published:_
```
-npm install launchdarkly-api-typescript@24.0.0 --save
+npm install launchdarkly-api-typescript@25.0.0 --save
```
_unPublished (not recommended):_
@@ -59,14 +59,12 @@ All URIs are relative to *https://app.launchdarkly.com*
Class | Method | HTTP request | Description
------------ | ------------- | ------------- | -------------
-*AIConfigsApi* | [**listAIToolReferences**](docs/AIConfigsApi.md#listaitoolreferences) | **GET** /api/v2/projects/{projectKey}/ai-tools/{toolKey}/references | List AI tool references
-*AIConfigsApi* | [**listAgentOptimizationRuns**](docs/AIConfigsApi.md#listagentoptimizationruns) | **GET** /api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/runs | List agent optimization runs
*AccessTokensApi* | [**deleteToken**](docs/AccessTokensApi.md#deletetoken) | **DELETE** /api/v2/tokens/{id} | Delete access token
*AccessTokensApi* | [**getToken**](docs/AccessTokensApi.md#gettoken) | **GET** /api/v2/tokens/{id} | Get access token
*AccessTokensApi* | [**getTokens**](docs/AccessTokensApi.md#gettokens) | **GET** /api/v2/tokens | List access tokens
*AccessTokensApi* | [**patchToken**](docs/AccessTokensApi.md#patchtoken) | **PATCH** /api/v2/tokens/{id} | Patch access token
*AccessTokensApi* | [**postToken**](docs/AccessTokensApi.md#posttoken) | **POST** /api/v2/tokens | Create access token
-*AccessTokensApi* | [**resetToken**](docs/AccessTokensApi.md#resettoken) | **POST** /api/v2/tokens/{id}/reset | Reset access token
+*AccessTokensApi* | [**resetToken**](docs/AccessTokensApi.md#resettoken) | **POST** /api/v2/tokens/{id}/reset | Reset access token (legacy)
*AccountMembersApi* | [**deleteMember**](docs/AccountMembersApi.md#deletemember) | **DELETE** /api/v2/members/{id} | Delete account member
*AccountMembersApi* | [**getMember**](docs/AccountMembersApi.md#getmember) | **GET** /api/v2/members/{id} | Get account member
*AccountMembersApi* | [**getMembers**](docs/AccountMembersApi.md#getmembers) | **GET** /api/v2/members | List account members
@@ -79,6 +77,7 @@ Class | Method | HTTP request | Description
*AccountUsageBetaApi* | [**getContextsServersideUsage**](docs/AccountUsageBetaApi.md#getcontextsserversideusage) | **GET** /api/v2/usage/serverside-contexts | Get contexts serverside usage
*AccountUsageBetaApi* | [**getContextsTotalUsage**](docs/AccountUsageBetaApi.md#getcontextstotalusage) | **GET** /api/v2/usage/total-contexts | Get contexts total usage
*AccountUsageBetaApi* | [**getDataExportEventsUsage**](docs/AccountUsageBetaApi.md#getdataexporteventsusage) | **GET** /api/v2/usage/data-export-events | Get data export events usage
+*AccountUsageBetaApi* | [**getDataExportProjectRanking**](docs/AccountUsageBetaApi.md#getdataexportprojectranking) | **GET** /api/v2/usage/data-export-events/projects/ranking | Rank Streaming usage by project
*AccountUsageBetaApi* | [**getEvaluationsUsage**](docs/AccountUsageBetaApi.md#getevaluationsusage) | **GET** /api/v2/usage/evaluations/{projectKey}/{environmentKey}/{featureFlagKey} | Get evaluations usage
*AccountUsageBetaApi* | [**getEventsUsage**](docs/AccountUsageBetaApi.md#geteventsusage) | **GET** /api/v2/usage/events/{type} | Get events usage
*AccountUsageBetaApi* | [**getExperimentationEventsUsage**](docs/AccountUsageBetaApi.md#getexperimentationeventsusage) | **GET** /api/v2/usage/experimentation-events | Get experimentation events usage
@@ -101,6 +100,13 @@ Class | Method | HTTP request | Description
*AccountUsageBetaApi* | [**getStreamUsageSdkversion**](docs/AccountUsageBetaApi.md#getstreamusagesdkversion) | **GET** /api/v2/usage/streams/{source}/sdkversions | Get stream usage SDK versions
*AccountUsageBetaApi* | [**getVegaAIUsage**](docs/AccountUsageBetaApi.md#getvegaaiusage) | **GET** /api/v2/usage/vega-ai | Get Vega AI usage
*AccountUsageBetaApi* | [**getWarehouseExportUsage**](docs/AccountUsageBetaApi.md#getwarehouseexportusage) | **GET** /api/v2/usage/warehouse-export | Get warehouse Data Export usage
+*AdaptiveTriggersApi* | [**deleteAdaptiveTrigger**](docs/AdaptiveTriggersApi.md#deleteadaptivetrigger) | **DELETE** /api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID} | Delete an adaptive trigger
+*AdaptiveTriggersApi* | [**getAdaptiveTrigger**](docs/AdaptiveTriggersApi.md#getadaptivetrigger) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID} | Get an adaptive trigger
+*AdaptiveTriggersApi* | [**listAdaptiveTriggers**](docs/AdaptiveTriggersApi.md#listadaptivetriggers) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers | List adaptive triggers
+*AdaptiveTriggersApi* | [**patchAdaptiveTrigger**](docs/AdaptiveTriggersApi.md#patchadaptivetrigger) | **PATCH** /api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID} | Update an adaptive trigger
+*AdaptiveTriggersApi* | [**postAdaptiveTrigger**](docs/AdaptiveTriggersApi.md#postadaptivetrigger) | **POST** /api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers | Create an adaptive trigger
+*AdaptiveTriggersApi* | [**postDisableAdaptiveTrigger**](docs/AdaptiveTriggersApi.md#postdisableadaptivetrigger) | **POST** /api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID}/disable | Disable an adaptive trigger
+*AdaptiveTriggersApi* | [**postEnableAdaptiveTrigger**](docs/AdaptiveTriggersApi.md#postenableadaptivetrigger) | **POST** /api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID}/enable | Enable an adaptive trigger
*AgentControlApi* | [**deleteAIConfig**](docs/AgentControlApi.md#deleteaiconfig) | **DELETE** /api/v2/projects/{projectKey}/ai-configs/{configKey} | Delete AI Config
*AgentControlApi* | [**deleteAIConfigVariation**](docs/AgentControlApi.md#deleteaiconfigvariation) | **DELETE** /api/v2/projects/{projectKey}/ai-configs/{configKey}/variations/{variationKey} | Delete AI Config variation
*AgentControlApi* | [**deleteAITool**](docs/AgentControlApi.md#deleteaitool) | **DELETE** /api/v2/projects/{projectKey}/ai-tools/{toolKey} | Delete AI tool
@@ -124,11 +130,13 @@ Class | Method | HTTP request | Description
*AgentControlApi* | [**getAgentSkill**](docs/AgentControlApi.md#getagentskill) | **GET** /api/v2/projects/{projectKey}/ai-configs/skills/{skillKey} | Get an agent skill
*AgentControlApi* | [**getModelConfig**](docs/AgentControlApi.md#getmodelconfig) | **GET** /api/v2/projects/{projectKey}/ai-configs/model-configs/{modelConfigKey} | Get AI model config
*AgentControlApi* | [**getPromptSnippet**](docs/AgentControlApi.md#getpromptsnippet) | **GET** /api/v2/projects/{projectKey}/ai-configs/prompt-snippets/{snippetKey} | Get a prompt snippet
+*AgentControlApi* | [**listAIToolReferences**](docs/AgentControlApi.md#listaitoolreferences) | **GET** /api/v2/projects/{projectKey}/ai-tools/{toolKey}/references | List AI tool references
*AgentControlApi* | [**listAIToolVersions**](docs/AgentControlApi.md#listaitoolversions) | **GET** /api/v2/projects/{projectKey}/ai-tools/{toolKey}/versions | List AI tool versions
*AgentControlApi* | [**listAITools**](docs/AgentControlApi.md#listaitools) | **GET** /api/v2/projects/{projectKey}/ai-tools | List AI tools
*AgentControlApi* | [**listAgentGraphs**](docs/AgentControlApi.md#listagentgraphs) | **GET** /api/v2/projects/{projectKey}/agent-graphs | List agent graphs
-*AgentControlApi* | [**listAgentOptimizationResults**](docs/AgentControlApi.md#listagentoptimizationresults) | **GET** /api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/results | List agent optimization runs
+*AgentControlApi* | [**listAgentOptimizationResults**](docs/AgentControlApi.md#listagentoptimizationresults) | **GET** /api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/results | List latest agent optimization result per run
*AgentControlApi* | [**listAgentOptimizationResultsByRunId**](docs/AgentControlApi.md#listagentoptimizationresultsbyrunid) | **GET** /api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/runs/{runId}/results | List agent optimization results for a run
+*AgentControlApi* | [**listAgentOptimizationRuns**](docs/AgentControlApi.md#listagentoptimizationruns) | **GET** /api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/runs | List agent optimization runs
*AgentControlApi* | [**listAgentOptimizations**](docs/AgentControlApi.md#listagentoptimizations) | **GET** /api/v2/projects/{projectKey}/agent-optimizations | List agent optimizations
*AgentControlApi* | [**listAgentSkillReferences**](docs/AgentControlApi.md#listagentskillreferences) | **GET** /api/v2/projects/{projectKey}/ai-configs/skills/{skillKey}/references | List agent skill references
*AgentControlApi* | [**listAgentSkillVersions**](docs/AgentControlApi.md#listagentskillversions) | **GET** /api/v2/projects/{projectKey}/ai-configs/skills/{skillKey}/versions | List agent skill versions
@@ -205,15 +213,12 @@ Class | Method | HTTP request | Description
*CodeReferencesApi* | [**postRepository**](docs/CodeReferencesApi.md#postrepository) | **POST** /api/v2/code-refs/repositories | Create repository
*CodeReferencesApi* | [**putBranch**](docs/CodeReferencesApi.md#putbranch) | **PUT** /api/v2/code-refs/repositories/{repo}/branches/{branch} | Upsert branch
*ContextSettingsApi* | [**putContextFlagSetting**](docs/ContextSettingsApi.md#putcontextflagsetting) | **PUT** /api/v2/projects/{projectKey}/environments/{environmentKey}/contexts/{contextKind}/{contextKey}/flags/{featureFlagKey} | Update flag settings for context
-*ContextsApi* | [**deleteContextInstances**](docs/ContextsApi.md#deletecontextinstances) | **DELETE** /api/v2/projects/{projectKey}/environments/{environmentKey}/context-instances/{id} | Delete context instances
*ContextsApi* | [**evaluateContextInstance**](docs/ContextsApi.md#evaluatecontextinstance) | **POST** /api/v2/projects/{projectKey}/environments/{environmentKey}/flags/evaluate | Evaluate flags for context instance
*ContextsApi* | [**getContextAttributeNames**](docs/ContextsApi.md#getcontextattributenames) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/context-attributes | Get context attribute names
*ContextsApi* | [**getContextAttributeValues**](docs/ContextsApi.md#getcontextattributevalues) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/context-attributes/{attributeName} | Get context attribute values
-*ContextsApi* | [**getContextInstances**](docs/ContextsApi.md#getcontextinstances) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/context-instances/{id} | Get context instances
*ContextsApi* | [**getContextKindsByProjectKey**](docs/ContextsApi.md#getcontextkindsbyprojectkey) | **GET** /api/v2/projects/{projectKey}/context-kinds | Get context kinds
*ContextsApi* | [**getContexts**](docs/ContextsApi.md#getcontexts) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/contexts/{kind}/{key} | Get contexts
*ContextsApi* | [**putContextKind**](docs/ContextsApi.md#putcontextkind) | **PUT** /api/v2/projects/{projectKey}/context-kinds/{key} | Create or update context kind
-*ContextsApi* | [**searchContextInstances**](docs/ContextsApi.md#searchcontextinstances) | **POST** /api/v2/projects/{projectKey}/environments/{environmentKey}/context-instances/search | Search for context instances
*ContextsApi* | [**searchContexts**](docs/ContextsApi.md#searchcontexts) | **POST** /api/v2/projects/{projectKey}/environments/{environmentKey}/contexts/search | Search for contexts
*CustomRolesApi* | [**deleteCustomRole**](docs/CustomRolesApi.md#deletecustomrole) | **DELETE** /api/v2/roles/{customRoleKey} | Delete custom role
*CustomRolesApi* | [**getCustomRole**](docs/CustomRolesApi.md#getcustomrole) | **GET** /api/v2/roles/{customRoleKey} | Get custom role
@@ -230,6 +235,10 @@ Class | Method | HTTP request | Description
*DataExportDestinationsApi* | [**postGenerateTrustPolicy**](docs/DataExportDestinationsApi.md#postgeneratetrustpolicy) | **POST** /api/v2/destinations/projects/{projKey}/environments/{envKey}/generate-trust-policy | Generate trust policy
*DataExportDestinationsApi* | [**postGenerateWarehouseDestinationKeyPair**](docs/DataExportDestinationsApi.md#postgeneratewarehousedestinationkeypair) | **POST** /api/v2/destinations/generate-warehouse-destination-key-pair | Generate Snowflake destination key pair
*DataExportDestinationsApi* | [**postGenerateWarehouseDestinationSetupScript**](docs/DataExportDestinationsApi.md#postgeneratewarehousedestinationsetupscript) | **POST** /api/v2/destinations/projects/{projKey}/environments/{envKey}/kinds/{kind}/setup | Generate warehouse destination setup script
+*EnvironmentReleasesBetaApi* | [**getEnvironmentRelease**](docs/EnvironmentReleasesBetaApi.md#getenvironmentrelease) | **GET** /api/v2/projects/{projectKey}/flags/{flagKey}/environments/{environmentKey}/releases/{releaseId} | Get an environment release
+*EnvironmentReleasesBetaApi* | [**listEnvironmentReleases**](docs/EnvironmentReleasesBetaApi.md#listenvironmentreleases) | **GET** /api/v2/projects/{projectKey}/flags/{flagKey}/environments/{environmentKey}/releases | List environment releases
+*EnvironmentReleasesBetaApi* | [**startEnvironmentRelease**](docs/EnvironmentReleasesBetaApi.md#startenvironmentrelease) | **POST** /api/v2/projects/{projectKey}/flags/{flagKey}/environments/{environmentKey}/releases | Start an environment release
+*EnvironmentReleasesBetaApi* | [**stopEnvironmentRelease**](docs/EnvironmentReleasesBetaApi.md#stopenvironmentrelease) | **PUT** /api/v2/projects/{projectKey}/flags/{flagKey}/environments/{environmentKey}/releases/{releaseId}/stop | Stop an environment release
*EnvironmentsApi* | [**deleteEnvironment**](docs/EnvironmentsApi.md#deleteenvironment) | **DELETE** /api/v2/projects/{projectKey}/environments/{environmentKey} | Delete environment
*EnvironmentsApi* | [**getEnvironment**](docs/EnvironmentsApi.md#getenvironment) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey} | Get environment
*EnvironmentsApi* | [**getEnvironmentsByProject**](docs/EnvironmentsApi.md#getenvironmentsbyproject) | **GET** /api/v2/projects/{projectKey}/environments | List environments
@@ -369,28 +378,30 @@ Class | Method | HTTP request | Description
*RelayProxyConfigurationsApi* | [**patchRelayAutoConfig**](docs/RelayProxyConfigurationsApi.md#patchrelayautoconfig) | **PATCH** /api/v2/account/relay-auto-configs/{id} | Update a Relay Proxy config
*RelayProxyConfigurationsApi* | [**postRelayAutoConfig**](docs/RelayProxyConfigurationsApi.md#postrelayautoconfig) | **POST** /api/v2/account/relay-auto-configs | Create a new Relay Proxy config
*RelayProxyConfigurationsApi* | [**resetRelayAutoConfig**](docs/RelayProxyConfigurationsApi.md#resetrelayautoconfig) | **POST** /api/v2/account/relay-auto-configs/{id}/reset | Reset Relay Proxy configuration key
-*ReleasePipelinesBetaApi* | [**deleteReleasePipeline**](docs/ReleasePipelinesBetaApi.md#deletereleasepipeline) | **DELETE** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey} | Delete release pipeline
-*ReleasePipelinesBetaApi* | [**getAllReleasePipelines**](docs/ReleasePipelinesBetaApi.md#getallreleasepipelines) | **GET** /api/v2/projects/{projectKey}/release-pipelines | Get all release pipelines
-*ReleasePipelinesBetaApi* | [**getAllReleaseProgressionsForReleasePipeline**](docs/ReleasePipelinesBetaApi.md#getallreleaseprogressionsforreleasepipeline) | **GET** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}/releases | Get release progressions for release pipeline
-*ReleasePipelinesBetaApi* | [**getReleasePipelineByKey**](docs/ReleasePipelinesBetaApi.md#getreleasepipelinebykey) | **GET** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey} | Get release pipeline by key
-*ReleasePipelinesBetaApi* | [**postReleasePipeline**](docs/ReleasePipelinesBetaApi.md#postreleasepipeline) | **POST** /api/v2/projects/{projectKey}/release-pipelines | Create a release pipeline
-*ReleasePipelinesBetaApi* | [**putReleasePipeline**](docs/ReleasePipelinesBetaApi.md#putreleasepipeline) | **PUT** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey} | Update a release pipeline
+*ReleasePipelinesDeprecatedApi* | [**createReleaseForFlag**](docs/ReleasePipelinesDeprecatedApi.md#createreleaseforflag) | **PUT** /api/v2/projects/{projectKey}/flags/{flagKey}/release | Create a new release for flag
+*ReleasePipelinesDeprecatedApi* | [**deleteReleaseByFlagKey**](docs/ReleasePipelinesDeprecatedApi.md#deletereleasebyflagkey) | **DELETE** /api/v2/flags/{projectKey}/{flagKey}/release | Delete a release for flag
+*ReleasePipelinesDeprecatedApi* | [**deleteReleasePipeline**](docs/ReleasePipelinesDeprecatedApi.md#deletereleasepipeline) | **DELETE** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey} | Delete release pipeline
+*ReleasePipelinesDeprecatedApi* | [**getAllReleasePipelines**](docs/ReleasePipelinesDeprecatedApi.md#getallreleasepipelines) | **GET** /api/v2/projects/{projectKey}/release-pipelines | Get all release pipelines
+*ReleasePipelinesDeprecatedApi* | [**getAllReleaseProgressionsForReleasePipeline**](docs/ReleasePipelinesDeprecatedApi.md#getallreleaseprogressionsforreleasepipeline) | **GET** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}/releases | Get release progressions for release pipeline
+*ReleasePipelinesDeprecatedApi* | [**getReleaseByFlagKey**](docs/ReleasePipelinesDeprecatedApi.md#getreleasebyflagkey) | **GET** /api/v2/flags/{projectKey}/{flagKey}/release | Get release for flag
+*ReleasePipelinesDeprecatedApi* | [**getReleasePipelineByKey**](docs/ReleasePipelinesDeprecatedApi.md#getreleasepipelinebykey) | **GET** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey} | Get release pipeline by key
+*ReleasePipelinesDeprecatedApi* | [**patchReleaseByFlagKey**](docs/ReleasePipelinesDeprecatedApi.md#patchreleasebyflagkey) | **PATCH** /api/v2/flags/{projectKey}/{flagKey}/release | Patch release for flag
+*ReleasePipelinesDeprecatedApi* | [**postReleasePipeline**](docs/ReleasePipelinesDeprecatedApi.md#postreleasepipeline) | **POST** /api/v2/projects/{projectKey}/release-pipelines | Create a release pipeline
+*ReleasePipelinesDeprecatedApi* | [**putReleasePipeline**](docs/ReleasePipelinesDeprecatedApi.md#putreleasepipeline) | **PUT** /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey} | Update a release pipeline
+*ReleasePipelinesDeprecatedApi* | [**updatePhaseStatus**](docs/ReleasePipelinesDeprecatedApi.md#updatephasestatus) | **PUT** /api/v2/projects/{projectKey}/flags/{flagKey}/release/phases/{phaseId} | Update phase status for release
*ReleasePoliciesBetaApi* | [**deleteReleasePolicy**](docs/ReleasePoliciesBetaApi.md#deletereleasepolicy) | **DELETE** /api/v2/projects/{projectKey}/release-policies/{policyKey} | Delete a release policy
*ReleasePoliciesBetaApi* | [**getReleasePolicies**](docs/ReleasePoliciesBetaApi.md#getreleasepolicies) | **GET** /api/v2/projects/{projectKey}/release-policies | List release policies
*ReleasePoliciesBetaApi* | [**getReleasePolicy**](docs/ReleasePoliciesBetaApi.md#getreleasepolicy) | **GET** /api/v2/projects/{projectKey}/release-policies/{policyKey} | Get a release policy by key
*ReleasePoliciesBetaApi* | [**postReleasePoliciesOrder**](docs/ReleasePoliciesBetaApi.md#postreleasepoliciesorder) | **POST** /api/v2/projects/{projectKey}/release-policies/order | Update the order of existing release policies
*ReleasePoliciesBetaApi* | [**postReleasePolicy**](docs/ReleasePoliciesBetaApi.md#postreleasepolicy) | **POST** /api/v2/projects/{projectKey}/release-policies | Create a release policy
*ReleasePoliciesBetaApi* | [**putReleasePolicy**](docs/ReleasePoliciesBetaApi.md#putreleasepolicy) | **PUT** /api/v2/projects/{projectKey}/release-policies/{policyKey} | Update a release policy
-*ReleasesBetaApi* | [**createReleaseForFlag**](docs/ReleasesBetaApi.md#createreleaseforflag) | **PUT** /api/v2/projects/{projectKey}/flags/{flagKey}/release | Create a new release for flag
-*ReleasesBetaApi* | [**deleteReleaseByFlagKey**](docs/ReleasesBetaApi.md#deletereleasebyflagkey) | **DELETE** /api/v2/flags/{projectKey}/{flagKey}/release | Delete a release for flag
-*ReleasesBetaApi* | [**getReleaseByFlagKey**](docs/ReleasesBetaApi.md#getreleasebyflagkey) | **GET** /api/v2/flags/{projectKey}/{flagKey}/release | Get release for flag
-*ReleasesBetaApi* | [**patchReleaseByFlagKey**](docs/ReleasesBetaApi.md#patchreleasebyflagkey) | **PATCH** /api/v2/flags/{projectKey}/{flagKey}/release | Patch release for flag
-*ReleasesBetaApi* | [**updatePhaseStatus**](docs/ReleasesBetaApi.md#updatephasestatus) | **PUT** /api/v2/projects/{projectKey}/flags/{flagKey}/release/phases/{phaseId} | Update phase status for release
*SDKKeysBetaApi* | [**deleteSdkKeyByKey**](docs/SDKKeysBetaApi.md#deletesdkkeybykey) | **DELETE** /api/v2/projects/{projectKey}/environments/{environmentKey}/sdk-keys/{sdkKeyKey} | Delete SDK key
+*SDKKeysBetaApi* | [**getProjectSdkKeys**](docs/SDKKeysBetaApi.md#getprojectsdkkeys) | **GET** /api/v2/projects/{projectKey}/sdk-keys | Get all project SDK keys
*SDKKeysBetaApi* | [**getSdkKeyByKey**](docs/SDKKeysBetaApi.md#getsdkkeybykey) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/sdk-keys/{sdkKeyKey} | Get SDK key
*SDKKeysBetaApi* | [**getSdkKeys**](docs/SDKKeysBetaApi.md#getsdkkeys) | **GET** /api/v2/projects/{projectKey}/environments/{environmentKey}/sdk-keys | Get all environment SDK keys
*SDKKeysBetaApi* | [**patchSdkKeyByKey**](docs/SDKKeysBetaApi.md#patchsdkkeybykey) | **PATCH** /api/v2/projects/{projectKey}/environments/{environmentKey}/sdk-keys/{sdkKeyKey} | Update SDK key
*SDKKeysBetaApi* | [**postSdkKey**](docs/SDKKeysBetaApi.md#postsdkkey) | **POST** /api/v2/projects/{projectKey}/environments/{environmentKey}/sdk-keys | Create SDK key
+*SDKKeysBetaApi* | [**putSdkKeyViews**](docs/SDKKeysBetaApi.md#putsdkkeyviews) | **PUT** /api/v2/projects/{projectKey}/environments/{environmentKey}/sdk-keys/{sdkKeyKey}/views | Replace SDK key views
*ScheduledChangesApi* | [**deleteFlagConfigScheduledChanges**](docs/ScheduledChangesApi.md#deleteflagconfigscheduledchanges) | **DELETE** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/scheduled-changes/{id} | Delete scheduled changes workflow
*ScheduledChangesApi* | [**getFeatureFlagScheduledChange**](docs/ScheduledChangesApi.md#getfeatureflagscheduledchange) | **GET** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/scheduled-changes/{id} | Get a scheduled change
*ScheduledChangesApi* | [**getFlagConfigScheduledChanges**](docs/ScheduledChangesApi.md#getflagconfigscheduledchanges) | **GET** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/scheduled-changes | List scheduled changes
@@ -432,15 +443,15 @@ Class | Method | HTTP request | Description
*UsersApi* | [**getSearchUsers**](docs/UsersApi.md#getsearchusers) | **GET** /api/v2/user-search/{projectKey}/{environmentKey} | Find users
*UsersApi* | [**getUser**](docs/UsersApi.md#getuser) | **GET** /api/v2/users/{projectKey}/{environmentKey}/{userKey} | Get user
*UsersApi* | [**getUsers**](docs/UsersApi.md#getusers) | **GET** /api/v2/users/{projectKey}/{environmentKey} | List users
-*ViewsBetaApi* | [**createView**](docs/ViewsBetaApi.md#createview) | **POST** /api/v2/projects/{projectKey}/views | Create view
-*ViewsBetaApi* | [**deleteView**](docs/ViewsBetaApi.md#deleteview) | **DELETE** /api/v2/projects/{projectKey}/views/{viewKey} | Delete view
-*ViewsBetaApi* | [**getLinkedResources**](docs/ViewsBetaApi.md#getlinkedresources) | **GET** /api/v2/projects/{projectKey}/views/{viewKey}/linked/{resourceType} | Get linked resources
-*ViewsBetaApi* | [**getLinkedViews**](docs/ViewsBetaApi.md#getlinkedviews) | **GET** /api/v2/projects/{projectKey}/view-associations/{resourceType}/{resourceKey} | Get linked views for a given resource
-*ViewsBetaApi* | [**getView**](docs/ViewsBetaApi.md#getview) | **GET** /api/v2/projects/{projectKey}/views/{viewKey} | Get view
-*ViewsBetaApi* | [**getViews**](docs/ViewsBetaApi.md#getviews) | **GET** /api/v2/projects/{projectKey}/views | List views
-*ViewsBetaApi* | [**linkResource**](docs/ViewsBetaApi.md#linkresource) | **POST** /api/v2/projects/{projectKey}/views/{viewKey}/link/{resourceType} | Link resource
-*ViewsBetaApi* | [**unlinkResource**](docs/ViewsBetaApi.md#unlinkresource) | **DELETE** /api/v2/projects/{projectKey}/views/{viewKey}/link/{resourceType} | Unlink resource
-*ViewsBetaApi* | [**updateView**](docs/ViewsBetaApi.md#updateview) | **PATCH** /api/v2/projects/{projectKey}/views/{viewKey} | Update view
+*ViewsApi* | [**createView**](docs/ViewsApi.md#createview) | **POST** /api/v2/projects/{projectKey}/views | Create view
+*ViewsApi* | [**deleteView**](docs/ViewsApi.md#deleteview) | **DELETE** /api/v2/projects/{projectKey}/views/{viewKey} | Delete view
+*ViewsApi* | [**getLinkedResources**](docs/ViewsApi.md#getlinkedresources) | **GET** /api/v2/projects/{projectKey}/views/{viewKey}/linked/{resourceType} | Get linked resources
+*ViewsApi* | [**getLinkedViews**](docs/ViewsApi.md#getlinkedviews) | **GET** /api/v2/projects/{projectKey}/view-associations/{resourceType}/{resourceKey} | Get linked views for a given resource
+*ViewsApi* | [**getView**](docs/ViewsApi.md#getview) | **GET** /api/v2/projects/{projectKey}/views/{viewKey} | Get view
+*ViewsApi* | [**getViews**](docs/ViewsApi.md#getviews) | **GET** /api/v2/projects/{projectKey}/views | List views
+*ViewsApi* | [**linkResource**](docs/ViewsApi.md#linkresource) | **POST** /api/v2/projects/{projectKey}/views/{viewKey}/link/{resourceType} | Link resource
+*ViewsApi* | [**unlinkResource**](docs/ViewsApi.md#unlinkresource) | **DELETE** /api/v2/projects/{projectKey}/views/{viewKey}/link/{resourceType} | Unlink resource
+*ViewsApi* | [**updateView**](docs/ViewsApi.md#updateview) | **PATCH** /api/v2/projects/{projectKey}/views/{viewKey} | Update view
*WebhooksApi* | [**deleteWebhook**](docs/WebhooksApi.md#deletewebhook) | **DELETE** /api/v2/webhooks/{id} | Delete webhook
*WebhooksApi* | [**getAllWebhooks**](docs/WebhooksApi.md#getallwebhooks) | **GET** /api/v2/webhooks | List webhooks
*WebhooksApi* | [**getWebhook**](docs/WebhooksApi.md#getwebhook) | **GET** /api/v2/webhooks/{id} | Get webhook
@@ -494,6 +505,12 @@ Class | Method | HTTP request | Description
- [AccessTokenPost](docs/AccessTokenPost.md)
- [ActionInput](docs/ActionInput.md)
- [ActionOutput](docs/ActionOutput.md)
+ - [AdaptiveTrigger](docs/AdaptiveTrigger.md)
+ - [AdaptiveTriggerInstruction](docs/AdaptiveTriggerInstruction.md)
+ - [AdaptiveTriggerResourceKind](docs/AdaptiveTriggerResourceKind.md)
+ - [AdaptiveTriggerTask](docs/AdaptiveTriggerTask.md)
+ - [AdaptiveTriggers](docs/AdaptiveTriggers.md)
+ - [AdaptiveTriggersPaginatedLinks](docs/AdaptiveTriggersPaginatedLinks.md)
- [AgentGraph](docs/AgentGraph.md)
- [AgentGraphEdge](docs/AgentGraphEdge.md)
- [AgentGraphEdgePost](docs/AgentGraphEdgePost.md)
@@ -590,7 +607,9 @@ Class | Method | HTTP request | Description
- [CallerIdentityRep](docs/CallerIdentityRep.md)
- [CapabilityConfigPost](docs/CapabilityConfigPost.md)
- [CapabilityConfigRep](docs/CapabilityConfigRep.md)
+ - [Classifier](docs/Classifier.md)
- [Clause](docs/Clause.md)
+ - [CleanupBehavior](docs/CleanupBehavior.md)
- [Client](docs/Client.md)
- [ClientCollection](docs/ClientCollection.md)
- [ClientSideAvailability](docs/ClientSideAvailability.md)
@@ -610,11 +629,8 @@ Class | Method | HTTP request | Description
- [ContextInstanceEvaluation](docs/ContextInstanceEvaluation.md)
- [ContextInstanceEvaluationReason](docs/ContextInstanceEvaluationReason.md)
- [ContextInstanceEvaluations](docs/ContextInstanceEvaluations.md)
- - [ContextInstanceRecord](docs/ContextInstanceRecord.md)
- - [ContextInstanceSearch](docs/ContextInstanceSearch.md)
- [ContextInstanceSegmentMembership](docs/ContextInstanceSegmentMembership.md)
- [ContextInstanceSegmentMemberships](docs/ContextInstanceSegmentMemberships.md)
- - [ContextInstances](docs/ContextInstances.md)
- [ContextKindEnvironmentObservation](docs/ContextKindEnvironmentObservation.md)
- [ContextKindRep](docs/ContextKindRep.md)
- [ContextKindsCollectionRep](docs/ContextKindsCollectionRep.md)
@@ -626,13 +642,14 @@ Class | Method | HTTP request | Description
- [CountBucket](docs/CountBucket.md)
- [CountBucketsResult](docs/CountBucketsResult.md)
- [CovariateInfoRep](docs/CovariateInfoRep.md)
+ - [CreateAdaptiveTriggerRequest](docs/CreateAdaptiveTriggerRequest.md)
- [CreateAnnouncementBody](docs/CreateAnnouncementBody.md)
- [CreateApprovalRequestRequest](docs/CreateApprovalRequestRequest.md)
- [CreateCopyFlagConfigApprovalRequestRequest](docs/CreateCopyFlagConfigApprovalRequestRequest.md)
- [CreateFlagConfigApprovalRequestRequest](docs/CreateFlagConfigApprovalRequestRequest.md)
- [CreateIpAllowlistEntryRequest](docs/CreateIpAllowlistEntryRequest.md)
- [CreatePhaseInput](docs/CreatePhaseInput.md)
- - [CreateReleaseInput](docs/CreateReleaseInput.md)
+ - [CreatePipelineReleaseInput](docs/CreatePipelineReleaseInput.md)
- [CreateReleasePipelineInput](docs/CreateReleasePipelineInput.md)
- [CreateWorkflowTemplateInput](docs/CreateWorkflowTemplateInput.md)
- [CustomProperty](docs/CustomProperty.md)
@@ -644,6 +661,14 @@ Class | Method | HTTP request | Description
- [CustomWorkflowOutput](docs/CustomWorkflowOutput.md)
- [CustomWorkflowStageMeta](docs/CustomWorkflowStageMeta.md)
- [CustomWorkflowsListingOutput](docs/CustomWorkflowsListingOutput.md)
+ - [DataExportProjectIdentityIncompleteError](docs/DataExportProjectIdentityIncompleteError.md)
+ - [DataExportProjectIdentityIncompleteErrorRep](docs/DataExportProjectIdentityIncompleteErrorRep.md)
+ - [DataExportProjectRankComponentsRep](docs/DataExportProjectRankComponentsRep.md)
+ - [DataExportProjectRankRep](docs/DataExportProjectRankRep.md)
+ - [DataExportProjectRankingPageRep](docs/DataExportProjectRankingPageRep.md)
+ - [DataExportProjectRankingRep](docs/DataExportProjectRankingRep.md)
+ - [DataExportProjectRankingScopeRep](docs/DataExportProjectRankingScopeRep.md)
+ - [DataExportSeriesListRep](docs/DataExportSeriesListRep.md)
- [DefaultClientSideAvailability](docs/DefaultClientSideAvailability.md)
- [DefaultClientSideAvailabilityPost](docs/DefaultClientSideAvailabilityPost.md)
- [Defaults](docs/Defaults.md)
@@ -652,20 +677,42 @@ Class | Method | HTTP request | Description
- [DependentFlag](docs/DependentFlag.md)
- [DependentFlagEnvironment](docs/DependentFlagEnvironment.md)
- [DependentFlagsByEnvironment](docs/DependentFlagsByEnvironment.md)
- - [DependentMeasuredRolloutRep](docs/DependentMeasuredRolloutRep.md)
- [DependentMetricGroupRep](docs/DependentMetricGroupRep.md)
- [DependentMetricGroupRepWithMetrics](docs/DependentMetricGroupRepWithMetrics.md)
- [DependentMetricOrMetricGroupRep](docs/DependentMetricOrMetricGroupRep.md)
+ - [DependentReleasePhaseRep](docs/DependentReleasePhaseRep.md)
- [DeploymentCollectionRep](docs/DeploymentCollectionRep.md)
- [DeploymentRep](docs/DeploymentRep.md)
- [Destination](docs/Destination.md)
- [DestinationPost](docs/DestinationPost.md)
- [Destinations](docs/Destinations.md)
+ - [DynamicOptionFiltersItems](docs/DynamicOptionFiltersItems.md)
- [DynamicOptions](docs/DynamicOptions.md)
- [DynamicOptionsParser](docs/DynamicOptionsParser.md)
+ - [DynamicOptionsSource](docs/DynamicOptionsSource.md)
- [Endpoint](docs/Endpoint.md)
- [Environment](docs/Environment.md)
- [EnvironmentPost](docs/EnvironmentPost.md)
+ - [EnvironmentRelease](docs/EnvironmentRelease.md)
+ - [EnvironmentReleaseAdvancementMode](docs/EnvironmentReleaseAdvancementMode.md)
+ - [EnvironmentReleaseClause](docs/EnvironmentReleaseClause.md)
+ - [EnvironmentReleaseCollection](docs/EnvironmentReleaseCollection.md)
+ - [EnvironmentReleaseExistingRulePhaseInput](docs/EnvironmentReleaseExistingRulePhaseInput.md)
+ - [EnvironmentReleaseLink](docs/EnvironmentReleaseLink.md)
+ - [EnvironmentReleaseMetricInput](docs/EnvironmentReleaseMetricInput.md)
+ - [EnvironmentReleaseNewRulePhaseInput](docs/EnvironmentReleaseNewRulePhaseInput.md)
+ - [EnvironmentReleasePhase](docs/EnvironmentReleasePhase.md)
+ - [EnvironmentReleasePhaseInput](docs/EnvironmentReleasePhaseInput.md)
+ - [EnvironmentReleaseResolution](docs/EnvironmentReleaseResolution.md)
+ - [EnvironmentReleaseStepInput](docs/EnvironmentReleaseStepInput.md)
+ - [EnvironmentReleasesAccess](docs/EnvironmentReleasesAccess.md)
+ - [EnvironmentReleasesAccessAllowedRep](docs/EnvironmentReleasesAccessAllowedRep.md)
+ - [EnvironmentReleasesAccessDenied](docs/EnvironmentReleasesAccessDenied.md)
+ - [EnvironmentReleasesFilter](docs/EnvironmentReleasesFilter.md)
+ - [EnvironmentReleasesMemberSummary](docs/EnvironmentReleasesMemberSummary.md)
+ - [EnvironmentReleasesMetricDenominatorRep](docs/EnvironmentReleasesMetricDenominatorRep.md)
+ - [EnvironmentReleasesMetricListingRep](docs/EnvironmentReleasesMetricListingRep.md)
+ - [EnvironmentReleasesModification](docs/EnvironmentReleasesModification.md)
- [EnvironmentSummary](docs/EnvironmentSummary.md)
- [Environments](docs/Environments.md)
- [EvaluationReason](docs/EvaluationReason.md)
@@ -702,6 +749,7 @@ Class | Method | HTTP request | Description
- [ExperimentInfoRep](docs/ExperimentInfoRep.md)
- [ExperimentPatchInput](docs/ExperimentPatchInput.md)
- [ExperimentPost](docs/ExperimentPost.md)
+ - [ExperimentationLink](docs/ExperimentationLink.md)
- [ExpiringTarget](docs/ExpiringTarget.md)
- [ExpiringTargetError](docs/ExpiringTargetError.md)
- [ExpiringTargetGetResponse](docs/ExpiringTargetGetResponse.md)
@@ -890,6 +938,7 @@ Class | Method | HTTP request | Description
- [NewMemberForm](docs/NewMemberForm.md)
- [NotFoundErrorRep](docs/NotFoundErrorRep.md)
- [OauthClientPost](docs/OauthClientPost.md)
+ - [ObservabilityAlertSource](docs/ObservabilityAlertSource.md)
- [OptionsArray](docs/OptionsArray.md)
- [PaginatedLinks](docs/PaginatedLinks.md)
- [ParameterDefault](docs/ParameterDefault.md)
@@ -911,6 +960,14 @@ Class | Method | HTTP request | Description
- [PermissionGrantInput](docs/PermissionGrantInput.md)
- [Phase](docs/Phase.md)
- [PhaseInfo](docs/PhaseInfo.md)
+ - [PipelineRelease](docs/PipelineRelease.md)
+ - [PipelineReleaseAudience](docs/PipelineReleaseAudience.md)
+ - [PipelineReleaseAudienceConfigInput](docs/PipelineReleaseAudienceConfigInput.md)
+ - [PipelineReleaseGuardianConfiguration](docs/PipelineReleaseGuardianConfiguration.md)
+ - [PipelineReleaseGuardianConfigurationInput](docs/PipelineReleaseGuardianConfigurationInput.md)
+ - [PipelineReleasePhase](docs/PipelineReleasePhase.md)
+ - [PipelineReleaseProgression](docs/PipelineReleaseProgression.md)
+ - [PipelineReleaseProgressionCollection](docs/PipelineReleaseProgressionCollection.md)
- [PostApprovalRequestApplyRequest](docs/PostApprovalRequestApplyRequest.md)
- [PostApprovalRequestReviewRequest](docs/PostApprovalRequestReviewRequest.md)
- [PostDeploymentEventInput](docs/PostDeploymentEventInput.md)
@@ -950,12 +1007,11 @@ Class | Method | HTTP request | Description
- [RelayAutoConfigCollectionRep](docs/RelayAutoConfigCollectionRep.md)
- [RelayAutoConfigPost](docs/RelayAutoConfigPost.md)
- [RelayAutoConfigRep](docs/RelayAutoConfigRep.md)
- - [Release](docs/Release.md)
- - [ReleaseAudience](docs/ReleaseAudience.md)
- - [ReleaseGuardianConfiguration](docs/ReleaseGuardianConfiguration.md)
- - [ReleaseGuardianConfigurationInput](docs/ReleaseGuardianConfigurationInput.md)
+ - [ReleaseHealthCheckFailure](docs/ReleaseHealthCheckFailure.md)
+ - [ReleaseHealthCheckKind](docs/ReleaseHealthCheckKind.md)
- [ReleaseMethod](docs/ReleaseMethod.md)
- - [ReleasePhase](docs/ReleasePhase.md)
+ - [ReleaseMetric](docs/ReleaseMetric.md)
+ - [ReleaseMetricStatus](docs/ReleaseMetricStatus.md)
- [ReleasePipeline](docs/ReleasePipeline.md)
- [ReleasePipelineCollection](docs/ReleasePipelineCollection.md)
- [ReleasePoliciesAccess](docs/ReleasePoliciesAccess.md)
@@ -968,9 +1024,10 @@ Class | Method | HTTP request | Description
- [ReleasePolicy](docs/ReleasePolicy.md)
- [ReleasePolicyScope](docs/ReleasePolicyScope.md)
- [ReleasePolicyStage](docs/ReleasePolicyStage.md)
- - [ReleaseProgression](docs/ReleaseProgression.md)
- - [ReleaseProgressionCollection](docs/ReleaseProgressionCollection.md)
- - [ReleaserAudienceConfigInput](docs/ReleaserAudienceConfigInput.md)
+ - [ReleaseStatus](docs/ReleaseStatus.md)
+ - [ReleaseStatusReason](docs/ReleaseStatusReason.md)
+ - [ReleaseStep](docs/ReleaseStep.md)
+ - [ReleaseType](docs/ReleaseType.md)
- [RepositoryCollectionRep](docs/RepositoryCollectionRep.md)
- [RepositoryPost](docs/RepositoryPost.md)
- [RepositoryRep](docs/RepositoryRep.md)
@@ -993,6 +1050,8 @@ Class | Method | HTTP request | Description
- [SdkKeyListItem](docs/SdkKeyListItem.md)
- [SdkKeyPatch](docs/SdkKeyPatch.md)
- [SdkKeyPost](docs/SdkKeyPost.md)
+ - [SdkKeyViewsPut](docs/SdkKeyViewsPut.md)
+ - [SdkKeys](docs/SdkKeys.md)
- [SdkKeysEnvironmentSummary](docs/SdkKeysEnvironmentSummary.md)
- [SdkKeysForGetSdkKeys](docs/SdkKeysForGetSdkKeys.md)
- [SdkKeysSelfLink](docs/SdkKeysSelfLink.md)
@@ -1016,6 +1075,8 @@ Class | Method | HTTP request | Description
- [StageInput](docs/StageInput.md)
- [StageOutput](docs/StageOutput.md)
- [StaleFlagData](docs/StaleFlagData.md)
+ - [StartEnvironmentReleaseBadRequest](docs/StartEnvironmentReleaseBadRequest.md)
+ - [StartEnvironmentReleaseRequest](docs/StartEnvironmentReleaseRequest.md)
- [Statement](docs/Statement.md)
- [StatementPost](docs/StatementPost.md)
- [StatisticCollectionRep](docs/StatisticCollectionRep.md)
@@ -1024,6 +1085,7 @@ Class | Method | HTTP request | Description
- [StatusConflictErrorRep](docs/StatusConflictErrorRep.md)
- [StatusResponse](docs/StatusResponse.md)
- [StatusServiceUnavailable](docs/StatusServiceUnavailable.md)
+ - [StopEnvironmentReleaseRequest](docs/StopEnvironmentReleaseRequest.md)
- [StoreIntegrationError](docs/StoreIntegrationError.md)
- [SubjectDataRep](docs/SubjectDataRep.md)
- [SubscriptionPost](docs/SubscriptionPost.md)
@@ -1058,6 +1120,7 @@ Class | Method | HTTP request | Description
- [TrustPolicyStatement](docs/TrustPolicyStatement.md)
- [UnauthorizedErrorRep](docs/UnauthorizedErrorRep.md)
- [UnlinkResourceSuccessResponse](docs/UnlinkResourceSuccessResponse.md)
+ - [UpdateAdaptiveTriggerRequest](docs/UpdateAdaptiveTriggerRequest.md)
- [UpdatePhaseStatusInput](docs/UpdatePhaseStatusInput.md)
- [UpdateReleasePipelineInput](docs/UpdateReleasePipelineInput.md)
- [UpsertContextKindPayload](docs/UpsertContextKindPayload.md)
diff --git a/api.ts b/api.ts
index 436dd80..4224b90 100644
--- a/api.ts
+++ b/api.ts
@@ -2,7 +2,7 @@
/* eslint-disable */
/**
* LaunchDarkly REST API
- * This documentation describes LaunchDarkly\'s REST API. To access the complete OpenAPI spec directly, use [Get OpenAPI spec](https://launchdarkly.com/docs/api/other/get-openapi-spec). To learn how to use LaunchDarkly using the user interface (UI) instead, read our [product documentation](https://launchdarkly.com/docs/home). ## Authentication LaunchDarkly\'s REST API uses the HTTPS protocol with a minimum TLS version of 1.2. All REST API resources are authenticated with either [personal or service access tokens](https://launchdarkly.com/docs/home/account/api), or session cookies. Other authentication mechanisms are not supported. You can manage personal access tokens on your [**Authorization**](https://app.launchdarkly.com/settings/authorization) page in the LaunchDarkly UI. LaunchDarkly also has SDK keys, mobile keys, and client-side IDs that are used by our server-side SDKs, mobile SDKs, and JavaScript-based SDKs, respectively. **These keys cannot be used to access our REST API**. These keys are environment-specific, and can only perform read-only operations such as fetching feature flag settings. | Auth mechanism | Allowed resources | Use cases | | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------- | | [Personal or service access tokens](https://launchdarkly.com/docs/home/account/api) | Can be customized on a per-token basis | Building scripts, custom integrations, data export. | | SDK keys | Can only access read-only resources specific to server-side SDKs. Restricted to a single environment. | Server-side SDKs | | Mobile keys | Can only access read-only resources specific to mobile SDKs, and only for flags marked available to mobile keys. Restricted to a single environment. | Mobile SDKs | | Client-side ID | Can only access read-only resources specific to JavaScript-based client-side SDKs, and only for flags marked available to client-side. Restricted to a single environment. | Client-side JavaScript | > #### Keep your access tokens and SDK keys private > > Access tokens should _never_ be exposed in untrusted contexts. Never put an access token in client-side JavaScript, or embed it in a mobile application. LaunchDarkly has special mobile keys that you can embed in mobile apps. If you accidentally expose an access token or SDK key, you can reset it from your [**Authorization**](https://app.launchdarkly.com/settings/authorization) page. > > The client-side ID is safe to embed in untrusted contexts. It\'s designed for use in client-side JavaScript. ### Authentication using request header The preferred way to authenticate with the API is by adding an `Authorization` header containing your access token to your requests. The value of the `Authorization` header must be your access token. Manage personal access tokens from the [**Authorization**](https://app.launchdarkly.com/settings/authorization) page. ### Authentication using session cookie For testing purposes, you can make API calls directly from your web browser. If you are logged in to the LaunchDarkly application, the API will use your existing session to authenticate calls. Depending on the permissions granted as part of your [role](https://launchdarkly.com/docs/home/account/roles), you may not have permission to perform some API calls. You will receive a `401` response code in that case. > ### Modifying the Origin header causes an error > > LaunchDarkly validates that the Origin header for any API request authenticated by a session cookie matches the expected Origin header. The expected Origin header is `https://app.launchdarkly.com`. > > If the Origin header does not match what\'s expected, LaunchDarkly returns an error. This error can prevent the LaunchDarkly app from working correctly. > > Any browser extension that intentionally changes the Origin header can cause this problem. For example, Cross-Origin Resource Sharing (CORS) extensions used during development can modify the Origin header and cause the app to fail. > > To prevent this error, do not modify your Origin header. > > LaunchDarkly does not require origin matching when authenticating with an access token, so this issue does not affect normal API usage. ## Representations All resources expect and return JSON response bodies. Error responses also send a JSON body. To learn more about the error format of the API, read [Errors](https://launchdarkly.com/docs/api#errors). In practice this means that you always get a response with a `Content-Type` header set to `application/json`. In addition, request bodies for `PATCH`, `POST`, and `PUT` requests must be encoded as JSON with a `Content-Type` header set to `application/json`. ### Summary and detailed representations When you fetch a list of resources, the response includes only the most important attributes of each resource. This is a _summary representation_ of the resource. When you fetch an individual resource, such as a single feature flag, you receive a _detailed representation_ of the resource. The best way to find a detailed representation is to follow links. Every summary representation includes a link to its detailed representation. ### Expanding responses Sometimes the detailed representation of a resource does not include all of the attributes of the resource by default. If this is the case, the request method will clearly document this and describe which attributes you can include in an expanded response. To include the additional attributes, append the `expand` request parameter to your request and add a comma-separated list of the attributes to include. For example, when you append `?expand=members,maintainers` to the [Get team](https://launchdarkly.com/docs/api/teams/get-team) endpoint, the expanded response includes both of these attributes. ### Links and addressability The best way to navigate the API is by following links. These are attributes in representations that link to other resources. The API always uses the same format for links: - Links to other resources within the API are encapsulated in a `_links` object - If the resource has a corresponding link to HTML content on the site, it is stored in a special `_site` link Each link has two attributes: - An `href`, which contains the URL - A `type`, which describes the content type For example, a feature resource might return the following: ```json { \"_links\": { \"parent\": { \"href\": \"/api/features\", \"type\": \"application/json\" }, \"self\": { \"href\": \"/api/features/sort.order\", \"type\": \"application/json\" } }, \"_site\": { \"href\": \"/features/sort.order\", \"type\": \"text/html\" } } ``` From this, you can navigate to the parent collection of features by following the `parent` link, or navigate to the site page for the feature by following the `_site` link. Collections are always represented as a JSON object with an `items` attribute containing an array of representations. Like all other representations, collections have `_links` defined at the top level. Paginated collections include `first`, `last`, `next`, and `prev` links containing a URL with the respective set of elements in the collection. ## Updates Resources that accept partial updates use the `PATCH` verb. Most resources support the [JSON patch](https://launchdarkly.com/docs/api#updates-using-json-patch) format. Some resources also support the [JSON merge patch](https://launchdarkly.com/docs/api#updates-using-json-merge-patch) format, and some resources support the [semantic patch](https://launchdarkly.com/docs/api#updates-using-semantic-patch) format, which is a way to specify the modifications to perform as a set of executable instructions. Each resource supports optional [comments](https://launchdarkly.com/docs/api#updates-with-comments) that you can submit with updates. Comments appear in outgoing webhooks, the audit log, and other integrations. When a resource supports both JSON patch and semantic patch, we document both in the request method. However, the specific request body fields and descriptions included in our documentation only match one type of patch or the other. ### Updates using JSON patch [JSON patch](https://datatracker.ietf.org/doc/html/rfc6902) is a way to specify the modifications to perform on a resource. JSON patch uses paths and a limited set of operations to describe how to transform the current state of the resource into a new state. JSON patch documents are always arrays, where each element contains an operation, a path to the field to update, and the new value. For example, in this feature flag representation: ```json { \"name\": \"New recommendations engine\", \"key\": \"engine.enable\", \"description\": \"This is the description\", ... } ``` You can change the feature flag\'s description with the following patch document: ```json [{ \"op\": \"replace\", \"path\": \"/description\", \"value\": \"This is the new description\" }] ``` You can specify multiple modifications to perform in a single request. You can also test that certain preconditions are met before applying the patch: ```json [ { \"op\": \"test\", \"path\": \"/version\", \"value\": 10 }, { \"op\": \"replace\", \"path\": \"/description\", \"value\": \"The new description\" } ] ``` The above patch request tests whether the feature flag\'s `version` is `10`, and if so, changes the feature flag\'s description. Attributes that are not editable, such as a resource\'s `_links`, have names that start with an underscore. ### Updates using JSON merge patch [JSON merge patch](https://datatracker.ietf.org/doc/html/rfc7386) is another format for specifying the modifications to perform on a resource. JSON merge patch is less expressive than JSON patch. However, in many cases it is simpler to construct a merge patch document. For example, you can change a feature flag\'s description with the following merge patch document: ```json { \"description\": \"New flag description\" } ``` ### Updates using semantic patch Some resources support the semantic patch format. A semantic patch is a way to specify the modifications to perform on a resource as a set of executable instructions. Semantic patch allows you to be explicit about intent using precise, custom instructions. In many cases, you can define semantic patch instructions independently of the current state of the resource. This can be useful when defining a change that may be applied at a future date. To make a semantic patch request, you must append `domain-model=launchdarkly.semanticpatch` to your `Content-Type` header. Here\'s how: ``` Content-Type: application/json; domain-model=launchdarkly.semanticpatch ``` If you call a semantic patch resource without this header, you will receive a `400` response because your semantic patch will be interpreted as a JSON patch. The body of a semantic patch request takes the following properties: * `comment` (string): (Optional) A description of the update. * `environmentKey` (string): (Required for some resources only) The environment key. * `instructions` (array): (Required) A list of actions the update should perform. Each action in the list must be an object with a `kind` property that indicates the instruction. If the instruction requires parameters, you must include those parameters as additional fields in the object. The documentation for each resource that supports semantic patch includes the available instructions and any additional parameters. For example: ```json { \"comment\": \"optional comment\", \"instructions\": [ {\"kind\": \"turnFlagOn\"} ] } ``` Semantic patches are not applied partially; either all of the instructions are applied or none of them are. If **any** instruction is invalid, the endpoint returns an error and will not change the resource. If all instructions are valid, the request succeeds and the resources are updated if necessary, or left unchanged if they are already in the state you request. ### Updates with comments You can submit optional comments with `PATCH` changes. To submit a comment along with a JSON patch document, use the following format: ```json { \"comment\": \"This is a comment string\", \"patch\": [{ \"op\": \"replace\", \"path\": \"/description\", \"value\": \"The new description\" }] } ``` To submit a comment along with a JSON merge patch document, use the following format: ```json { \"comment\": \"This is a comment string\", \"merge\": { \"description\": \"New flag description\" } } ``` To submit a comment along with a semantic patch, use the following format: ```json { \"comment\": \"This is a comment string\", \"instructions\": [ {\"kind\": \"turnFlagOn\"} ] } ``` ## Errors The API always returns errors in a common format. Here\'s an example: ```json { \"code\": \"invalid_request\", \"message\": \"A feature with that key already exists\", \"id\": \"30ce6058-87da-11e4-b116-123b93f75cba\" } ``` The `code` indicates the general class of error. The `message` is a human-readable explanation of what went wrong. The `id` is a unique identifier. Use it when you\'re working with LaunchDarkly Support to debug a problem with a specific API call. ### HTTP status error response codes | Code | Definition | Description | Possible Solution | | ---- | ----------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | 400 | Invalid request | The request cannot be understood. | Ensure JSON syntax in request body is correct. | | 401 | Invalid access token | Requestor is unauthorized or does not have permission for this API call. | Ensure your API access token is valid and has the appropriate permissions. | | 403 | Forbidden | Requestor does not have access to this resource. | Ensure that the account member or access token has proper permissions set. | | 404 | Invalid resource identifier | The requested resource is not valid. | Ensure that the resource is correctly identified by ID or key. | | 405 | Method not allowed | The request method is not allowed on this resource. | Ensure that the HTTP verb is correct. | | 409 | Conflict | The API request can not be completed because it conflicts with a concurrent API request. | Retry your request. | | 422 | Unprocessable entity | The API request can not be completed because the update description can not be understood. | Ensure that the request body is correct for the type of patch you are using, either JSON patch or semantic patch. | 429 | Too many requests | Read [Rate limiting](https://launchdarkly.com/docs/api#rate-limiting). | Wait and try again later. | ## CORS The LaunchDarkly API supports Cross Origin Resource Sharing (CORS) for AJAX requests from any origin. If an `Origin` header is given in a request, it will be echoed as an explicitly allowed origin. Otherwise the request returns a wildcard, `Access-Control-Allow-Origin: *`. For more information on CORS, read the [CORS W3C Recommendation](http://www.w3.org/TR/cors). Example CORS headers might look like: ```http Access-Control-Allow-Headers: Accept, Content-Type, Content-Length, Accept-Encoding, Authorization Access-Control-Allow-Methods: OPTIONS, GET, DELETE, PATCH Access-Control-Allow-Origin: * Access-Control-Max-Age: 300 ``` You can make authenticated CORS calls just as you would make same-origin calls, using either [token or session-based authentication](https://launchdarkly.com/docs/api#authentication). If you are using session authentication, you should set the `withCredentials` property for your `xhr` request to `true`. You should never expose your access tokens to untrusted entities. ## Rate limiting We use several rate-limiting strategies to ensure the availability of our APIs. Rate-limited calls to our APIs return a `429` status code and include headers to indicate the current rate limit status. The specific headers returned depend on the API route that was called. Limits differ based on the route, authentication mechanism, and other factors. Each set of headers below appears only when the corresponding limit is being enforced for your call. A given route may be subject to any combination of these limits, so a response can include one, several, or none of these headers. A missing header indicates that the limit was not applied to this specific call; it does not necessarily indicate that the limit does not exist. To reduce usage before hitting a `429` status, program against whichever rate limit headers are present rather than expecting a specific header. We do not publicly document the specific number of calls permitted by any of these limits, and these limits may change. We encourage clients to program against the specification and rely on the headers described below, rather than hardcoding the current limits. > ### Rate limiting and SDKs > > LaunchDarkly SDKs are never rate limited and do not use the API endpoints defined here. LaunchDarkly uses a different set of approaches, including streaming/server-sent events and a global CDN, to ensure availability to the routes used by LaunchDarkly SDKs. ### Global rate limits Authenticated requests are subject to a global limit. This is the maximum number of calls that your account can make to the API per ten seconds. All service and personal access tokens on the account share this limit, so exceeding the limit with one access token will impact other tokens. Calls that are subject to global rate limits may return the headers below: | Header name | Description | | ------------------------------ | -------------------------------------------------------------------------------- | | `X-Ratelimit-Global-Limit` | The maximum number of requests the account is permitted to make per ten seconds. | | `X-Ratelimit-Global-Remaining` | The number of requests remaining in the current global rate limit window. | | `X-Ratelimit-Reset` | The time at which the current rate limit window resets in epoch milliseconds. | ### Route-level rate limits Some authenticated routes have custom rate limits. These also reset every ten seconds. Any service or personal access tokens hitting the same route share this limit, so exceeding the limit with one access token may impact other tokens. Calls that are subject to route-level rate limits return the headers below: | Header name | Description | | ----------------------------- | ----------------------------------------------------------------------------------------------------- | | `X-Ratelimit-Route-Limit` | The maximum number of requests to the current route permitted per ten seconds. | | `X-Ratelimit-Route-Remaining` | The number of requests remaining for the current route in the current rate limit window. | | `X-Ratelimit-Reset` | The time at which the current rate limit window resets in epoch milliseconds. | A _route_ represents a specific URL pattern and verb. For example, the [Delete environment](https://launchdarkly.com/docs/api/environments/delete-environment) endpoint is considered a single route, and each call to delete an environment counts against your route-level rate limit for that route. ### Access token rate limits Some calls are rate limited per access token. Unlike the global and route-level limits, this limit applies to a single service or personal access token on its own. Exceeding a limit with one access token does not affect other tokens on the account. Calls that are subject to access token rate limits return these headers: | Header name | Description | | ---------------------------------- | --------------------------------------------------------------------------------------- | | `X-Ratelimit-Auth-Token-Limit` | The maximum number of requests the access token can make per ten seconds. | | `X-Ratelimit-Auth-Token-Remaining` | The number of requests remaining for the access token in the current rate limit window. | | `X-Ratelimit-Auth-Token-Reset` | The time at which the current rate limit window resets in epoch milliseconds. | Unlike the other rate limits, access token rate limits report their own reset time in the `X-Ratelimit-Auth-Token-Reset` header instead of in `X-Ratelimit-Reset`. ### IP-based rate limiting We also employ IP-based rate limiting on some API routes. If you hit an IP-based rate limit, your API response will include a `Retry-After` header indicating how long to wait before re-trying the call. Clients must wait at least `Retry-After` seconds before making additional calls to our API, and should employ jitter and backoff strategies to avoid triggering rate limits again. ## OpenAPI (Swagger) and client libraries We have a [complete OpenAPI (Swagger) specification](https://app.launchdarkly.com/api/v2/openapi.json) for our API. We auto-generate multiple client libraries based on our OpenAPI specification. To learn more, visit the [collection of client libraries on GitHub](https://github.com/search?q=topic%3Alaunchdarkly-api+org%3Alaunchdarkly&type=Repositories). Alternatively, you can use the specification to generate client libraries to interact with our REST API in your language of choice. Or, you can refer to our API endpoints\' documentation for guidance on how to make requests with a common HTTP library in your language of choice. Our OpenAPI specification is supported by several API-based tools such as Postman and Insomnia. In many cases, you can directly import our specification to explore our APIs. ## Method overriding Some firewalls and HTTP clients restrict the use of verbs other than `GET` and `POST`. In those environments, our API endpoints that use `DELETE`, `PATCH`, and `PUT` verbs are inaccessible. To avoid this issue, our API supports the `X-HTTP-Method-Override` header, allowing clients to \"tunnel\" `DELETE`, `PATCH`, and `PUT` requests using a `POST` request. For example, to call a `PATCH` endpoint using a `POST` request, you can include `X-HTTP-Method-Override:PATCH` as a header. ## Beta resources We sometimes release new API resources in **beta** status before we release them with general availability. Resources that are in beta are still undergoing testing and development. They may change without notice, including becoming backwards incompatible. We try to promote resources into general availability as quickly as possible. This happens after sufficient testing and when we\'re satisfied that we no longer need to make backwards-incompatible changes. We mark beta resources with a \"Beta\" callout in our documentation, pictured below: > ### This feature is in beta > > To use this feature, pass in a header including the `LD-API-Version` key with value set to `beta`. Use this header with each call. To learn more, read [Beta resources](https://launchdarkly.com/docs/api#beta-resources). > > Resources that are in beta are still undergoing testing and development. They may change without notice, including becoming backwards incompatible. ### Using beta resources To use a beta resource, you must include a header in the request. If you call a beta resource without this header, you receive a `403` response. Use this header: ``` LD-API-Version: beta ``` ## Federal and EU environments In addition to the commercial versions, LaunchDarkly offers instances for federal agencies and those based in the European Union (EU). ### Federal environments The version of LaunchDarkly that is available on domains controlled by the United States government is different from the version of LaunchDarkly available to the general public. If you are an employee or contractor for a United States federal agency and use LaunchDarkly in your work, you likely use the federal instance of LaunchDarkly. If you are working in the federal instance of LaunchDarkly, the base URI for each request is `https://app.launchdarkly.us`. To learn more, read [LaunchDarkly in federal environments](https://launchdarkly.com/docs/home/infrastructure/federal). ### EU environments The version of LaunchDarkly that is available in the EU is different from the version of LaunchDarkly available to other regions. If you are based in the EU, you likely use the EU instance of LaunchDarkly. The LaunchDarkly EU instance complies with EU data residency principles, including the protection and confidentiality of EU customer information. If you are working in the EU instance of LaunchDarkly, the base URI for each request is `https://app.eu.launchdarkly.com`. To learn more, read [LaunchDarkly in the European Union (EU)](https://launchdarkly.com/docs/home/infrastructure/eu). ## Versioning We try hard to keep our REST API backwards compatible, but we occasionally have to make backwards-incompatible changes in the process of shipping new features. These breaking changes can cause unexpected behavior if you don\'t prepare for them accordingly. Updates to our REST API include support for the latest features in LaunchDarkly. We also release a new version of our REST API every time we make a breaking change. We provide simultaneous support for multiple API versions so you can migrate from your current API version to a new version at your own pace. ### Setting the API version per request You can set the API version on a specific request by sending an `LD-API-Version` header, as shown in the example below: ``` LD-API-Version: 20240415 ``` The header value is the version number of the API version you would like to request. The number for each version corresponds to the date the version was released in `yyyymmdd` format. In the example above the version `20240415` corresponds to April 15, 2024. ### Setting the API version per access token When you create an access token, you must specify a specific version of the API to use. This ensures that integrations using this token cannot be broken by version changes. Tokens created before versioning was released have their version set to `20160426`, which is the version of the API that existed before the current versioning scheme, so that they continue working the same way they did before versioning. If you would like to upgrade your integration to use a new API version, you can explicitly set the header described above. > ### Best practice: Set the header for every client or integration > > We recommend that you set the API version header explicitly in any client or integration you build. > > Only rely on the access token API version during manual testing. ### API version changelog
| Version | Changes | End of life (EOL) |
| `20240415` | - Changed several endpoints from unpaginated to paginated. Use the `limit` and `offset` query parameters to page through the results.
- Changed the [list access tokens](https://launchdarkly.com/docs/api/access-tokens/get-tokens) endpoint:
- Response is now paginated with a default limit of `25`
- Changed the [list account members](https://launchdarkly.com/docs/api/account-members/get-members) endpoint:
- The `accessCheck` filter is no longer available
- Changed the [list custom roles](https://launchdarkly.com/docs/api/custom-roles/get-custom-roles) endpoint:
- Response is now paginated with a default limit of `20`
- Changed the [list feature flags](https://launchdarkly.com/docs/api/feature-flags/get-feature-flags) endpoint:
- Response is now paginated with a default limit of `20`
- The `environments` field is now only returned if the request is filtered by environment, using the `filterEnv` query parameter
- The `followerId`, `hasDataExport`, `status`, `contextKindTargeted`, and `segmentTargeted` filters are no longer available
- The `compare` query parameter is no longer available
- Changed the [list segments](https://launchdarkly.com/docs/api/segments/get-segments) endpoint:
- Response is now paginated with a default limit of `20`
- Changed the [list teams](https://launchdarkly.com/docs/api/teams/get-teams) endpoint:
- The `expand` parameter no longer supports including `projects` or `roles`
- In paginated results, the maximum page size is now 100
- Changed the [get workflows](https://launchdarkly.com/docs/api/workflows/get-workflows) endpoint:
- Response is now paginated with a default limit of `20`
- The `_conflicts` field in the response is no longer available
| Current |
| `20220603` | - Changed the [list projects](https://launchdarkly.com/docs/api/projects/get-projects) return value:
- Response is now paginated with a default limit of `20`.
- Added support for filter and sort.
- The project `environments` field is now expandable. This field is omitted by default.
- Changed the [get project](https://launchdarkly.com/docs/api/projects/get-project) return value:
- The `environments` field is now expandable. This field is omitted by default.
| 2025-04-15 |
| `20210729` | - Changed the [create approval request](https://launchdarkly.com/docs/api/approvals/post-approval-request) return value. It now returns HTTP Status Code `201` instead of `200`.
- Changed the [get user](https://launchdarkly.com/docs/api/users/get-user) return value. It now returns a user record, not a user.
- Added additional optional fields to environment, segments, flags, members, and segments, including the ability to create big segments.
- Added default values for flag variations when new environments are created.
- Added filtering and pagination for getting flags and members, including `limit`, `number`, `filter`, and `sort` query parameters.
- Added endpoints for expiring user targets for flags and segments, scheduled changes, access tokens, Relay Proxy configuration, integrations and subscriptions, and approvals.
| 2023-06-03 |
| `20191212` | - [List feature flags](https://launchdarkly.com/docs/api/feature-flags/get-feature-flags) now defaults to sending summaries of feature flag configurations, equivalent to setting the query parameter `summary=true`. Summaries omit flag targeting rules and individual user targets from the payload.
- Added endpoints for flags, flag status, projects, environments, audit logs, members, users, custom roles, segments, usage, streams, events, and data export.
| 2022-07-29 |
| `20160426` | - Initial versioning of API. Tokens created before versioning have their version set to this.
| 2020-12-12 |
To learn more about how EOL is determined, read LaunchDarkly\'s [End of Life (EOL) Policy](https://launchdarkly.com/policies/end-of-life-policy/).
+ * This documentation describes LaunchDarkly\'s REST API. To access the complete OpenAPI spec directly, use [Get OpenAPI spec](https://launchdarkly.com/docs/api/other/get-openapi-spec). To learn how to use LaunchDarkly using the user interface (UI) instead, read our [product documentation](https://launchdarkly.com/docs/home). ## Authentication LaunchDarkly\'s REST API uses the HTTPS protocol with a minimum TLS version of 1.2. All REST API resources are authenticated with either [personal or service access tokens](https://launchdarkly.com/docs/home/account/api), or session cookies. Other authentication mechanisms are not supported. You can manage personal access tokens on your [**Authorization**](https://app.launchdarkly.com/settings/authorization) page in the LaunchDarkly UI. LaunchDarkly also has SDK keys, mobile keys, and client-side IDs that are used by our server-side SDKs, mobile SDKs, and JavaScript-based SDKs, respectively. **These keys cannot be used to access our REST API**. These keys are environment-specific, and can only perform read-only operations such as fetching feature flag settings. | Auth mechanism | Allowed resources | Use cases | | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------- | | [Personal or service access tokens](https://launchdarkly.com/docs/home/account/api) | Can be customized on a per-token basis | Building scripts, custom integrations, data export. | | SDK keys | Can only access read-only resources specific to server-side SDKs. Restricted to a single environment. | Server-side SDKs | | Mobile keys | Can only access read-only resources specific to mobile SDKs, and only for flags marked available to mobile keys. Restricted to a single environment. | Mobile SDKs | | Client-side ID | Can only access read-only resources specific to JavaScript-based client-side SDKs, and only for flags marked available to client-side. Restricted to a single environment. | Client-side JavaScript | > #### Keep your access tokens and SDK keys private > > Access tokens should _never_ be exposed in untrusted contexts. Never put an access token in client-side JavaScript, or embed it in a mobile application. LaunchDarkly has special mobile keys that you can embed in mobile apps. If you accidentally expose an access token or SDK key, you can reset it from your [**Authorization**](https://app.launchdarkly.com/settings/authorization) page. > > The client-side ID is safe to embed in untrusted contexts. It\'s designed for use in client-side JavaScript. ### Authentication using request header The preferred way to authenticate with the API is by adding an `Authorization` header containing your access token to your requests. The value of the `Authorization` header must be your access token. Manage personal access tokens from the [**Authorization**](https://app.launchdarkly.com/settings/authorization) page. ### Authentication using session cookie For testing purposes, you can make API calls directly from your web browser. If you are logged in to the LaunchDarkly application, the API will use your existing session to authenticate calls. Depending on the permissions granted as part of your [role](https://launchdarkly.com/docs/home/account/roles), you may not have permission to perform some API calls. You will receive a `401` response code in that case. > ### Modifying the Origin header causes an error > > LaunchDarkly validates that the Origin header for any API request authenticated by a session cookie matches the expected Origin header. The expected Origin header is `https://app.launchdarkly.com`. > > If the Origin header does not match what\'s expected, LaunchDarkly returns an error. This error can prevent the LaunchDarkly app from working correctly. > > Any browser extension that intentionally changes the Origin header can cause this problem. For example, Cross-Origin Resource Sharing (CORS) extensions used during development can modify the Origin header and cause the app to fail. > > To prevent this error, do not modify your Origin header. > > LaunchDarkly does not require origin matching when authenticating with an access token, so this issue does not affect normal API usage. ## Representations All resources expect and return JSON response bodies. Error responses also send a JSON body. To learn more about the error format of the API, read [Errors](https://launchdarkly.com/docs/api#errors). In practice this means that you always get a response with a `Content-Type` header set to `application/json`. In addition, request bodies for `PATCH`, `POST`, and `PUT` requests must be encoded as JSON with a `Content-Type` header set to `application/json`. Unless an endpoint\'s documentation says otherwise, the API ignores request body fields that are not part of that endpoint\'s request schema, and does not return an error for them. A successful response does not mean that every field you sent was applied. To confirm the result, check the response body. ### Summary and detailed representations When you fetch a list of resources, the response includes only the most important attributes of each resource. This is a _summary representation_ of the resource. When you fetch an individual resource, such as a single feature flag, you receive a _detailed representation_ of the resource. The best way to find a detailed representation is to follow links. Every summary representation includes a link to its detailed representation. ### Expanding responses Sometimes the detailed representation of a resource does not include all of the attributes of the resource by default. If this is the case, the request method will clearly document this and describe which attributes you can include in an expanded response. To include the additional attributes, append the `expand` request parameter to your request and add a comma-separated list of the attributes to include. For example, when you append `?expand=members,maintainers` to the [Get team](https://launchdarkly.com/docs/api/teams/get-team) endpoint, the expanded response includes both of these attributes. ### Links and addressability The best way to navigate the API is by following links. These are attributes in representations that link to other resources. The API always uses the same format for links: - Links to other resources within the API are encapsulated in a `_links` object - If the resource has a corresponding link to HTML content on the site, it is stored in a special `_site` link Each link has two attributes: - An `href`, which contains the URL - A `type`, which describes the content type For example, a feature resource might return the following: ```json { \"_links\": { \"parent\": { \"href\": \"/api/features\", \"type\": \"application/json\" }, \"self\": { \"href\": \"/api/features/sort.order\", \"type\": \"application/json\" } }, \"_site\": { \"href\": \"/features/sort.order\", \"type\": \"text/html\" } } ``` From this, you can navigate to the parent collection of features by following the `parent` link, or navigate to the site page for the feature by following the `_site` link. Collections are always represented as a JSON object with an `items` attribute containing an array of representations. Like all other representations, collections have `_links` defined at the top level. Paginated collections include `first`, `last`, `next`, and `prev` links containing a URL with the respective set of elements in the collection. ## Updates Resources that accept partial updates use the `PATCH` verb. Most resources support the [JSON patch](https://launchdarkly.com/docs/api#updates-using-json-patch) format. Some resources also support the [JSON merge patch](https://launchdarkly.com/docs/api#updates-using-json-merge-patch) format, and some resources support the [semantic patch](https://launchdarkly.com/docs/api#updates-using-semantic-patch) format, which is a way to specify the modifications to perform as a set of executable instructions. Each resource supports optional [comments](https://launchdarkly.com/docs/api#updates-with-comments) that you can submit with updates. Comments appear in outgoing webhooks, the audit log, and other integrations. When a resource supports both JSON patch and semantic patch, we document both in the request method. However, the specific request body fields and descriptions included in our documentation only match one type of patch or the other. ### Updates using JSON patch [JSON patch](https://datatracker.ietf.org/doc/html/rfc6902) is a way to specify the modifications to perform on a resource. JSON patch uses paths and a limited set of operations to describe how to transform the current state of the resource into a new state. JSON patch documents are always arrays, where each element contains an operation, a path to the field to update, and the new value. For example, in this feature flag representation: ```json { \"name\": \"New recommendations engine\", \"key\": \"engine.enable\", \"description\": \"This is the description\", ... } ``` You can change the feature flag\'s description with the following patch document: ```json [{ \"op\": \"replace\", \"path\": \"/description\", \"value\": \"This is the new description\" }] ``` You can specify multiple modifications to perform in a single request. You can also test that certain preconditions are met before applying the patch: ```json [ { \"op\": \"test\", \"path\": \"/version\", \"value\": 10 }, { \"op\": \"replace\", \"path\": \"/description\", \"value\": \"The new description\" } ] ``` The above patch request tests whether the feature flag\'s `version` is `10`, and if so, changes the feature flag\'s description. Attributes that are not editable, such as a resource\'s `_links`, have names that start with an underscore. ### Updates using JSON merge patch [JSON merge patch](https://datatracker.ietf.org/doc/html/rfc7386) is another format for specifying the modifications to perform on a resource. JSON merge patch is less expressive than JSON patch. However, in many cases it is simpler to construct a merge patch document. For example, you can change a feature flag\'s description with the following merge patch document: ```json { \"description\": \"New flag description\" } ``` ### Updates using semantic patch Some resources support the semantic patch format. A semantic patch is a way to specify the modifications to perform on a resource as a set of executable instructions. Semantic patch allows you to be explicit about intent using precise, custom instructions. In many cases, you can define semantic patch instructions independently of the current state of the resource. This can be useful when defining a change that may be applied at a future date. To make a semantic patch request, you must append `domain-model=launchdarkly.semanticpatch` to your `Content-Type` header. Here\'s how: ``` Content-Type: application/json; domain-model=launchdarkly.semanticpatch ``` If you call a semantic patch resource without this header, you will receive a `400` response because your semantic patch will be interpreted as a JSON patch. The body of a semantic patch request takes the following properties: * `comment` (string): (Optional) A description of the update. * `environmentKey` (string): (Required for some resources only) The environment key. * `instructions` (array): (Required) A list of actions the update should perform. Each action in the list must be an object with a `kind` property that indicates the instruction. If the instruction requires parameters, you must include those parameters as additional fields in the object. The documentation for each resource that supports semantic patch includes the available instructions and any additional parameters. For example: ```json { \"comment\": \"optional comment\", \"instructions\": [ {\"kind\": \"turnFlagOn\"} ] } ``` Semantic patches are not applied partially; either all of the instructions are applied or none of them are. If **any** instruction is invalid, the endpoint returns an error and will not change the resource. If all instructions are valid, the request succeeds and the resources are updated if necessary, or left unchanged if they are already in the state you request. ### Updates with comments You can submit optional comments with `PATCH` changes. To submit a comment along with a JSON patch document, use the following format: ```json { \"comment\": \"This is a comment string\", \"patch\": [{ \"op\": \"replace\", \"path\": \"/description\", \"value\": \"The new description\" }] } ``` To submit a comment along with a JSON merge patch document, use the following format: ```json { \"comment\": \"This is a comment string\", \"merge\": { \"description\": \"New flag description\" } } ``` To submit a comment along with a semantic patch, use the following format: ```json { \"comment\": \"This is a comment string\", \"instructions\": [ {\"kind\": \"turnFlagOn\"} ] } ``` ## Errors The API always returns errors in a common format. Here\'s an example: ```json { \"code\": \"invalid_request\", \"message\": \"A feature with that key already exists\", \"id\": \"30ce6058-87da-11e4-b116-123b93f75cba\" } ``` The `code` indicates the general class of error. The `message` is a human-readable explanation of what went wrong. The `id` is a unique identifier. Use it when you\'re working with LaunchDarkly Support to debug a problem with a specific API call. ### HTTP status error response codes | Code | Definition | Description | Possible Solution | | ---- | ----------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | 400 | Invalid request | The request cannot be understood. | Ensure JSON syntax in request body is correct. | | 401 | Invalid access token | Requestor is unauthorized or does not have permission for this API call. | Ensure your API access token is valid and has the appropriate permissions. | | 403 | Forbidden | Requestor does not have access to this resource. | Ensure that the account member or access token has proper permissions set. | | 404 | Invalid resource identifier | The requested resource is not valid. | Ensure that the resource is correctly identified by ID or key. | | 405 | Method not allowed | The request method is not allowed on this resource. | Ensure that the HTTP verb is correct. | | 409 | Conflict | The API request can not be completed because it conflicts with a concurrent API request. | Retry your request. | | 422 | Unprocessable entity | The API request can not be completed because the update description can not be understood. | Ensure that the request body is correct for the type of patch you are using, either JSON patch or semantic patch. | 429 | Too many requests | Read [Rate limiting](https://launchdarkly.com/docs/api#rate-limiting). | Wait and try again later. | ## CORS The LaunchDarkly API supports Cross Origin Resource Sharing (CORS) for AJAX requests from any origin. If an `Origin` header is given in a request, it will be echoed as an explicitly allowed origin. Otherwise the request returns a wildcard, `Access-Control-Allow-Origin: *`. For more information on CORS, read the [CORS W3C Recommendation](http://www.w3.org/TR/cors). Example CORS headers might look like: ```http Access-Control-Allow-Headers: Accept, Content-Type, Content-Length, Accept-Encoding, Authorization Access-Control-Allow-Methods: OPTIONS, GET, DELETE, PATCH Access-Control-Allow-Origin: * Access-Control-Max-Age: 300 ``` You can make authenticated CORS calls just as you would make same-origin calls, using either [token or session-based authentication](https://launchdarkly.com/docs/api#authentication). If you are using session authentication, you should set the `withCredentials` property for your `xhr` request to `true`. You should never expose your access tokens to untrusted entities. ## Rate limiting We use several rate-limiting strategies to ensure the availability of our APIs. Rate-limited calls to our APIs return a `429` status code and include headers to indicate the current rate limit status. The specific headers returned depend on the API route that was called. Limits differ based on the route, authentication mechanism, and other factors. Each set of headers below appears only when the corresponding limit is being enforced for your call. A given route may be subject to any combination of these limits, so a response can include one, several, or none of these headers. A missing header indicates that the limit was not applied to this specific call; it does not necessarily indicate that the limit does not exist. To reduce usage before hitting a `429` status, program against whichever rate limit headers are present rather than expecting a specific header. We do not publicly document the specific number of calls permitted by any of these limits, and these limits may change. We encourage clients to program against the specification and rely on the headers described below, rather than hardcoding the current limits. > ### Rate limiting and SDKs > > LaunchDarkly SDKs are never rate limited and do not use the API endpoints defined here. LaunchDarkly uses a different set of approaches, including streaming/server-sent events and a global CDN, to ensure availability to the routes used by LaunchDarkly SDKs. ### Global rate limits Authenticated requests are subject to a global limit. This is the maximum number of calls that your account can make to the API per ten seconds. All service and personal access tokens on the account share this limit, so exceeding the limit with one access token will impact other tokens. Calls that are subject to global rate limits may return the headers below: | Header name | Description | | ------------------------------ | -------------------------------------------------------------------------------- | | `X-Ratelimit-Global-Limit` | The maximum number of requests the account is permitted to make per ten seconds. | | `X-Ratelimit-Global-Remaining` | The number of requests remaining in the current global rate limit window. | | `X-Ratelimit-Reset` | The time at which the current rate limit window resets in epoch milliseconds. | ### Route-level rate limits Some authenticated routes have custom rate limits. These also reset every ten seconds. Any service or personal access tokens hitting the same route share this limit, so exceeding the limit with one access token may impact other tokens. Calls that are subject to route-level rate limits return the headers below: | Header name | Description | | ----------------------------- | ----------------------------------------------------------------------------------------------------- | | `X-Ratelimit-Route-Limit` | The maximum number of requests to the current route permitted per ten seconds. | | `X-Ratelimit-Route-Remaining` | The number of requests remaining for the current route in the current rate limit window. | | `X-Ratelimit-Reset` | The time at which the current rate limit window resets in epoch milliseconds. | A _route_ represents a specific URL pattern and verb. For example, the [Delete environment](https://launchdarkly.com/docs/api/environments/delete-environment) endpoint is considered a single route, and each call to delete an environment counts against your route-level rate limit for that route. ### Access token rate limits Some calls are rate limited per access token. Unlike the global and route-level limits, this limit applies to a single service or personal access token on its own. Exceeding a limit with one access token does not affect other tokens on the account. Calls that are subject to access token rate limits return these headers: | Header name | Description | | ---------------------------------- | --------------------------------------------------------------------------------------- | | `X-Ratelimit-Auth-Token-Limit` | The maximum number of requests the access token can make per ten seconds. | | `X-Ratelimit-Auth-Token-Remaining` | The number of requests remaining for the access token in the current rate limit window. | | `X-Ratelimit-Auth-Token-Reset` | The time at which the current rate limit window resets in epoch milliseconds. | Unlike the other rate limits, access token rate limits report their own reset time in the `X-Ratelimit-Auth-Token-Reset` header instead of in `X-Ratelimit-Reset`. ### IP-based rate limiting We also employ IP-based rate limiting on some API routes. If you hit an IP-based rate limit, your API response will include a `Retry-After` header indicating how long to wait before re-trying the call. Clients must wait at least `Retry-After` seconds before making additional calls to our API, and should employ jitter and backoff strategies to avoid triggering rate limits again. ## OpenAPI (Swagger) and client libraries We have a [complete OpenAPI (Swagger) specification](https://app.launchdarkly.com/api/v2/openapi.json) for our API. We auto-generate multiple client libraries based on our OpenAPI specification. To learn more, visit the [collection of client libraries on GitHub](https://github.com/search?q=topic%3Alaunchdarkly-api+org%3Alaunchdarkly&type=Repositories). Alternatively, you can use the specification to generate client libraries to interact with our REST API in your language of choice. Or, you can refer to our API endpoints\' documentation for guidance on how to make requests with a common HTTP library in your language of choice. Our OpenAPI specification is supported by several API-based tools such as Postman and Insomnia. In many cases, you can directly import our specification to explore our APIs. ## Method overriding Some firewalls and HTTP clients restrict the use of verbs other than `GET` and `POST`. In those environments, our API endpoints that use `DELETE`, `PATCH`, and `PUT` verbs are inaccessible. To avoid this issue, our API supports the `X-HTTP-Method-Override` header, allowing clients to \"tunnel\" `DELETE`, `PATCH`, and `PUT` requests using a `POST` request. For example, to call a `PATCH` endpoint using a `POST` request, you can include `X-HTTP-Method-Override:PATCH` as a header. ## Beta resources We sometimes release new API resources in **beta** status before we release them with general availability. Resources that are in beta are still undergoing testing and development. They may change without notice, including becoming backwards incompatible. We try to promote resources into general availability as quickly as possible. This happens after sufficient testing and when we\'re satisfied that we no longer need to make backwards-incompatible changes. We mark beta resources with a \"Beta\" callout in our documentation, pictured below: > ### This feature is in beta > > To use this feature, pass in a header including the `LD-API-Version` key with value set to `beta`. Use this header with each call. To learn more, read [Beta resources](https://launchdarkly.com/docs/api#beta-resources). > > Resources that are in beta are still undergoing testing and development. They may change without notice, including becoming backwards incompatible. ### Using beta resources To use a beta resource, you must include a header in the request. If you call a beta resource without this header, you receive a `403` response. Use this header: ``` LD-API-Version: beta ``` ## Federal and EU environments In addition to the commercial versions, LaunchDarkly offers instances for federal agencies and those based in the European Union (EU). ### Federal environments The version of LaunchDarkly that is available on domains controlled by the United States government is different from the version of LaunchDarkly available to the general public. If you are an employee or contractor for a United States federal agency and use LaunchDarkly in your work, you likely use the federal instance of LaunchDarkly. If you are working in the federal instance of LaunchDarkly, the base URI for each request is `https://app.launchdarkly.us`. To learn more, read [LaunchDarkly in federal environments](https://launchdarkly.com/docs/home/infrastructure/federal). ### EU environments The version of LaunchDarkly that is available in the EU is different from the version of LaunchDarkly available to other regions. If you are based in the EU, you likely use the EU instance of LaunchDarkly. The LaunchDarkly EU instance complies with EU data residency principles, including the protection and confidentiality of EU customer information. If you are working in the EU instance of LaunchDarkly, the base URI for each request is `https://app.eu.launchdarkly.com`. To learn more, read [LaunchDarkly in the European Union (EU)](https://launchdarkly.com/docs/home/infrastructure/eu). ## Versioning We try hard to keep our REST API backwards compatible, but we occasionally have to make backwards-incompatible changes in the process of shipping new features. These breaking changes can cause unexpected behavior if you don\'t prepare for them accordingly. Updates to our REST API include support for the latest features in LaunchDarkly. We also release a new version of our REST API every time we make a breaking change. We provide simultaneous support for multiple API versions so you can migrate from your current API version to a new version at your own pace. ### Setting the API version per request You can set the API version on a specific request by sending an `LD-API-Version` header, as shown in the example below: ``` LD-API-Version: 20240415 ``` The header value is the version number of the API version you would like to request. The number for each version corresponds to the date the version was released in `yyyymmdd` format. In the example above the version `20240415` corresponds to April 15, 2024. ### Setting the API version per access token When you create an access token, you must specify a specific version of the API to use. This ensures that integrations using this token cannot be broken by version changes. Tokens created before versioning was released have their version set to `20160426`, which is the version of the API that existed before the current versioning scheme, so that they continue working the same way they did before versioning. If you would like to upgrade your integration to use a new API version, you can explicitly set the header described above. > ### Best practice: Set the header for every client or integration > > We recommend that you set the API version header explicitly in any client or integration you build. > > Only rely on the access token API version during manual testing. ### API version changelog | Version | Changes | End of life (EOL) |
| `20240415` | - Changed several endpoints from unpaginated to paginated. Use the `limit` and `offset` query parameters to page through the results.
- Changed the [list access tokens](https://launchdarkly.com/docs/api/access-tokens/get-tokens) endpoint:
- Response is now paginated with a default limit of `25`
- Changed the [list account members](https://launchdarkly.com/docs/api/account-members/get-members) endpoint:
- The `accessCheck` filter is no longer available
- Changed the [list custom roles](https://launchdarkly.com/docs/api/custom-roles/get-custom-roles) endpoint:
- Response is now paginated with a default limit of `20`
- Changed the [list feature flags](https://launchdarkly.com/docs/api/feature-flags/get-feature-flags) endpoint:
- Response is now paginated with a default limit of `20`
- The `environments` field is now only returned if the request is filtered by environment, using the `filterEnv` query parameter
- The `followerId`, `hasDataExport`, `status`, `contextKindTargeted`, and `segmentTargeted` filters are no longer available
- The `compare` query parameter is no longer available
- Changed the [list segments](https://launchdarkly.com/docs/api/segments/get-segments) endpoint:
- Response is now paginated with a default limit of `20`
- Changed the [list teams](https://launchdarkly.com/docs/api/teams/get-teams) endpoint:
- The `expand` parameter no longer supports including `projects` or `roles`
- In paginated results, the maximum page size is now 100
- Changed the [get workflows](https://launchdarkly.com/docs/api/workflows/get-workflows) endpoint:
- Response is now paginated with a default limit of `20`
- The `_conflicts` field in the response is no longer available
| Current |
| `20220603` | - Changed the [list projects](https://launchdarkly.com/docs/api/projects/get-projects) return value:
- Response is now paginated with a default limit of `20`.
- Added support for filter and sort.
- The project `environments` field is now expandable. This field is omitted by default.
- Changed the [get project](https://launchdarkly.com/docs/api/projects/get-project) return value:
- The `environments` field is now expandable. This field is omitted by default.
| 2025-04-15 |
| `20210729` | - Changed the [create approval request](https://launchdarkly.com/docs/api/approvals/post-approval-request) return value. It now returns HTTP Status Code `201` instead of `200`.
- Changed the [get user](https://launchdarkly.com/docs/api/users/get-user) return value. It now returns a user record, not a user.
- Added additional optional fields to environment, segments, flags, members, and segments, including the ability to create big segments.
- Added default values for flag variations when new environments are created.
- Added filtering and pagination for getting flags and members, including `limit`, `number`, `filter`, and `sort` query parameters.
- Added endpoints for expiring user targets for flags and segments, scheduled changes, access tokens, Relay Proxy configuration, integrations and subscriptions, and approvals.
| 2023-06-03 |
| `20191212` | - [List feature flags](https://launchdarkly.com/docs/api/feature-flags/get-feature-flags) now defaults to sending summaries of feature flag configurations, equivalent to setting the query parameter `summary=true`. Summaries omit flag targeting rules and individual user targets from the payload.
- Added endpoints for flags, flag status, projects, environments, audit logs, members, users, custom roles, segments, usage, streams, events, and data export.
| 2022-07-29 |
| `20160426` | - Initial versioning of API. Tokens created before versioning have their version set to this.
| 2020-12-12 |
To learn more about how EOL is determined, read LaunchDarkly\'s [End of Life (EOL) Policy](https://launchdarkly.com/policies/end-of-life-policy/).
*
* The version of the OpenAPI document: 2.0
* Contact: support@launchdarkly.com
@@ -26,13 +26,35 @@ import { BASE_PATH, COLLECTION_FORMATS, BaseAPI, RequiredError, operationServerM
export interface AIConfig {
'_access'?: AiConfigsAccess;
'_links'?: ParentAndSelfLinks;
+ '_site'?: CoreLink;
+ /**
+ * A description of the AI Config
+ */
'description': string;
+ /**
+ * The AI Config key
+ */
'key': string;
'_maintainer'?: AIConfigMaintainer;
+ /**
+ * The AI Config mode
+ */
'mode'?: AIConfigModeEnum;
+ /**
+ * The AI Config name
+ */
'name': string;
+ /**
+ * Tags for this resource
+ */
'tags': Array;
+ /**
+ * The version number of this resource
+ */
'version': number;
+ /**
+ * The variations of this AI Config
+ */
'variations': Array;
'createdAt': number;
'updatedAt': number;
@@ -85,14 +107,34 @@ export type AIConfigDependencyTypeEnum = typeof AIConfigDependencyTypeEnum[keyof
/**
* @type AIConfigMaintainer
+ * The member or team that maintains this resource
*/
export type AIConfigMaintainer = AiConfigsMaintainerTeam | MaintainerMember;
export interface AIConfigPatch {
+ /**
+ * Key of the variation this config serves by default
+ */
+ 'defaultVariationKey'?: string;
+ /**
+ * A description of the AI Config
+ */
'description'?: string;
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * A human-readable name for the AI Config
+ */
'name'?: string;
+ /**
+ * Tags for this resource
+ */
'tags'?: Array;
/**
* Evaluation metric key for this config
@@ -104,13 +146,37 @@ export interface AIConfigPatch {
'isInverted'?: boolean;
}
export interface AIConfigPost {
+ /**
+ * A description of the AI Config
+ */
'description'?: string;
+ /**
+ * A unique key for the AI Config
+ */
'key': string;
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * The AI Config mode
+ */
'mode'?: AIConfigPostModeEnum;
+ /**
+ * A human-readable name for the AI Config
+ */
'name': string;
+ /**
+ * Tags for this resource
+ */
'tags'?: Array;
+ /**
+ * Keys of the views to add the AI Config to
+ */
'viewKeys'?: Array;
'defaultVariation'?: AIConfigVariationPost;
/**
@@ -147,87 +213,230 @@ export interface AIConfigTargeting {
*/
'createdAt': number;
'defaults'?: AIConfigTargetingDefaults;
+ /**
+ * Targeting for each environment, keyed by environment key
+ */
'environments': { [key: string]: AIConfigTargetingEnvironment; };
'experiments': AiConfigsExperimentInfoRep;
+ /**
+ * The AI Config key
+ */
'key': string;
+ /**
+ * The AI Config name
+ */
'name': string;
+ /**
+ * Tags for this resource
+ */
'tags': Array;
+ /**
+ * The variations of this AI Config
+ */
'variations': Array;
+ /**
+ * The version number of this resource
+ */
'_version': number;
}
export interface AIConfigTargetingDefaults {
+ /**
+ * Index of the variation served when targeting is on
+ */
'onVariation': number;
+ /**
+ * Index of the variation served when targeting is off
+ */
'offVariation': number;
}
export interface AIConfigTargetingEnvironment {
+ /**
+ * Individual context targets for non-user context kinds
+ */
'contextTargets': Array;
+ /**
+ * Whether targeting is on in this environment
+ */
'enabled': boolean;
'fallthrough': AIConfigTargetingEnvironmentFallthrough;
'lastModified': number;
+ /**
+ * Index of the variation served when targeting is off
+ */
'offVariation'?: number;
+ /**
+ * The targeting rules
+ */
'rules': Array;
+ /**
+ * Individual user targets
+ */
'targets': Array;
+ /**
+ * Whether to send detailed events for all evaluations
+ */
'trackEvents': boolean;
+ /**
+ * Whether to send detailed events for evaluations that fall through to the default rule
+ */
'trackEventsFallthrough': boolean;
+ /**
+ * The environment name
+ */
'_environmentName': string;
+ /**
+ * The version of the targeting in this environment
+ */
'_version': number;
}
export interface AIConfigTargetingEnvironmentFallthrough {
+ /**
+ * Index of the variation served by the default rule
+ */
'variation'?: number;
'rollout'?: AIConfigTargetingEnvironmentFallthroughRollout;
}
export interface AIConfigTargetingEnvironmentFallthroughRollout {
+ /**
+ * The context attribute used to bucket contexts
+ */
'bucketBy'?: string;
+ /**
+ * The context kind used to bucket contexts
+ */
'contextKind': string;
'experimentAllocation'?: AIConfigTargetingEnvironmentFallthroughRolloutExperimentationAllocation;
+ /**
+ * The seed used for bucketing
+ */
'seed'?: number;
+ /**
+ * The variations and their weights
+ */
'variations': Array;
}
export interface AIConfigTargetingEnvironmentFallthroughRolloutExperimentationAllocation {
+ /**
+ * Whether contexts can be reassigned to new buckets
+ */
'canReshuffle': boolean;
+ /**
+ * Index of the default variation
+ */
'defaultVariation': number;
+ /**
+ * The allocation type
+ */
'type': string;
}
export interface AIConfigTargetingEnvironmentFallthroughRolloutVariation {
+ /**
+ * Whether this variation is excluded from experiment tracking
+ */
'_untracked'?: boolean;
+ /**
+ * Index of the variation
+ */
'variation': number;
+ /**
+ * The weight of this variation, in thousandths of a percent
+ */
'weight': number;
}
export interface AIConfigTargetingEnvironmentRule {
+ /**
+ * The clauses a context must match
+ */
'clauses': Array;
+ /**
+ * Whether to send detailed events for evaluations that match this rule
+ */
'trackEvents': boolean;
}
export interface AIConfigTargetingEnvironmentRuleClause {
+ /**
+ * The context attribute to match
+ */
'attribute': string;
+ /**
+ * The clause ID
+ */
'id': string;
+ /**
+ * Whether to negate the match
+ */
'negate': boolean;
+ /**
+ * The operator to use
+ */
'op': string;
+ /**
+ * The values to match against
+ */
'values': Array;
}
export interface AIConfigTargetingEnvironmentTarget {
+ /**
+ * The context kind
+ */
'contextKind': string;
+ /**
+ * The context keys to target
+ */
'values': Array;
+ /**
+ * Index of the variation to serve
+ */
'variation': number;
}
export interface AIConfigTargetingPatch {
+ /**
+ * A comment describing the change
+ */
'comment'?: string;
+ /**
+ * The environment key
+ */
'environmentKey': string;
+ /**
+ * The semantic patch instructions to apply
+ */
'instructions': Array<{ [key: string]: any; }>;
}
export interface AIConfigTargetingVariation {
+ /**
+ * The variation ID
+ */
'_id': string;
+ /**
+ * A description of the variation
+ */
'description': string;
+ /**
+ * The variation name
+ */
'name': string;
'value': AIConfigTargetingVariationValue;
}
/**
* @type AIConfigTargetingVariationValue
+ * The variation value
*/
export type AIConfigTargetingVariationValue = boolean | number | object | string;
export interface AIConfigVariation {
'_links'?: ParentLink;
+ /**
+ * The color used for this variation in the UI
+ */
'color'?: string;
+ /**
+ * Classifier rules for a judge variation. When this array is non-empty, messages must be empty.
+ */
+ 'classifiers'?: Array;
+ /**
+ * A comment describing this version of the variation
+ */
'comment'?: string;
/**
* Returns the description for the agent. This is only returned for agent variations.
@@ -237,27 +446,76 @@ export interface AIConfigVariation {
* Returns the instructions for the agent. This is only returned for agent variations.
*/
'instructions'?: string;
+ /**
+ * The variation key
+ */
'key': string;
+ /**
+ * The variation ID
+ */
'_id': string;
+ /**
+ * The prompt messages for this variation
+ */
'messages'?: Array;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'model': object;
+ /**
+ * The key of the model config that this variation uses, not the provider model ID. Absent when the variation does not use a model config.
+ */
'modelConfigKey'?: string;
+ /**
+ * The version of the model config that this variation is pinned to, when it references a custom model config. Absent when the variation does not reference a model config, when the variation is not pinned to a specific version, or when custom model config versioning is not enabled for the project.
+ */
+ 'modelConfigVersion'?: number;
+ /**
+ * The variation name
+ */
'name': string;
/**
* JSON Schema defining the structured output format for the variation.
*/
'outputFormat'?: { [key: string]: any; };
'createdAt': number;
+ /**
+ * The version number of this resource
+ */
'version': number;
- 'state'?: string;
+ /**
+ * The state of the variation. - `archived`: The variation is archived. To restore it, update the variation with `state` set to `published`. - `published`: The variation is active.
+ */
+ 'state'?: AIConfigVariationStateEnum;
'_archivedAt'?: number;
'_publishedAt'?: number;
+ /**
+ * The tools this variation can use
+ */
'tools'?: Array;
+ /**
+ * The agent skills this variation can use
+ */
'skills'?: Array;
'judgeConfiguration'?: JudgeConfiguration;
+ /**
+ * Keys of the judge AI Configs attached to this variation
+ */
'judgingConfigKeys'?: Array;
}
+
+export const AIConfigVariationStateEnum = {
+ Archived: 'archived',
+ Published: 'published'
+} as const;
+
+export type AIConfigVariationStateEnum = typeof AIConfigVariationStateEnum[keyof typeof AIConfigVariationStateEnum];
+
export interface AIConfigVariationPatch {
+ /**
+ * Replaces classifier rules on a judge variation. An empty array clears them. When this array is non-empty, messages must be empty.
+ */
+ 'classifiers'?: Array;
/**
* Human-readable description of what this patch changes
*/
@@ -270,19 +528,38 @@ export interface AIConfigVariationPatch {
* Instructions for agent when the config is in agent mode.
*/
'instructions'?: string;
+ /**
+ * The prompt messages for this variation
+ */
'messages'?: Array;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'model'?: object;
+ /**
+ * The key that GET /api/v2/projects/{projectKey}/ai-configs/model-configs returns for the model config. Do not use a custom model config\'s ID, which is the provider model ID.
+ */
'modelConfigKey'?: string;
+ /**
+ * The exact model config version to set this variation to. Requires modelConfigKey to be set (either in this patch or already on the variation), and the version must exist for that model config. When omitted, the variation keeps the version it is currently set to, unless the patch changes modelConfigKey, in which case the variation records the new model config\'s current (latest) version.
+ */
+ 'modelConfigVersion'?: number;
+ /**
+ * A human-readable name for the variation
+ */
'name'?: string;
/**
* JSON Schema defining the structured output format for the variation.
*/
'outputFormat'?: { [key: string]: any; };
+ /**
+ * Whether to publish this version of the variation
+ */
'published'?: boolean;
/**
- * One of \'archived\', \'published\'
+ * The state to move the variation to. Omit this field to keep the current state. - `archived`: Archive a published variation. You cannot archive a variation that is already archived. You also cannot archive the only variation of an AI Config. An AI Config itself cannot be archived. - `published`: Restore an archived variation. You cannot publish a variation that is already published.
*/
- 'state'?: string;
+ 'state'?: AIConfigVariationPatchStateEnum;
/**
* List of tools to use for this variation. The latest version of the tool will be used.
*/
@@ -297,7 +574,19 @@ export interface AIConfigVariationPatch {
'skills'?: Array;
'judgeConfiguration'?: JudgeConfiguration;
}
+
+export const AIConfigVariationPatchStateEnum = {
+ Archived: 'archived',
+ Published: 'published'
+} as const;
+
+export type AIConfigVariationPatchStateEnum = typeof AIConfigVariationPatchStateEnum[keyof typeof AIConfigVariationPatchStateEnum];
+
export interface AIConfigVariationPost {
+ /**
+ * Classifier rules for a judge variation. When this array is non-empty, messages must be empty.
+ */
+ 'classifiers'?: Array;
/**
* Human-readable description of this variation
*/
@@ -310,11 +599,30 @@ export interface AIConfigVariationPost {
* Returns the instructions for the agent. This is only returned for agent variations.
*/
'instructions'?: string;
+ /**
+ * A unique key for the variation
+ */
'key': string;
+ /**
+ * The prompt messages for this variation
+ */
'messages'?: Array;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'model'?: object;
+ /**
+ * A human-readable name for the variation
+ */
'name': string;
+ /**
+ * The key that GET /api/v2/projects/{projectKey}/ai-configs/model-configs returns for the model config. Do not use a custom model config\'s ID, which is the provider model ID.
+ */
'modelConfigKey'?: string;
+ /**
+ * The exact model config version to set this variation to. Requires modelConfigKey to be set, and the version must exist for that model config. When omitted, the variation records the model config\'s current (latest) version.
+ */
+ 'modelConfigVersion'?: number;
/**
* JSON Schema defining the structured output format for the variation.
*/
@@ -334,22 +642,41 @@ export interface AIConfigVariationPost {
'judgeConfiguration'?: JudgeConfiguration;
}
export interface AIConfigVariationsResponse {
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface AIConfigs {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface AIConfigsSummary {
'count': number;
}
export interface AITool {
+ /**
+ * The tool key
+ */
'key': string;
'_access'?: AiConfigsAccess;
'_links'?: ParentAndSelfLinks;
+ '_site'?: CoreLink;
'_maintainer'?: AIConfigMaintainer;
+ /**
+ * A description of the tool
+ */
'description'?: string;
/**
* JSON Schema defining the tool\'s parameters for LLM consumption
@@ -359,13 +686,28 @@ export interface AITool {
* Custom metadata and configuration for application-level use (not sent to LLM)
*/
'customParameters'?: object;
+ /**
+ * Tags for the tool. Tags can be used in custom role policies.
+ */
'tags'?: Array;
+ /**
+ * Version of the tool. Starts at 1, and each update that changes the description, schema, custom parameters, or tags creates a new version. Pass this value with `key` in a variation\'s `tools: [{key, version}]`.
+ */
'version': number;
'createdAt': number;
}
export interface AIToolPatch {
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * A description of the tool
+ */
'description'?: string;
/**
* JSON Schema defining the tool\'s parameters for LLM consumption
@@ -375,12 +717,27 @@ export interface AIToolPatch {
* Custom metadata and configuration for application-level use (not sent to LLM)
*/
'customParameters'?: object;
+ /**
+ * Replaces the tags on the tool. Tags can be used in custom role policies.
+ */
'tags'?: Array;
}
export interface AIToolPost {
+ /**
+ * A unique key for the tool
+ */
'key': string;
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * A description of the tool
+ */
'description'?: string;
/**
* JSON Schema defining the tool\'s parameters for LLM consumption
@@ -390,11 +747,20 @@ export interface AIToolPost {
* Custom metadata and configuration for application-level use (not sent to LLM)
*/
'customParameters'?: object;
+ /**
+ * Tags for the tool. Tags can be used in custom role policies.
+ */
'tags'?: Array;
}
export interface AITools {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface Access {
@@ -500,6 +866,7 @@ export interface AccessTokenPost {
* The default API version for this token
*/
'defaultApiVersion'?: number;
+ 'expiry'?: number;
}
export const AccessTokenPostRoleEnum = {
@@ -523,11 +890,65 @@ export interface ActionOutput {
'kind': string;
'instructions': Array<{ [key: string]: any; }>;
}
+export interface AdaptiveTrigger {
+ 'id': string;
+ 'name': string;
+ 'resourceKind': AdaptiveTriggerResourceKind;
+ 'resourceKey': string;
+ 'enabled': boolean;
+ 'triggerSource': ObservabilityAlertSource;
+ 'task': AdaptiveTriggerTask;
+ 'createdAt': number;
+ 'updatedAt': number;
+}
+
+
+export interface AdaptiveTriggerInstruction {
+ 'kind': AdaptiveTriggerInstructionKindEnum;
+ 'variationId': string;
+ /**
+ * The targeting rule this adaptive trigger acts on. Required for updateRuleVariationOrRollout instructions.
+ */
+ 'ruleId'?: string;
+}
+
+export const AdaptiveTriggerInstructionKindEnum = {
+ UpdateFallthroughVariationOrRollout: 'updateFallthroughVariationOrRollout',
+ UpdateRuleVariationOrRollout: 'updateRuleVariationOrRollout'
+} as const;
+
+export type AdaptiveTriggerInstructionKindEnum = typeof AdaptiveTriggerInstructionKindEnum[keyof typeof AdaptiveTriggerInstructionKindEnum];
+
+
+export const AdaptiveTriggerResourceKind = {
+ Flag: 'flag',
+ AiConfig: 'ai-config'
+} as const;
+
+export type AdaptiveTriggerResourceKind = typeof AdaptiveTriggerResourceKind[keyof typeof AdaptiveTriggerResourceKind];
+
+
+export interface AdaptiveTriggerTask {
+ 'instructions': Array;
+}
+export interface AdaptiveTriggers {
+ '_links'?: AdaptiveTriggersPaginatedLinks;
+ 'items': Array;
+ 'totalCount': number;
+}
+export interface AdaptiveTriggersPaginatedLinks {
+ 'first'?: ExperimentationLink;
+ 'last'?: ExperimentationLink;
+ 'next'?: ExperimentationLink;
+ 'prev'?: ExperimentationLink;
+ 'self': ExperimentationLink;
+}
/**
* An agent graph representing a directed graph of configs
*/
export interface AgentGraph {
'_access'?: AiConfigsAccess;
+ '_site'?: CoreLink;
/**
* A unique key for the agent graph
*/
@@ -596,6 +1017,7 @@ export interface AgentGraphEdgePost {
}
/**
* @type AgentGraphMaintainer
+ * The member or team that maintains this agent graph
*/
export type AgentGraphMaintainer = AiConfigsMaintainerTeam | MaintainerMember;
@@ -666,100 +1088,331 @@ export interface AgentGraphPost {
*/
export interface AgentGraphs {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface AgentOptimization {
'_access'?: AiConfigsAccess;
'_links'?: ParentAndSelfLinks;
+ /**
+ * The agent optimization ID
+ */
'id': string;
+ /**
+ * The agent optimization key
+ */
'key': string;
+ /**
+ * The key of the AI Config to optimize
+ */
'aiConfigKey': string;
+ /**
+ * The maximum number of attempts
+ */
'maxAttempts': number;
+ /**
+ * The models to try
+ */
'modelChoices': Array;
+ /**
+ * The model used to judge responses
+ */
'judgeModel': string;
+ /**
+ * Sets of prompt variable values to try
+ */
'variableChoices': Array<{ [key: string]: any; }>;
+ /**
+ * Statements a response must satisfy to pass
+ */
'acceptanceStatements': Array;
+ /**
+ * Judges that score each response
+ */
'judges': Array;
+ /**
+ * User inputs to test with
+ */
'userInputOptions': Array;
+ /**
+ * Expected responses to compare against
+ */
'groundTruthResponses': Array;
+ /**
+ * The key of the metric to optimize
+ */
'metricKey'?: string;
+ /**
+ * The maximum number of tokens to use
+ */
'tokenLimit'?: number;
+ /**
+ * The key of the variation to start from
+ */
'variationKey'?: string;
+ /**
+ * A label for the optimization
+ */
'label'?: string;
+ /**
+ * Whether to optimize for lower latency
+ */
'latencyOptimization'?: boolean;
+ /**
+ * Whether to optimize for lower token use
+ */
'tokenOptimization'?: boolean;
+ /**
+ * Whether to save the best result as a new variation automatically
+ */
'autoCommit'?: boolean;
+ /**
+ * The version number of this resource
+ */
'version': number;
+ /**
+ * When this resource was created, in Unix milliseconds
+ */
'createdAt': number;
}
export interface AgentOptimizationAcceptanceStatement {
+ /**
+ * A statement the response must satisfy
+ */
'statement': string;
+ /**
+ * The minimum score needed to pass
+ */
'threshold': number;
}
export interface AgentOptimizationJudge {
+ /**
+ * The key of the judge AI Config
+ */
'key': string;
+ /**
+ * The minimum score needed to pass
+ */
'threshold': number;
}
export interface AgentOptimizationPatch {
+ /**
+ * The maximum number of attempts
+ */
'maxAttempts'?: number;
+ /**
+ * The models to try
+ */
'modelChoices'?: Array;
+ /**
+ * The model used to judge responses
+ */
'judgeModel'?: string;
+ /**
+ * Sets of prompt variable values to try
+ */
'variableChoices'?: Array<{ [key: string]: any; }>;
+ /**
+ * Statements a response must satisfy to pass
+ */
'acceptanceStatements'?: Array;
+ /**
+ * Judges that score each response
+ */
'judges'?: Array;
+ /**
+ * User inputs to test with
+ */
'userInputOptions'?: Array;
+ /**
+ * Expected responses to compare against
+ */
'groundTruthResponses'?: Array;
+ /**
+ * The key of the metric to optimize
+ */
'metricKey'?: string;
+ /**
+ * The maximum number of tokens to use
+ */
'tokenLimit'?: number;
+ /**
+ * The key of the variation to start from
+ */
'variationKey'?: string;
+ /**
+ * A label for the optimization
+ */
'label'?: string;
+ /**
+ * Whether to optimize for lower latency
+ */
'latencyOptimization'?: boolean;
+ /**
+ * Whether to optimize for lower token use
+ */
'tokenOptimization'?: boolean;
+ /**
+ * Whether to save the best result as a new variation automatically
+ */
'autoCommit'?: boolean;
}
export interface AgentOptimizationPost {
+ /**
+ * A unique key for the agent optimization
+ */
'key': string;
+ /**
+ * The key of the AI Config to optimize
+ */
'aiConfigKey': string;
+ /**
+ * The maximum number of attempts
+ */
'maxAttempts': number;
+ /**
+ * The models to try
+ */
'modelChoices'?: Array;
+ /**
+ * The model used to judge responses
+ */
'judgeModel': string;
+ /**
+ * Sets of prompt variable values to try
+ */
'variableChoices'?: Array<{ [key: string]: any; }>;
+ /**
+ * Statements a response must satisfy to pass
+ */
'acceptanceStatements'?: Array;
+ /**
+ * Judges that score each response
+ */
'judges'?: Array;
+ /**
+ * User inputs to test with
+ */
'userInputOptions'?: Array;
+ /**
+ * Expected responses to compare against
+ */
'groundTruthResponses'?: Array;
+ /**
+ * The key of the metric to optimize
+ */
'metricKey'?: string;
+ /**
+ * The maximum number of tokens to use
+ */
'tokenLimit'?: number;
+ /**
+ * The key of the variation to start from
+ */
'variationKey'?: string;
+ /**
+ * A label for the optimization
+ */
'label'?: string;
+ /**
+ * Whether to optimize for lower latency
+ */
'latencyOptimization'?: boolean;
+ /**
+ * Whether to optimize for lower token use
+ */
'tokenOptimization'?: boolean;
+ /**
+ * Whether to save the best result as a new variation automatically
+ */
'autoCommit'?: boolean;
}
export interface AgentOptimizationResult {
'_access'?: AiConfigsAccess;
'_links'?: ParentAndSelfLinks;
+ /**
+ * The result ID
+ */
'id': string;
+ /**
+ * The ID of the run this result belongs to
+ */
'runId': string;
+ /**
+ * The agent optimization ID
+ */
'agentOptimizationId': string;
+ /**
+ * The version of the agent optimization used
+ */
'agentOptimizationVersion': number;
'status': AgentOptimizationResultStatus;
'activity': AgentOptimizationResultActivity;
+ /**
+ * The iteration number within the run
+ */
'iteration': number;
+ /**
+ * The instructions used for this attempt
+ */
'instructions': string;
+ /**
+ * The model parameters used for this attempt
+ */
'parameters'?: { [key: string]: any; };
+ /**
+ * The user input used for this attempt
+ */
'userInput': string;
+ /**
+ * The model response
+ */
'completionResponse'?: string;
+ /**
+ * The variation that was tested
+ */
'variation'?: { [key: string]: any; };
+ /**
+ * The scores for the response
+ */
'scores'?: { [key: string]: any; };
+ /**
+ * Token usage for generating the response
+ */
'generationTokens'?: { [key: string]: any; };
+ /**
+ * Token usage for judging the response
+ */
'evaluationTokens'?: { [key: string]: any; };
+ /**
+ * How long the response took to generate
+ */
'generationLatency'?: number;
+ /**
+ * How long each evaluation took
+ */
'evaluationLatencies'?: { [key: string]: any; };
+ /**
+ * When this finished, in Unix milliseconds
+ */
'completedAt'?: number;
+ /**
+ * The key of the variation created from this result
+ */
'createdVariationKey'?: string;
+ /**
+ * When this resource was created, in Unix milliseconds
+ */
'createdAt': number;
+ /**
+ * When this resource was last updated, in Unix milliseconds
+ */
'updatedAt': number;
}
@@ -780,23 +1433,65 @@ export type AgentOptimizationResultActivity = typeof AgentOptimizationResultActi
export interface AgentOptimizationResultPatch {
'status'?: AgentOptimizationResultStatus;
'activity'?: AgentOptimizationResultActivity;
+ /**
+ * The model response
+ */
'completionResponse'?: string;
+ /**
+ * The variation that was tested
+ */
'variation'?: { [key: string]: any; };
+ /**
+ * The scores for the response
+ */
'scores'?: { [key: string]: any; };
+ /**
+ * Token usage for generating the response
+ */
'generationTokens'?: { [key: string]: any; };
+ /**
+ * Token usage for judging the response
+ */
'evaluationTokens'?: { [key: string]: any; };
+ /**
+ * How long the response took to generate
+ */
'generationLatency'?: number;
+ /**
+ * How long each evaluation took
+ */
'evaluationLatencies'?: { [key: string]: any; };
+ /**
+ * The key of the variation created from this result
+ */
'createdVariationKey'?: string;
}
export interface AgentOptimizationResultPost {
+ /**
+ * The ID of the run this result belongs to
+ */
'runId': string;
+ /**
+ * The version of the agent optimization used
+ */
'agentOptimizationVersion': number;
+ /**
+ * The iteration number within the run
+ */
'iteration': number;
+ /**
+ * The instructions used for this attempt
+ */
'instructions': string;
+ /**
+ * The user input used for this attempt
+ */
'userInput': string;
+ /**
+ * The model parameters used for this attempt
+ */
'parameters'?: { [key: string]: any; };
}
@@ -812,67 +1507,151 @@ export type AgentOptimizationResultStatus = typeof AgentOptimizationResultStatus
export interface AgentOptimizationResults {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount'?: number;
}
export interface AgentOptimizationRun {
+ /**
+ * The run ID
+ */
'runId': string;
+ /**
+ * The agent optimization key
+ */
'optimizationKey': string;
+ /**
+ * The agent optimization ID
+ */
'agentOptimizationId': string;
+ /**
+ * The version of the agent optimization used
+ */
'agentOptimizationVersion': number;
'status': AgentOptimizationResultStatus;
'activity': AgentOptimizationResultActivity;
+ /**
+ * When this resource was created, in Unix milliseconds
+ */
'createdAt': number;
+ /**
+ * When this finished, in Unix milliseconds
+ */
'completedAt'?: number | null;
}
export interface AgentOptimizationRuns {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount'?: number;
}
export interface AgentOptimizations {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface AgentSkill {
+ /**
+ * The agent skill key
+ */
'key': string;
'_access'?: AiConfigsAccess;
'_links'?: ParentAndSelfLinks;
'_maintainer'?: AIConfigMaintainer;
+ /**
+ * Human-readable name of the agent skill.
+ */
'name': string;
+ /**
+ * Human-readable description of what the agent skill does.
+ */
'description'?: string;
/**
* The verbatim SKILL.md content of the agent skill
*/
'markdown': string;
+ /**
+ * Tags for the agent skill. Tags can be used in custom role policies.
+ */
'tags': Array;
+ /**
+ * Version of the agent skill. Starts at 1, and each update that changes the name, description, or markdown creates a new version. Pass this value with `key` in a variation\'s `skills: [{key, version}]`.
+ */
'version': number;
'createdAt': number;
}
export interface AgentSkillPatch {
+ /**
+ * Human-readable name of the agent skill.
+ */
'name'?: string;
+ /**
+ * Human-readable description of what the agent skill does.
+ */
'description'?: string;
/**
* The verbatim SKILL.md content of the agent skill
*/
'markdown'?: string;
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * Replaces the tags on the agent skill. Tags can be used in custom role policies. Changing only the tags does not create a new version.
+ */
'tags'?: Array;
}
export interface AgentSkillPost {
+ /**
+ * A unique key for the agent skill. The key must match `^[a-z0-9][a-z0-9-]*$`: it can only contain lowercase letters, numbers, or \'-\', and must start with a lowercase letter or number. The key can be at most 64 characters, and Windows reserved file names (`con`, `prn`, `aux`, `nul`, `com0`-`com9`, and `lpt0`-`lpt9`) aren\'t allowed.
+ */
'key': string;
+ /**
+ * Human-readable name of the agent skill.
+ */
'name': string;
+ /**
+ * Human-readable description of what the agent skill does.
+ */
'description'?: string;
/**
* The verbatim SKILL.md content of the agent skill
*/
'markdown': string;
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * Tags for the agent skill. Tags can be used in custom role policies.
+ */
'tags'?: Array;
}
/**
@@ -914,6 +1693,9 @@ export interface AgentSkillReferences {
* The type of the resource being referenced.
*/
'resourceType': string;
+ /**
+ * The resources that reference this agent skill
+ */
'items': Array;
/**
* The total number of references.
@@ -922,7 +1704,13 @@ export interface AgentSkillReferences {
}
export interface AgentSkills {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface AiConfigsAccess {
@@ -1055,7 +1843,13 @@ export interface AiConfigsLink {
'type'?: string;
}
export interface AiConfigsMaintainerTeam {
+ /**
+ * The team key
+ */
'key': string;
+ /**
+ * The team name
+ */
'name': string;
}
export interface AiConfigsMemberSummary {
@@ -1301,6 +2095,10 @@ export interface AiConfigsMetricListingRep {
* For trace metrics, the location in the trace to use for numeric values.
*/
'traceValueLocation'?: string;
+ /**
+ * For count_distinct metrics, the column to count distinct values of
+ */
+ 'unitAggregationField'?: string;
'denominator'?: AiConfigsMetricDenominatorRep;
}
@@ -1733,6 +2531,10 @@ export interface ApprovalRequestResponse {
* An array of member IDs. These members are notified to review the approval request.
*/
'notifyMemberIds': Array;
+ /**
+ * An array of team keys, if teams were specified when the approval request was created. The members of these teams are listed in notifyMemberIds, resolved when the request was made. Team membership may have changed since then.
+ */
+ 'notifyTeamKeys'?: Array;
'appliedDate'?: number;
/**
* The member ID of the member who applied the approval request
@@ -1964,7 +2766,7 @@ export interface AudienceConfiguration {
* An array of team keys. The members of these teams are notified to review the approval request.
*/
'notifyTeamKeys'?: Array;
- 'releaseGuardianConfiguration'?: ReleaseGuardianConfiguration;
+ 'releaseGuardianConfiguration'?: PipelineReleaseGuardianConfiguration;
}
export interface AudiencePost {
/**
@@ -2141,10 +2943,18 @@ export interface AuthorizedAppDataRep {
* The authorized application name
*/
'name'?: string;
+ /**
+ * The icon for this authorized application, if it has one
+ */
+ 'iconUrl'?: string;
/**
* The name of the maintainer for this authorized application
*/
'maintainerName'?: string;
+ /**
+ * Whether this application acted on behalf of the member in this entry. When true, the member and the application are co-authors of the change rather than the member acting alone. Omitted for applications that act on their own.
+ */
+ 'isAgent'?: boolean;
}
export interface BigSegmentStoreIntegration {
'_links': BigSegmentStoreIntegrationLinks;
@@ -2354,6 +3164,15 @@ export interface CallerIdentityRep {
'authKind'?: string;
'tokenKind'?: string;
'clientId'?: string;
+ /**
+ * The registered name of the OAuth client the access token was issued to. Only present for OAuth access tokens, and omitted when the client\'s name can\'t be resolved.
+ */
+ 'clientName'?: string;
+ /**
+ * The resources (RFC 8707) the OAuth access token was issued for. Only present for OAuth access tokens issued for a specific resource.
+ */
+ 'audience'?: Array;
+ 'expiresAt'?: number;
'tokenName'?: string;
'tokenId'?: string;
'memberId'?: string;
@@ -2368,6 +3187,24 @@ export interface CapabilityConfigRep {
'approvals'?: ApprovalsCapabilityConfig;
'auditLogEventsHook'?: AuditLogEventsHookCapabilityConfigRep;
}
+export interface Classifier {
+ 'key': string;
+ 'type': ClassifierTypeEnum;
+ 'instructions': string;
+ /**
+ * Type-specific criteria. An enum classifier uses a map of option keys to descriptions. A float classifier uses an ordered list of level labels. A bool classifier uses optional true and false descriptions.
+ */
+ 'criteria'?: any;
+}
+
+export const ClassifierTypeEnum = {
+ Bool: 'bool',
+ Float: 'float',
+ Enum: 'enum'
+} as const;
+
+export type ClassifierTypeEnum = typeof ClassifierTypeEnum[keyof typeof ClassifierTypeEnum];
+
export interface Clause {
'_id'?: string;
'attribute': string;
@@ -2376,6 +3213,18 @@ export interface Clause {
'contextKind'?: string;
'negate': boolean;
}
+/**
+ * What happens to the release rules when the final phase completes, either on its own or because a stop rolls it forward while it\'s running: - `remove_rules_and_update_default_rule`: The release rules are removed and the default rule serves the target variation. - `leave_rules_in_place`: The release rules stay and serve the target variation. In every other case, including a revert, it has no effect: release rules left on the flag keep serving the variation the release ended on, ahead of rules added later without `beforeRuleId`.
+ */
+
+export const CleanupBehavior = {
+ CleanupBehaviorRemoveRulesAndUpdateDefaultRule: 'remove_rules_and_update_default_rule',
+ CleanupBehaviorLeaveRulesInPlace: 'leave_rules_in_place'
+} as const;
+
+export type CleanupBehavior = typeof CleanupBehavior[keyof typeof CleanupBehavior];
+
+
export interface Client {
/**
* The location and content type of related resources
@@ -2612,51 +3461,6 @@ export interface ContextInstanceEvaluations {
*/
'_links': { [key: string]: Link; };
}
-export interface ContextInstanceRecord {
- /**
- * Timestamp of the last time an evaluation occurred for this context instance
- */
- 'lastSeen'?: string;
- /**
- * The context instance ID
- */
- 'id': string;
- /**
- * An identifier representing the application where the LaunchDarkly SDK is running
- */
- 'applicationId'?: string;
- /**
- * A list of the context kinds this context was associated with that the SDK removed because they were marked as anonymous at flag evaluation
- */
- 'anonymousKinds'?: Array;
- /**
- * The context, including its kind and attributes
- */
- 'context': any;
- /**
- * The location and content type of related resources
- */
- '_links'?: { [key: string]: Link; };
- '_access'?: Access;
-}
-export interface ContextInstanceSearch {
- /**
- * A collection of context instance filters
- */
- 'filter'?: string;
- /**
- * Specifies a field by which to sort. LaunchDarkly supports sorting by timestamp in ascending order by specifying ts for this value, or descending order by specifying -ts.
- */
- 'sort'?: string;
- /**
- * Specifies the maximum number of items in the collection to return (max: 50, default: 20)
- */
- 'limit'?: number;
- /**
- * Limits results to context instances with sort values after the value specified. You can use this for pagination, however, we recommend using the next link instead, because this value is an obfuscated string.
- */
- 'continuationToken'?: string;
-}
export interface ContextInstanceSegmentMembership {
/**
* A human-friendly name for the segment
@@ -2702,28 +3506,6 @@ export interface ContextInstanceSegmentMemberships {
*/
'_links': { [key: string]: Link; };
}
-export interface ContextInstances {
- /**
- * The location and content type of related resources
- */
- '_links'?: { [key: string]: Link; };
- /**
- * The number of unique context instances
- */
- 'totalCount'?: number;
- /**
- * The environment ID
- */
- '_environmentId': string;
- /**
- * An obfuscated string that references the last context instance on the previous page of results. You can use this for pagination, however, we recommend using the next link instead.
- */
- 'continuationToken'?: string;
- /**
- * A collection of context instances. Can include multiple versions of context instances that have the same id, but different applicationIds.
- */
- 'items': Array;
-}
export interface ContextKindEnvironmentObservation {
/**
* The environment key
@@ -2785,7 +3567,7 @@ export interface ContextRecord {
*/
'lastSeen'?: string;
/**
- * An identifier representing the application where the LaunchDarkly SDK is running
+ * An identifier representing the application where the LaunchDarkly SDK is running. Populated when you get contexts by kind and key. Empty in search results, which return each context\'s most recently reported data.
*/
'applicationId'?: string;
/**
@@ -2798,7 +3580,8 @@ export interface ContextRecord {
'_links'?: { [key: string]: Link; };
'_access'?: Access;
/**
- * The total number of associated contexts. Associated contexts are contexts that have appeared in the same context instance, that is, they were part of the same flag evaluation.
+ * Deprecated. This value is always 1.
+ * @deprecated
*/
'associatedContexts'?: number;
}
@@ -2826,7 +3609,7 @@ export interface Contexts {
*/
'_links'?: { [key: string]: Link; };
/**
- * The number of contexts
+ * The number of matching contexts. This value is approximate and may be omitted if it is unavailable.
*/
'totalCount'?: number;
/**
@@ -2834,7 +3617,7 @@ export interface Contexts {
*/
'_environmentId': string;
/**
- * An obfuscated string that references the last context instance on the previous page of results. You can use this for pagination, however, we recommend using the next link instead.
+ * An obfuscated string that references the last context on the previous page of results. You can use this for pagination, however, we recommend using the next link instead.
*/
'continuationToken'?: string;
/**
@@ -2876,6 +3659,15 @@ export interface CovariateInfoRep {
'fileName': string;
'createdAt': number;
}
+export interface CreateAdaptiveTriggerRequest {
+ 'name': string;
+ 'resourceKind': AdaptiveTriggerResourceKind;
+ 'resourceKey': string;
+ 'triggerSource': ObservabilityAlertSource;
+ 'task': AdaptiveTriggerTask;
+}
+
+
/**
* Create announcement request body
*/
@@ -3027,7 +3819,7 @@ export interface CreatePhaseInput {
'name': string;
'configuration'?: object;
}
-export interface CreateReleaseInput {
+export interface CreatePipelineReleaseInput {
/**
* The variation id to release to across all phases
*/
@@ -3251,6 +4043,127 @@ export interface CustomWorkflowsListingOutput {
*/
'_links': { [key: string]: Link; };
}
+export interface DataExportProjectIdentityIncompleteError {
+ 'message': string;
+ 'code': DataExportProjectIdentityIncompleteErrorCodeEnum;
+}
+
+export const DataExportProjectIdentityIncompleteErrorCodeEnum = {
+ DataExportProjectIdentityIncomplete: 'data_export_project_identity_incomplete'
+} as const;
+
+export type DataExportProjectIdentityIncompleteErrorCodeEnum = typeof DataExportProjectIdentityIncompleteErrorCodeEnum[keyof typeof DataExportProjectIdentityIncompleteErrorCodeEnum];
+
+export interface DataExportProjectIdentityIncompleteErrorRep {
+ 'code'?: string;
+ 'message'?: string;
+}
+export interface DataExportProjectRankComponentsRep {
+ /**
+ * Successful Streaming transfers attributed to this project in the requested range.
+ */
+ 'streaming': number;
+}
+export interface DataExportProjectRankRep {
+ /**
+ * The canonical project key.
+ */
+ 'projectKey': string;
+ /**
+ * The current project name.
+ */
+ 'projectName': string;
+ /**
+ * The one-based rank within all matching projects.
+ */
+ 'rank': number;
+ /**
+ * Successful Streaming transfers in the requested range.
+ */
+ 'usage': number;
+ 'components': DataExportProjectRankComponentsRep;
+}
+export interface DataExportProjectRankingPageRep {
+ /**
+ * The bounded page size requested.
+ */
+ 'limit': number;
+ /**
+ * The number of items on this page.
+ */
+ 'count': number;
+ /**
+ * The number of matching projects with usage.
+ */
+ 'totalCount': number;
+ /**
+ * An opaque cursor for the next page.
+ */
+ 'nextCursor'?: string;
+}
+/**
+ * A bounded Streaming project ranking.
+ */
+export interface DataExportProjectRankingRep {
+ /**
+ * Projects in deterministic rank order.
+ */
+ 'items': Array;
+ 'page': DataExportProjectRankingPageRep;
+ 'scope': DataExportProjectRankingScopeRep;
+}
+export interface DataExportProjectRankingScopeRep {
+ /**
+ * The included usage source.
+ */
+ 'source': DataExportProjectRankingScopeRepSourceEnum;
+ /**
+ * The ranked dimension.
+ */
+ 'dimension': DataExportProjectRankingScopeRepDimensionEnum;
+ /**
+ * Inclusive UTC range start in Unix milliseconds.
+ */
+ 'from': number;
+ /**
+ * Exclusive UTC range end in Unix milliseconds.
+ */
+ 'to': number;
+}
+
+export const DataExportProjectRankingScopeRepSourceEnum = {
+ Streaming: 'streaming'
+} as const;
+
+export type DataExportProjectRankingScopeRepSourceEnum = typeof DataExportProjectRankingScopeRepSourceEnum[keyof typeof DataExportProjectRankingScopeRepSourceEnum];
+export const DataExportProjectRankingScopeRepDimensionEnum = {
+ Project: 'project'
+} as const;
+
+export type DataExportProjectRankingScopeRepDimensionEnum = typeof DataExportProjectRankingScopeRepDimensionEnum[keyof typeof DataExportProjectRankingScopeRepDimensionEnum];
+
+export interface DataExportSeriesListRep {
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: any; };
+ /**
+ * Metadata about each series
+ */
+ 'metadata': Array<{ [key: string]: any; }>;
+ /**
+ * An array of data points with timestamps. Each element of the array is an object with a \'time\' field, whose value is the timestamp, and one or more key fields. If there are multiple key fields, they are labeled \'0\', \'1\', and so on, and are explained in the metadata.
+ */
+ 'series': Array<{ [key: string]: number; }>;
+ /**
+ * The end of the latest hour written by this source\'s usage pipeline, as an RFC 3339 UTC timestamp. It is measured across all accounts, not only yours, and usage after this time is not counted yet. Omitted when the watermark is unavailable.
+ */
+ 'dataThrough'?: string;
+ /**
+ * Whether this source\'s usage pipeline is late: it wrote every hour of the 24 hours ending at dataThrough, and more than three hours have passed since dataThrough. Always false for a source with gaps in those 24 hours, where gaps usually mean no usage rather than a stalled pipeline. Omitted when dataThrough is omitted.
+ */
+ 'delayed'?: boolean;
+}
export interface DefaultClientSideAvailability {
/**
* Whether to enable availability for mobile SDKs
@@ -3390,9 +4303,129 @@ export interface DependentFlagsByEnvironment {
'_links': { [key: string]: Link; };
'_site': Link;
}
-export interface DependentMeasuredRolloutRep {
+export interface DependentMetricGroupRep {
+ /**
+ * A unique key to reference the metric group
+ */
+ 'key': string;
+ /**
+ * A human-friendly name for the metric group
+ */
+ 'name': string;
+ /**
+ * The type of the metric group
+ */
+ 'kind': DependentMetricGroupRepKindEnum;
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: Link; };
+}
+
+export const DependentMetricGroupRepKindEnum = {
+ Funnel: 'funnel',
+ Standard: 'standard'
+} as const;
+
+export type DependentMetricGroupRepKindEnum = typeof DependentMetricGroupRepKindEnum[keyof typeof DependentMetricGroupRepKindEnum];
+
+export interface DependentMetricGroupRepWithMetrics {
+ /**
+ * A unique key to reference the metric group
+ */
+ 'key': string;
+ /**
+ * A human-friendly name for the metric group
+ */
+ 'name': string;
+ /**
+ * The type of the metric group
+ */
+ 'kind': DependentMetricGroupRepWithMetricsKindEnum;
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: Link; };
+ /**
+ * The metrics in the metric group
+ */
+ 'metrics'?: Array;
+}
+
+export const DependentMetricGroupRepWithMetricsKindEnum = {
+ Funnel: 'funnel',
+ Standard: 'standard'
+} as const;
+
+export type DependentMetricGroupRepWithMetricsKindEnum = typeof DependentMetricGroupRepWithMetricsKindEnum[keyof typeof DependentMetricGroupRepWithMetricsKindEnum];
+
+export interface DependentMetricOrMetricGroupRep {
+ /**
+ * A unique key to reference the metric or metric group
+ */
+ 'key': string;
+ /**
+ * The version ID of the metric or metric group
+ */
+ '_versionId': string;
+ /**
+ * A human-friendly name for the metric or metric group
+ */
+ 'name': string;
+ /**
+ * If this is a metric, then it represents the kind of event the metric tracks. If this is a metric group, then it represents the group type
+ */
+ 'kind': DependentMetricOrMetricGroupRepKindEnum;
+ /**
+ * For custom and trace metrics, whether to track numeric changes in value against a baseline (true) or to track a conversion when an end user takes an action (false).
+ */
+ 'isNumeric'?: boolean;
+ /**
+ * The event key sent with the metric. Only relevant for custom metrics.
+ */
+ 'eventKey'?: string;
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: Link; };
+ /**
+ * Whether this is a metric group or a metric
+ */
+ 'isGroup': boolean;
+ /**
+ * An ordered list of the metrics in this metric group
+ */
+ 'metrics'?: Array;
+ /**
+ * The method for analyzing metric events. Only set for individual metrics, not metric groups.
+ */
+ 'analysisType'?: DependentMetricOrMetricGroupRepAnalysisTypeEnum;
+ /**
+ * The context kind chosen as the analysis unit for this metric in the iteration. If null, analysis uses the iteration\'s randomization unit.
+ */
+ 'analysisUnit'?: string;
+}
+
+export const DependentMetricOrMetricGroupRepKindEnum = {
+ Pageview: 'pageview',
+ Click: 'click',
+ Custom: 'custom',
+ Trace: 'trace',
+ Funnel: 'funnel',
+ Standard: 'standard'
+} as const;
+
+export type DependentMetricOrMetricGroupRepKindEnum = typeof DependentMetricOrMetricGroupRepKindEnum[keyof typeof DependentMetricOrMetricGroupRepKindEnum];
+export const DependentMetricOrMetricGroupRepAnalysisTypeEnum = {
+ Mean: 'mean',
+ Percentile: 'percentile'
+} as const;
+
+export type DependentMetricOrMetricGroupRepAnalysisTypeEnum = typeof DependentMetricOrMetricGroupRepAnalysisTypeEnum[keyof typeof DependentMetricOrMetricGroupRepAnalysisTypeEnum];
+
+export interface DependentReleasePhaseRep {
/**
- * The guarded rollout measured rollout Id
+ * The guarded rollout release phase ID
*/
'_id': string;
/**
@@ -3425,126 +4458,6 @@ export interface DependentMeasuredRolloutRep {
*/
'_links': { [key: string]: Link; };
}
-export interface DependentMetricGroupRep {
- /**
- * A unique key to reference the metric group
- */
- 'key': string;
- /**
- * A human-friendly name for the metric group
- */
- 'name': string;
- /**
- * The type of the metric group
- */
- 'kind': DependentMetricGroupRepKindEnum;
- /**
- * The location and content type of related resources
- */
- '_links': { [key: string]: Link; };
-}
-
-export const DependentMetricGroupRepKindEnum = {
- Funnel: 'funnel',
- Standard: 'standard'
-} as const;
-
-export type DependentMetricGroupRepKindEnum = typeof DependentMetricGroupRepKindEnum[keyof typeof DependentMetricGroupRepKindEnum];
-
-export interface DependentMetricGroupRepWithMetrics {
- /**
- * A unique key to reference the metric group
- */
- 'key': string;
- /**
- * A human-friendly name for the metric group
- */
- 'name': string;
- /**
- * The type of the metric group
- */
- 'kind': DependentMetricGroupRepWithMetricsKindEnum;
- /**
- * The location and content type of related resources
- */
- '_links': { [key: string]: Link; };
- /**
- * The metrics in the metric group
- */
- 'metrics'?: Array;
-}
-
-export const DependentMetricGroupRepWithMetricsKindEnum = {
- Funnel: 'funnel',
- Standard: 'standard'
-} as const;
-
-export type DependentMetricGroupRepWithMetricsKindEnum = typeof DependentMetricGroupRepWithMetricsKindEnum[keyof typeof DependentMetricGroupRepWithMetricsKindEnum];
-
-export interface DependentMetricOrMetricGroupRep {
- /**
- * A unique key to reference the metric or metric group
- */
- 'key': string;
- /**
- * The version ID of the metric or metric group
- */
- '_versionId': string;
- /**
- * A human-friendly name for the metric or metric group
- */
- 'name': string;
- /**
- * If this is a metric, then it represents the kind of event the metric tracks. If this is a metric group, then it represents the group type
- */
- 'kind': DependentMetricOrMetricGroupRepKindEnum;
- /**
- * For custom and trace metrics, whether to track numeric changes in value against a baseline (true) or to track a conversion when an end user takes an action (false).
- */
- 'isNumeric'?: boolean;
- /**
- * The event key sent with the metric. Only relevant for custom metrics.
- */
- 'eventKey'?: string;
- /**
- * The location and content type of related resources
- */
- '_links': { [key: string]: Link; };
- /**
- * Whether this is a metric group or a metric
- */
- 'isGroup': boolean;
- /**
- * An ordered list of the metrics in this metric group
- */
- 'metrics'?: Array;
- /**
- * The method for analyzing metric events. Only set for individual metrics, not metric groups.
- */
- 'analysisType'?: DependentMetricOrMetricGroupRepAnalysisTypeEnum;
- /**
- * The context kind chosen as the analysis unit for this metric in the iteration. If null, analysis uses the iteration\'s randomization unit.
- */
- 'analysisUnit'?: string;
-}
-
-export const DependentMetricOrMetricGroupRepKindEnum = {
- Pageview: 'pageview',
- Click: 'click',
- Custom: 'custom',
- Trace: 'trace',
- Funnel: 'funnel',
- Standard: 'standard'
-} as const;
-
-export type DependentMetricOrMetricGroupRepKindEnum = typeof DependentMetricOrMetricGroupRepKindEnum[keyof typeof DependentMetricOrMetricGroupRepKindEnum];
-export const DependentMetricOrMetricGroupRepAnalysisTypeEnum = {
- Mean: 'mean',
- Percentile: 'percentile'
-} as const;
-
-export type DependentMetricOrMetricGroupRepAnalysisTypeEnum = typeof DependentMetricOrMetricGroupRepAnalysisTypeEnum[keyof typeof DependentMetricOrMetricGroupRepAnalysisTypeEnum];
-
export interface DeploymentCollectionRep {
/**
* The total number of deployments
@@ -3712,14 +4625,25 @@ export interface Destinations {
*/
'items'?: Array;
}
+export interface DynamicOptionFiltersItems {
+ 'attribute'?: string;
+ 'variableKey'?: string;
+}
export interface DynamicOptions {
+ 'allowUnknownValue'?: boolean;
'endpoint'?: Endpoint;
+ 'filters'?: Array;
'parser'?: DynamicOptionsParser;
+ 'source'?: DynamicOptionsSource;
}
export interface DynamicOptionsParser {
'optionsItems'?: OptionsArray;
'optionsPath'?: string;
}
+export interface DynamicOptionsSource {
+ 'key'?: string;
+ 'type'?: string;
+}
export interface Endpoint {
'headers'?: Array;
'hmacSignature'?: HMACSignature;
@@ -3765,7 +4689,7 @@ export interface Environment {
'secureMode': boolean;
'_access'?: Access;
/**
- * Enables tracking detailed information for new flags by default
+ * The initial value of trackEvents for flags created in this environment. Does not affect existing flags. Required for Data Export, but doesn\'t enable Data Export on its own.
*/
'defaultTrackEvents': boolean;
/**
@@ -3812,7 +4736,7 @@ export interface EnvironmentPost {
*/
'secureMode'?: boolean;
/**
- * Enables tracking detailed information for new flags by default
+ * The initial value of trackEvents for flags created in this environment. Does not affect existing flags. Required for Data Export, but doesn\'t enable Data Export on its own.
*/
'defaultTrackEvents'?: boolean;
/**
@@ -3833,6 +4757,525 @@ export interface EnvironmentPost {
*/
'critical'?: boolean;
}
+/**
+ * A flag release in one environment, made up of one or more ordered phases. The top-level status is derived from the phases: it reflects the active phase, reports `waiting` between successfully completed phases, and reports the terminal outcome of the release.
+ */
+export interface EnvironmentRelease {
+ 'id': string;
+ 'status': ReleaseStatus;
+ 'statusReason'?: ReleaseStatusReason;
+ 'projectKey': string;
+ 'environmentKey': string;
+ 'flagKey': string;
+ /**
+ * ID of the variation the release started from.
+ */
+ 'originalVariationId': string;
+ /**
+ * The value of the variation. This may be a string, boolean, number, JSON object, or array.
+ */
+ 'originalVariationValue': any;
+ /**
+ * ID of the variation being released.
+ */
+ 'targetVariationId': string;
+ /**
+ * The value of the variation. This may be a string, boolean, number, JSON object, or array.
+ */
+ 'targetVariationValue': any;
+ /**
+ * Key of the context kind the release randomizes on.
+ */
+ 'randomizationUnit': string;
+ 'cleanupBehavior': CleanupBehavior;
+ 'kind': ReleaseType;
+ 'metrics': Array;
+ 'phases': Array;
+ /**
+ * Zero-based index of the active phase. Null before the first phase, between phases, and after the release reaches a terminal status.
+ */
+ 'currentPhaseIndex': number | null;
+ 'advancementMode': EnvironmentReleaseAdvancementMode;
+ /**
+ * Creation time in Unix milliseconds.
+ */
+ 'createdAt': number;
+ /**
+ * Start of the first phase in Unix milliseconds. Absent until a phase has started.
+ */
+ 'startedAt'?: number;
+ /**
+ * End of the last started phase in Unix milliseconds. Present only after the release reaches a terminal status of `completed` or `reverted`.
+ */
+ 'endedAt'?: number;
+ '_links'?: { [key: string]: EnvironmentReleaseLink; };
+}
+
+
+/**
+ * Whether a multi-phase release advances to the next phase automatically once the current phase\'s steps complete, or waits for an explicit advance. Has no effect on a single-phase release.
+ */
+
+export const EnvironmentReleaseAdvancementMode = {
+ EnvironmentReleaseAdvancementModeManual: 'manual',
+ EnvironmentReleaseAdvancementModeAutomatic: 'automatic'
+} as const;
+
+export type EnvironmentReleaseAdvancementMode = typeof EnvironmentReleaseAdvancementMode[keyof typeof EnvironmentReleaseAdvancementMode];
+
+
+/**
+ * One targeting clause of a rule created for the release.
+ */
+export interface EnvironmentReleaseClause {
+ /**
+ * Context kind the clause applies to. Omit for `segmentMatch`.
+ */
+ 'contextKind'?: string;
+ 'attribute': string;
+ /**
+ * One of `in`, `endsWith`, `startsWith`, `matches`, `contains`, `lessThan`, `lessThanOrEqual`, `greaterThan`, `greaterThanOrEqual`, `before`, `after`, `segmentMatch`, `semVerEqual`, `semVerLessThan`, `semVerGreaterThan`.
+ */
+ 'op': string;
+ /**
+ * JSON primitives only (strings, numbers, booleans); objects, arrays, and null are rejected.
+ */
+ 'values': Array;
+ 'negate'?: boolean;
+}
+/**
+ * One page of environment releases for one flag in one environment, newest first.
+ */
+export interface EnvironmentReleaseCollection {
+ /**
+ * The releases on this page.
+ */
+ 'items': Array;
+ /**
+ * The total number of releases that match the request, before `limit` and `offset` are applied.
+ */
+ 'totalCount': number;
+ /**
+ * Links to this page (`self`), the flag (`parent`), and, where they apply, the `first`, `prev`, `next`, and `last` pages.
+ */
+ '_links'?: { [key: string]: EnvironmentReleaseLink; };
+}
+/**
+ * A phase that releases on an existing rule. Allowed only on a single-phase release.
+ */
+export interface EnvironmentReleaseExistingRulePhaseInput {
+ /**
+ * Existing rule to release on. The rule must already include the `kind` clause for `randomizationUnit` described in `startEnvironmentRelease`.
+ */
+ 'ruleId': string;
+ 'steps': Array;
+}
+export interface EnvironmentReleaseLink {
+ 'href': string;
+ 'type': string;
+}
+/**
+ * A metric to monitor across every phase of a guarded release.
+ */
+export interface EnvironmentReleaseMetricInput {
+ 'metricKey': string;
+ /**
+ * Whether a regression on this metric automatically reverts the release. When `false`, a detected regression pauses the release instead: it reports `waiting` with reason `waiting_regression_detected` and does not advance until the regression is dismissed or the release is stopped.
+ */
+ 'autoRollback'?: boolean;
+}
+/**
+ * A phase that creates a new rule.
+ */
+export interface EnvironmentReleaseNewRulePhaseInput {
+ /**
+ * Clauses for a new rule. Must include the `kind` clause for `randomizationUnit` described in `startEnvironmentRelease`. A new rule that exactly duplicates an existing rule on the flag returns `400` with `new rule is exact duplicate of an existing rule at index `.
+ */
+ 'clauses': Array;
+ /**
+ * Description for a new rule. Must differ from the description of every other rule on the flag, including rules an earlier release left in place, or the request returns `400` with `duplicate rule description not allowed`.
+ */
+ 'description'?: string;
+ 'steps': Array;
+}
+/**
+ * One ordered phase of an environment release.
+ */
+export interface EnvironmentReleasePhase {
+ 'id': string;
+ /**
+ * Zero-based index of this phase.
+ */
+ 'phaseIndex': number;
+ /**
+ * ID of the flag rule for this phase. New public-API releases always have a rule ID. `null` is retained only when reading a historical release that ran on the default rule.
+ */
+ 'ruleId': string | null;
+ /**
+ * The description of the flag rule when this release was created. Omitted for default-rule phases.
+ */
+ 'description'?: string;
+ 'status': ReleaseStatus;
+ 'statusReason'?: ReleaseStatusReason;
+ 'steps': Array;
+ /**
+ * Zero-based index of the step the phase is on. Omitted until the first step starts. Once the phase completes or reverts, it stays at the last step that started, unlike `currentPhaseIndex`, which becomes `null` when the release reaches a terminal status.
+ */
+ 'currentStepIndex'?: number;
+ /**
+ * Start of the phase in Unix milliseconds.
+ */
+ 'startedAt'?: number;
+ /**
+ * End of the phase in Unix milliseconds.
+ */
+ 'endedAt'?: number;
+ /**
+ * Per-phase metric status keyed by metric key. Empty for progressive releases. Metric definitions and monitoring preferences live once in the parent release\'s `metrics` array.
+ */
+ 'metricStatuses': { [key: string]: ReleaseMetricStatus; };
+}
+
+
+/**
+ * @type EnvironmentReleasePhaseInput
+ * One phase of a release. Each phase creates a flag rule unless it sets `ruleId`.
+ */
+export type EnvironmentReleasePhaseInput = EnvironmentReleaseExistingRulePhaseInput | EnvironmentReleaseNewRulePhaseInput;
+
+/**
+ * How to resolve each phase of the release when you stop it: - `roll_forward_all_phases`: All phases serve the target variation. Pending phases stay on the flag and are enabled. - `roll_forward_current_phase_and_remove_pending_phases`: Current and completed phases serve the target variation. Pending phases are removed. - `roll_back_all_phases_and_remove_pending_phases`: Current and completed phases serve the original variation. Pending phases are removed. - `roll_back_current_phase_and_remove_pending_phases`: The current phase serves the original variation, and completed phases keep serving the target variation. Pending phases are removed. For a single-phase release there are no completed or pending phases, so the two roll-forward values are equivalent, as are the two roll-back values. The `current_phase` values return `400` if the release is between phases. Use an `all_phases` value instead. A terminal release returns `200` unchanged for every resolution.
+ */
+
+export const EnvironmentReleaseResolution = {
+ EnvironmentReleaseResolutionRollForwardAllPhases: 'roll_forward_all_phases',
+ EnvironmentReleaseResolutionRollForwardCurrentPhaseAndRemovePendingPhases: 'roll_forward_current_phase_and_remove_pending_phases',
+ EnvironmentReleaseResolutionRollBackAllPhasesAndRemovePendingPhases: 'roll_back_all_phases_and_remove_pending_phases',
+ EnvironmentReleaseResolutionRollBackCurrentPhaseAndRemovePendingPhases: 'roll_back_current_phase_and_remove_pending_phases'
+} as const;
+
+export type EnvironmentReleaseResolution = typeof EnvironmentReleaseResolution[keyof typeof EnvironmentReleaseResolution];
+
+
+/**
+ * One step of a phase\'s rollout schedule.
+ */
+export interface EnvironmentReleaseStepInput {
+ /**
+ * Thousandths of a percent. `100000` is 100%, and `10000` is 10%. Guarded releases cannot exceed `50000`, preserving a control group. Each step\'s allocation must be greater than the previous step\'s. In a progressive release, an allocation of N% serves the target variation to N% of the phase\'s contexts and the original variation to the rest. In a guarded release, it serves the target variation to N%, the original variation to another N% as the measured control group, and the original variation to the rest without measuring them.
+ */
+ 'allocation': number;
+ 'durationMillis': number;
+}
+export interface EnvironmentReleasesAccess {
+ 'denied': Array;
+ 'allowed': Array;
+}
+export interface EnvironmentReleasesAccessAllowedRep {
+ 'action': string;
+ 'reason': AccessAllowedReason;
+}
+export interface EnvironmentReleasesAccessDenied {
+ 'action': string;
+ 'reason': AccessDeniedReason;
+}
+export interface EnvironmentReleasesFilter {
+ /**
+ * Filter type. One of [contextAttribute, eventProperty, group]
+ */
+ 'type': EnvironmentReleasesFilterTypeEnum;
+ /**
+ * If not a group node, the context attribute name or event property name to filter on
+ */
+ 'attribute'?: string;
+ 'op': string;
+ /**
+ * The context attribute / event property values or group member nodes
+ */
+ 'values': Array;
+ /**
+ * For context attribute filters, the context kind.
+ */
+ 'contextKind'?: string;
+ /**
+ * If set, then take the inverse of the operator. \'in\' becomes \'not in\'.
+ */
+ 'negate': boolean;
+}
+
+export const EnvironmentReleasesFilterTypeEnum = {
+ Group: 'group',
+ ContextAttribute: 'contextAttribute',
+ EventProperty: 'eventProperty'
+} as const;
+
+export type EnvironmentReleasesFilterTypeEnum = typeof EnvironmentReleasesFilterTypeEnum[keyof typeof EnvironmentReleasesFilterTypeEnum];
+
+export interface EnvironmentReleasesMemberSummary {
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: Link; };
+ /**
+ * The member\'s ID
+ */
+ '_id': string;
+ /**
+ * The member\'s first name
+ */
+ 'firstName'?: string;
+ /**
+ * The member\'s last name
+ */
+ 'lastName'?: string;
+ /**
+ * The member\'s base role. If the member has no additional roles, this role will be in effect.
+ */
+ 'role': string;
+ /**
+ * The member\'s email address
+ */
+ 'email': string;
+}
+export interface EnvironmentReleasesMetricDenominatorRep {
+ /**
+ * The warehouse event column for the denominator
+ */
+ 'eventName'?: string;
+ /**
+ * Whether the denominator aggregates a numeric value
+ */
+ 'isNumeric'?: boolean;
+ /**
+ * How individual unit values are aggregated for the denominator
+ */
+ 'unitAggregationType'?: string;
+ /**
+ * The column to count distinct values of; required when unitAggregationType is count_distinct
+ */
+ 'unitAggregationField'?: string;
+ /**
+ * For a numeric denominator, the column holding the numeric value
+ */
+ 'valueColumn'?: string;
+ 'dataSource'?: MetricDataSourceRefRep;
+ 'filters'?: EnvironmentReleasesFilter;
+ /**
+ * Start of the measurement window in milliseconds
+ */
+ 'windowStartOffset'?: number;
+ /**
+ * End of the measurement window in milliseconds
+ */
+ 'windowEndOffset'?: number;
+ /**
+ * Lower winsorization percentile in the open interval (0, 100)
+ */
+ 'winsorLowerPercentile'?: number;
+ /**
+ * Upper winsorization percentile in the open interval (0, 100)
+ */
+ 'winsorUpperPercentile'?: number;
+ /**
+ * When true, the percentile bound calculation includes imputed zeros
+ */
+ 'winsorIncludeImputed'?: boolean;
+}
+export interface EnvironmentReleasesMetricListingRep {
+ /**
+ * The number of experiments using this metric
+ */
+ 'experimentCount'?: number;
+ /**
+ * The number of metric groups using this metric
+ */
+ 'metricGroupCount'?: number;
+ /**
+ * The number of guarded rollouts using this metric
+ */
+ 'guardedRolloutCount'?: number;
+ /**
+ * The number of release policies using this metric
+ */
+ 'releasePolicyCount'?: number;
+ /**
+ * The number of active experiments using this metric
+ */
+ 'activeExperimentCount'?: number;
+ /**
+ * The number of active guarded rollouts using this metric
+ */
+ 'activeGuardedRolloutCount'?: number;
+ /**
+ * The ID of this metric
+ */
+ '_id': string;
+ /**
+ * The version ID of the metric
+ */
+ '_versionId': string;
+ /**
+ * Version of the metric
+ */
+ '_version'?: number;
+ /**
+ * A unique key to reference the metric
+ */
+ 'key': string;
+ /**
+ * A human-friendly name for the metric
+ */
+ 'name': string;
+ /**
+ * The kind of event the metric tracks
+ */
+ 'kind': EnvironmentReleasesMetricListingRepKindEnum;
+ /**
+ * The number of feature flags currently attached to this metric
+ */
+ '_attachedFlagCount'?: number;
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: Link; };
+ '_site'?: Link;
+ '_access'?: EnvironmentReleasesAccess;
+ /**
+ * Tags for the metric
+ */
+ 'tags': Array;
+ '_creationDate': number;
+ 'lastModified'?: EnvironmentReleasesModification;
+ /**
+ * The ID of the member who maintains this metric
+ */
+ 'maintainerId'?: string;
+ '_maintainer'?: EnvironmentReleasesMemberSummary;
+ /**
+ * Description of the metric
+ */
+ 'description'?: string;
+ /**
+ * The category of the metric
+ */
+ 'category'?: string;
+ /**
+ * For custom and trace metrics, whether to track numeric changes in value against a baseline (true) or to track a conversion when an end user takes an action (false).
+ */
+ 'isNumeric'?: boolean;
+ /**
+ * For custom and trace metrics, the success criteria
+ */
+ 'successCriteria'?: EnvironmentReleasesMetricListingRepSuccessCriteriaEnum;
+ /**
+ * For numeric custom and trace metrics, the unit of measure
+ */
+ 'unit'?: string;
+ /**
+ * For custom metrics, the event key to use in your code
+ */
+ 'eventKey'?: string;
+ /**
+ * Deprecated, use analysisUnits instead.
+ * @deprecated
+ */
+ 'randomizationUnits'?: Array;
+ /**
+ * An array of analysis units allowed for this metric.
+ */
+ 'analysisUnits'?: Array;
+ 'filters'?: EnvironmentReleasesFilter;
+ /**
+ * The method by which multiple unit event values are aggregated
+ */
+ 'unitAggregationType'?: EnvironmentReleasesMetricListingRepUnitAggregationTypeEnum;
+ /**
+ * The method for analyzing metric events
+ */
+ 'analysisType'?: EnvironmentReleasesMetricListingRepAnalysisTypeEnum;
+ /**
+ * The percentile for the analysis method. An integer denoting the target percentile between 0 and 100. Required when analysisType is percentile.
+ */
+ 'percentileValue'?: number;
+ 'eventDefault'?: MetricEventDefaultRep;
+ 'dataSource': MetricDataSourceRefRep;
+ 'lastSeen'?: number;
+ /**
+ * Whether the metric version is archived
+ */
+ 'archived'?: boolean;
+ 'archivedAt'?: number;
+ /**
+ * For click metrics, the CSS selectors
+ */
+ 'selector'?: string;
+ 'urls'?: Array<{ [key: string]: any; }>;
+ /**
+ * Not yet implemented - The start of the measurement window, in milliseconds relative to the unit\'s first exposure to a flag variation
+ */
+ 'windowStartOffset'?: number;
+ /**
+ * Not yet implemented - The end of the measurement window, in milliseconds relative to the unit\'s first exposure to a flag variation
+ */
+ 'windowEndOffset'?: number;
+ /**
+ * Lower winsorization percentile, expressed as a percent in the open interval (0, 100). When both bounds are set, defines a two-sided clamp range. Otherwise lower-only winsorization.
+ */
+ 'winsorLowerPercentile'?: number;
+ /**
+ * Upper winsorization percentile, expressed as a percent in the open interval (0, 100). When both bounds are set, must be greater than winsorLowerPercentile.
+ */
+ 'winsorUpperPercentile'?: number;
+ /**
+ * When true, the percentile bound calculation includes imputed zeros. Only meaningful when at least one bound is set and the metric includes units that didn\'t send events.
+ */
+ 'winsorIncludeImputed'?: boolean;
+ /**
+ * For trace metrics, the trace query to use for the metric.
+ */
+ 'traceQuery'?: string;
+ /**
+ * For trace metrics, the location in the trace to use for numeric values.
+ */
+ 'traceValueLocation'?: string;
+ /**
+ * For count_distinct metrics, the column to count distinct values of
+ */
+ 'unitAggregationField'?: string;
+ 'denominator'?: EnvironmentReleasesMetricDenominatorRep;
+}
+
+export const EnvironmentReleasesMetricListingRepKindEnum = {
+ Pageview: 'pageview',
+ Click: 'click',
+ Custom: 'custom',
+ Trace: 'trace'
+} as const;
+
+export type EnvironmentReleasesMetricListingRepKindEnum = typeof EnvironmentReleasesMetricListingRepKindEnum[keyof typeof EnvironmentReleasesMetricListingRepKindEnum];
+export const EnvironmentReleasesMetricListingRepSuccessCriteriaEnum = {
+ HigherThanBaseline: 'HigherThanBaseline',
+ LowerThanBaseline: 'LowerThanBaseline'
+} as const;
+
+export type EnvironmentReleasesMetricListingRepSuccessCriteriaEnum = typeof EnvironmentReleasesMetricListingRepSuccessCriteriaEnum[keyof typeof EnvironmentReleasesMetricListingRepSuccessCriteriaEnum];
+export const EnvironmentReleasesMetricListingRepUnitAggregationTypeEnum = {
+ Average: 'average',
+ Sum: 'sum',
+ CountDistinct: 'count_distinct'
+} as const;
+
+export type EnvironmentReleasesMetricListingRepUnitAggregationTypeEnum = typeof EnvironmentReleasesMetricListingRepUnitAggregationTypeEnum[keyof typeof EnvironmentReleasesMetricListingRepUnitAggregationTypeEnum];
+export const EnvironmentReleasesMetricListingRepAnalysisTypeEnum = {
+ Mean: 'mean',
+ Percentile: 'percentile'
+} as const;
+
+export type EnvironmentReleasesMetricListingRepAnalysisTypeEnum = typeof EnvironmentReleasesMetricListingRepAnalysisTypeEnum[keyof typeof EnvironmentReleasesMetricListingRepAnalysisTypeEnum];
+
+export interface EnvironmentReleasesModification {
+ 'date'?: string;
+}
export interface EnvironmentSummary {
/**
* The location and content type of related resources
@@ -3958,6 +5401,10 @@ export interface ExpandableApprovalRequestResponse {
* An array of member IDs. These members are notified to review the approval request.
*/
'notifyMemberIds': Array;
+ /**
+ * An array of team keys, if teams were specified when the approval request was created. The members of these teams are listed in notifyMemberIds, resolved when the request was made. Team membership may have changed since then.
+ */
+ 'notifyTeamKeys'?: Array;
'appliedDate'?: number;
/**
* The member ID of the member who applied the approval request
@@ -4526,7 +5973,7 @@ export interface ExperimentPost {
*/
'tags'?: Array;
/**
- * The results analysis approach.
+ * The results analysis approach. Defaults to \"frequentist\" when not provided, or \"bayesian\" for multi-armed bandit experiments.
*/
'methodology'?: ExperimentPostMethodologyEnum;
'analysisConfig'?: AnalysisConfigInput;
@@ -4561,6 +6008,10 @@ export const ExperimentPostTypeEnum = {
export type ExperimentPostTypeEnum = typeof ExperimentPostTypeEnum[keyof typeof ExperimentPostTypeEnum];
+export interface ExperimentationLink {
+ 'href'?: string;
+ 'type'?: string;
+}
export interface ExpiringTarget {
/**
* The ID of this expiring target
@@ -4972,11 +6423,11 @@ export interface FeatureFlagConfig {
*/
'_environmentName': string;
/**
- * Whether LaunchDarkly tracks events for the feature flag, for all rules
+ * Whether the SDK sends a detailed event for every evaluation of this flag, across all rules, instead of only summary counts. Required for Data Export, but doesn\'t enable Data Export on its own.
*/
'trackEvents': boolean;
/**
- * Whether LaunchDarkly tracks events for the feature flag, for the default rule
+ * Whether the SDK sends a detailed event for every evaluation of this flag\'s default rule, instead of only summary counts. Required for Data Export, but doesn\'t enable Data Export on its own.
*/
'trackEventsFallthrough': boolean;
'_debugEventsUntilDate'?: number;
@@ -5150,6 +6601,10 @@ export interface FlagConfigApprovalRequestResponse {
* An array of member IDs. These members are notified to review the approval request.
*/
'notifyMemberIds': Array;
+ /**
+ * An array of team keys, if teams were specified when the approval request was created. The members of these teams are listed in notifyMemberIds, resolved when the request was made. Team membership may have changed since then.
+ */
+ 'notifyTeamKeys'?: Array;
'appliedDate'?: number;
/**
* The member ID of the member who applied the approval request
@@ -5860,7 +7315,7 @@ export interface GuardedReleaseConfig {
*/
'metricGroupKeys'?: Array;
/**
- * List of stages
+ * List of stages. At most 10 stages by default; the server enforces the per-account limit, which is never more than 20.
*/
'stages'?: Array;
}
@@ -6494,7 +7949,7 @@ export interface IntegrationConfigurationsRep {
*/
'snowflakeSetupScript'?: string;
/**
- * SQL setup scripts (4 parts) for Redshift Native Experimentation setup. Present only for setup endpoint responses.
+ * SQL setup scripts (4 parts) for Redshift native Experimentation setup. Present on setup endpoint responses and, rehydrated from the persisted config, on active (finalized) Redshift native Experimentation configurations.
*/
'redshiftSetupScripts'?: Array;
/**
@@ -6505,6 +7960,10 @@ export interface IntegrationConfigurationsRep {
* IAM trust policy JSON for the customer\'s Redshift IAM role. Present only for setup endpoint responses.
*/
'redshiftIAMTrustPolicy'?: string;
+ /**
+ * SQL setup script for ClickHouse native Experimentation. On setup endpoint responses it also creates the experimentation user with the submitted password. When the two-step setup flow is enabled, it is rehydrated from the persisted config on other responses with only the grants, never the password.
+ */
+ 'clickHouseSetupScript'?: string;
/**
* The ID of the member who maintains this integration configuration. Defaults to the member who created it.
*/
@@ -6951,10 +8410,25 @@ export interface Maintainer {
'maintainerTeam'?: ViewsMaintainerTeam;
}
export interface MaintainerMember {
+ /**
+ * The member ID
+ */
'_id': string;
+ /**
+ * The member email address
+ */
'email': string;
+ /**
+ * The member first name
+ */
'firstName'?: string;
+ /**
+ * The member last name
+ */
'lastName'?: string;
+ /**
+ * The member role
+ */
'role': string;
}
export interface MaintainerRep {
@@ -7184,7 +8658,13 @@ export interface MembersPatchInput {
'instructions': Array<{ [key: string]: any; }>;
}
export interface Message {
+ /**
+ * The message text
+ */
'content': string;
+ /**
+ * The message role, such as system, user, or assistant
+ */
'role': string;
}
export interface MethodNotAllowedErrorRep {
@@ -7198,6 +8678,9 @@ export interface MethodNotAllowedErrorRep {
'message': string;
}
export interface MetricByVariation {
+ /**
+ * The variation key
+ */
'variationKey'?: string;
'metrics'?: Metrics;
}
@@ -7287,7 +8770,7 @@ export interface MetricGroupPost {
/**
* A unique key to reference the metric group
*/
- 'key'?: string;
+ 'key': string;
/**
* A human-friendly name for the metric group
*/
@@ -7640,6 +9123,10 @@ export interface MetricListingRep {
* For trace metrics, the location in the trace to use for numeric values.
*/
'traceValueLocation'?: string;
+ /**
+ * For count_distinct metrics, the column to count distinct values of
+ */
+ 'unitAggregationField'?: string;
'denominator'?: MetricDenominatorRep;
}
@@ -7954,6 +9441,10 @@ export interface MetricRep {
* For trace metrics, the location in the trace to use for numeric values.
*/
'traceValueLocation'?: string;
+ /**
+ * For count_distinct metrics, the column to count distinct values of
+ */
+ 'unitAggregationField'?: string;
'denominator'?: MetricDenominatorRep;
'experiments'?: Array;
/**
@@ -7961,7 +9452,7 @@ export interface MetricRep {
*/
'metricGroups'?: Array;
'lastUsedInExperiment'?: DependentExperimentRep;
- 'lastUsedInGuardedRollout'?: DependentMeasuredRolloutRep;
+ 'lastUsedInGuardedRollout'?: DependentReleasePhaseRep;
/**
* Whether the metric is active
*/
@@ -8066,8 +9557,17 @@ export const MetricV2RepAnalysisTypeEnum = {
export type MetricV2RepAnalysisTypeEnum = typeof MetricV2RepAnalysisTypeEnum[keyof typeof MetricV2RepAnalysisTypeEnum];
export interface Metrics {
+ /**
+ * Number of input tokens
+ */
'inputTokens'?: number;
+ /**
+ * Number of output tokens
+ */
'outputTokens'?: number;
+ /**
+ * Total number of tokens
+ */
'totalTokens'?: number;
/**
* Number of attempted generations
@@ -8082,9 +9582,21 @@ export interface Metrics {
* Number of generations with errors
*/
'generationErrorCount'?: number;
+ /**
+ * Number of positive feedback ratings
+ */
'thumbsUp'?: number;
+ /**
+ * Number of negative feedback ratings
+ */
'thumbsDown'?: number;
+ /**
+ * Total generation duration, in milliseconds
+ */
'durationMs'?: number;
+ /**
+ * Time to the first token, in milliseconds
+ */
'timeToFirstTokenMs'?: number;
/**
* A value between 0 and 1 representing satisfaction rating
@@ -8147,11 +9659,11 @@ export interface ModelConfig {
*/
'name': string;
/**
- * Unique key for the model
+ * Unique key for the model config in the project, in the format `Provider.model-id`. Use this value as `modelConfigKey` on a config variation.
*/
'key': string;
/**
- * Identifier for the model, for use with third party providers
+ * Model ID that the provider\'s API uses. This is different from `key`. Use this value as `modelName` on a config variation.
*/
'id': string;
/**
@@ -8159,16 +9671,28 @@ export interface ModelConfig {
*/
'icon'?: string;
/**
- * Provider for the model
+ * Provider for the model. Matches the provider prefix of `key`.
*/
'provider'?: string;
/**
- * Whether the model is global
+ * Whether the model is in the LaunchDarkly global catalog. Global models are read-only. Model configs that you create are always custom, with `global` set to `false`.
*/
'global': boolean;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'params'?: object;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'customParams'?: object;
+ /**
+ * Tags for the model config. Tags can be used in custom role policies.
+ */
'tags': Array;
+ /**
+ * Version of the model config. Starts at 1, and each update that changes the model config adds a new version.
+ */
'version': number;
/**
* Cost per input token in USD
@@ -8183,10 +9707,17 @@ export interface ModelConfig {
*/
'costPerCachedInputToken'?: number;
/**
- * Whether the model is restricted
+ * Whether the model is on the project\'s restricted list. Config variations cannot select a restricted model. To change this, use the add or remove restricted models endpoints.
*/
'isRestricted': boolean;
+ /**
+ * Number of distinct AgentControl configs that reference this model
+ */
+ 'usedInCount'?: number;
}
+/**
+ * Fields to update. Omitted fields keep their current values. `params`, `customParams`, and `tags` replace the current values. Global model configs cannot be updated.
+ */
export interface ModelConfigPatch {
/**
* Immutable provider model identifier. To use a different model identifier, create a new model config.
@@ -8212,10 +9743,25 @@ export interface ModelConfigPatch {
* Cost per cached input token in USD
*/
'costPerCachedInputToken'?: number;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'params'?: object;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'customParams'?: object;
+ /**
+ * Tags for the model config. Replaces the current tags.
+ */
'tags'?: Array;
+ /**
+ * The member ID of the new maintainer. Set `maintainerId` or `maintainerTeamKey`, not both. An empty string removes the maintainer.
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team to set as the new maintainer. Set `maintainerId` or `maintainerTeamKey`, not both.
+ */
'maintainerTeamKey'?: string;
}
export interface ModelConfigPost {
@@ -8224,25 +9770,40 @@ export interface ModelConfigPost {
*/
'name': string;
/**
- * Unique key for the model
+ * Unique key for the model config in the project, in the format `Provider.model-id`. Config variations reject other formats. Keys of global catalog models are reserved.
*/
'key': string;
/**
- * Identifier for the model, for use with third party providers
+ * Model ID that the provider\'s API uses. Cannot be changed after creation.
*/
'id': string;
+ /**
+ * The member ID of the maintainer. Not applied on create. To set the maintainer, update the model config after you create it.
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains the model config. Not applied on create. To set the maintainer, update the model config after you create it.
+ */
'maintainerTeamKey'?: string;
/**
* Icon for the model
*/
'icon'?: string;
/**
- * Provider for the model
+ * Provider for the model. Use the provider prefix of `key`. Cannot be changed after creation.
*/
'provider'?: string;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'params'?: object;
+ /**
+ * Freeform JSON object. LaunchDarkly does not validate the keys. In a model config, `params` and `customParams` hold parameters that the provider\'s API accepts, for example `{\"temperature\": 0.7, \"maxTokens\": 4096}`.
+ */
'customParams'?: object;
+ /**
+ * Tags for the model config
+ */
'tags'?: Array;
/**
* Cost per input token in USD
@@ -8259,7 +9820,13 @@ export interface ModelConfigPost {
}
export interface ModelConfigs {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface ModelError {
@@ -8385,6 +9952,17 @@ export interface OauthClientPost {
*/
'description'?: string;
}
+export interface ObservabilityAlertSource {
+ 'type': ObservabilityAlertSourceTypeEnum;
+ 'alertId': number;
+}
+
+export const ObservabilityAlertSourceTypeEnum = {
+ ObservabilityAlert: 'observabilityAlert'
+} as const;
+
+export type ObservabilityAlertSourceTypeEnum = typeof ObservabilityAlertSourceTypeEnum[keyof typeof ObservabilityAlertSourceTypeEnum];
+
export interface OptionsArray {
'label'?: string;
'value'?: string;
@@ -8641,6 +10219,184 @@ export interface PhaseInfo {
*/
'releaseCount': number;
}
+export interface PipelineRelease {
+ /**
+ * The location and content type of related resources
+ */
+ '_links'?: { [key: string]: Link; };
+ /**
+ * The release pipeline name
+ */
+ 'name': string;
+ /**
+ * The release pipeline key
+ */
+ 'releasePipelineKey': string;
+ /**
+ * The release pipeline description
+ */
+ 'releasePipelineDescription': string;
+ /**
+ * An ordered list of the release pipeline phases
+ */
+ 'phases': Array;
+ /**
+ * The release version
+ */
+ '_version': number;
+ /**
+ * The chosen release variation ID to use across all phases of a release
+ */
+ '_releaseVariationId'?: string;
+ '_canceledAt'?: number;
+}
+export interface PipelineReleaseAudience {
+ /**
+ * The audience ID
+ */
+ '_id': string;
+ /**
+ * The location and content type of related resources
+ */
+ '_links'?: { [key: string]: Link; };
+ 'environment'?: EnvironmentSummary;
+ /**
+ * The release phase name
+ */
+ 'name': string;
+ 'configuration'?: AudienceConfiguration;
+ /**
+ * A list of segment keys
+ */
+ 'segmentKeys'?: Array;
+ 'status'?: string;
+ /**
+ * The rules IDs added or updated by this audience
+ */
+ '_ruleIds'?: Array;
+}
+export interface PipelineReleaseAudienceConfigInput {
+ /**
+ * UUID of the audience.
+ */
+ 'audienceId'?: string;
+ 'releaseGuardianConfiguration'?: PipelineReleaseGuardianConfigurationInput;
+ /**
+ * An array of member IDs. These members are notified to review the approval request.
+ */
+ 'notifyMemberIds'?: Array;
+ /**
+ * An array of team keys. The members of these teams are notified to review the approval request.
+ */
+ 'notifyTeamKeys'?: Array;
+}
+export interface PipelineReleaseGuardianConfiguration {
+ /**
+ * The monitoring window in milliseconds
+ */
+ 'monitoringWindowMilliseconds': number;
+ /**
+ * The rollout weight percentage
+ */
+ 'rolloutWeight': number;
+ /**
+ * Whether or not to roll back on regression
+ */
+ 'rollbackOnRegression': boolean;
+ /**
+ * The randomization unit for the measured rollout
+ */
+ 'randomizationUnit'?: string;
+}
+export interface PipelineReleaseGuardianConfigurationInput {
+ /**
+ * The monitoring window in milliseconds
+ */
+ 'monitoringWindowMilliseconds'?: number;
+ /**
+ * The rollout weight
+ */
+ 'rolloutWeight'?: number;
+ /**
+ * Whether or not to rollback on regression
+ */
+ 'rollbackOnRegression'?: boolean;
+ /**
+ * The randomization unit for the measured rollout
+ */
+ 'randomizationUnit'?: string;
+}
+export interface PipelineReleasePhase {
+ /**
+ * The phase ID
+ */
+ '_id': string;
+ /**
+ * The release phase name
+ */
+ '_name': string;
+ /**
+ * Whether this phase is complete
+ */
+ 'complete': boolean;
+ '_creationDate': number;
+ '_completionDate'?: number;
+ '_completedBy'?: CompletedBy;
+ /**
+ * A logical grouping of one or more environments that share attributes for rolling out changes
+ */
+ '_audiences': Array;
+ 'status'?: string;
+ /**
+ * Whether or not this phase has started
+ */
+ 'started'?: boolean;
+ '_startedDate'?: number;
+ 'configuration'?: object;
+}
+export interface PipelineReleaseProgression {
+ '_createdAt': number;
+ '_completedAt'?: number;
+ /**
+ * The flag key
+ */
+ 'flagKey': string;
+ /**
+ * The ID of the currently active release phase
+ */
+ 'activePhaseId'?: string;
+ 'activePhaseStatus'?: string;
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: Link; };
+}
+export interface PipelineReleaseProgressionCollection {
+ /**
+ * The number of active releases
+ */
+ 'activeCount': number;
+ /**
+ * The number of completed releases
+ */
+ 'completedCount': number;
+ /**
+ * A list of details for each release, across all flags, for this release pipeline
+ */
+ 'items': Array;
+ /**
+ * A list of details for each phase, across all releases, for this release pipeline
+ */
+ 'phases': Array;
+ /**
+ * The total number of releases for this release pipeline
+ */
+ 'totalCount': number;
+ /**
+ * The location and content type of related resources
+ */
+ '_links': { [key: string]: Link; };
+}
export interface PostApprovalRequestApplyRequest {
/**
* Optional comment about the approval request
@@ -8785,7 +10541,7 @@ export interface ProgressiveReleaseConfig {
*/
'rolloutContextKindKey'?: string;
/**
- * List of stages
+ * List of stages. At most 10 stages by default; the server enforces the per-account limit, which is never more than 20.
*/
'stages'?: Array;
}
@@ -8917,46 +10673,101 @@ export interface Projects {
'totalCount'?: number;
}
export interface PromptSnippet {
+ /**
+ * The prompt snippet key
+ */
'key': string;
'_access'?: AiConfigsAccess;
'_links'?: ParentAndSelfLinks;
+ '_site'?: CoreLink;
'_maintainer'?: AIConfigMaintainer;
+ /**
+ * The prompt snippet name
+ */
'name': string;
+ /**
+ * A description of the prompt snippet
+ */
'description'?: string;
/**
* The text content of the prompt snippet
*/
'text': string;
+ /**
+ * Tags for this resource
+ */
'tags': Array;
+ /**
+ * The version number of this resource
+ */
'version': number;
'createdAt': number;
}
export interface PromptSnippetPatch {
+ /**
+ * A human-readable name for the prompt snippet
+ */
'name'?: string;
+ /**
+ * A description of the prompt snippet
+ */
'description'?: string;
/**
* The text content of the prompt snippet
*/
'text'?: string;
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * Tags for this resource
+ */
'tags'?: Array;
}
export interface PromptSnippetPost {
+ /**
+ * A unique key for the prompt snippet
+ */
'key': string;
+ /**
+ * A human-readable name for the prompt snippet
+ */
'name': string;
+ /**
+ * A description of the prompt snippet
+ */
'description'?: string;
/**
* The text content of the prompt snippet
*/
'text': string;
+ /**
+ * The ID of the member who maintains this resource
+ */
'maintainerId'?: string;
+ /**
+ * The key of the team that maintains this resource
+ */
'maintainerTeamKey'?: string;
+ /**
+ * Tags for this resource
+ */
'tags'?: Array;
}
export interface PromptSnippets {
'_links'?: PaginatedLinks;
+ /**
+ * The items on this page
+ */
'items': Array;
+ /**
+ * The total number of items
+ */
'totalCount': number;
}
export interface PullRequestCollectionRep {
@@ -9095,9 +10906,21 @@ export interface PutReleasePolicyRequest {
export interface QuickStats {
+ /**
+ * Number of active AI Configs
+ */
'activeConfigs': number;
+ /**
+ * Number of active experiments on AI Configs
+ */
'activeExperiments': number;
+ /**
+ * Average satisfaction rating over the last 7 days
+ */
'averageSatisfaction7D'?: number | null;
+ /**
+ * Spend so far this month
+ */
'spendMonthToDate'?: number | null;
}
export interface RandomizationSettingsPut {
@@ -9177,7 +11000,7 @@ export interface RedshiftDataExportCompletedArtifactsRep {
*/
'sqlSetupScript'?: string;
/**
- * The auto-generated S3 staging bucket name.
+ * The S3 staging bucket name used by the destination. This is the customer-supplied bucket name, or the auto-generated name for destinations that did not set one.
*/
's3BucketName'?: string;
}
@@ -9245,98 +11068,33 @@ export interface RelayAutoConfigRep {
'creationDate': number;
'lastModified': number;
}
-export interface Release {
+export interface ReleaseHealthCheckFailure {
+ 'kind': ReleaseHealthCheckKind;
/**
- * The location and content type of related resources
- */
- '_links'?: { [key: string]: Link; };
- /**
- * The release pipeline name
- */
- 'name': string;
- /**
- * The release pipeline key
- */
- 'releasePipelineKey': string;
- /**
- * The release pipeline description
- */
- 'releasePipelineDescription': string;
- /**
- * An ordered list of the release pipeline phases
- */
- 'phases': Array;
- /**
- * The release version
- */
- '_version': number;
- /**
- * The chosen release variation ID to use across all phases of a release
- */
- '_releaseVariationId'?: string;
- '_canceledAt'?: number;
-}
-export interface ReleaseAudience {
- /**
- * The audience ID
- */
- '_id': string;
- /**
- * The location and content type of related resources
+ * The metric key associated with a metric event check.
*/
- '_links'?: { [key: string]: Link; };
- 'environment'?: EnvironmentSummary;
- /**
- * The release phase name
- */
- 'name': string;
- 'configuration'?: AudienceConfiguration;
- /**
- * A list of segment keys
- */
- 'segmentKeys'?: Array;
- 'status'?: string;
- /**
- * The rules IDs added or updated by this audience
- */
- '_ruleIds'?: Array;
-}
-export interface ReleaseGuardianConfiguration {
- /**
- * The monitoring window in milliseconds
- */
- 'monitoringWindowMilliseconds': number;
- /**
- * The rollout weight percentage
- */
- 'rolloutWeight': number;
- /**
- * Whether or not to roll back on regression
- */
- 'rollbackOnRegression': boolean;
- /**
- * The randomization unit for the measured rollout
- */
- 'randomizationUnit'?: string;
-}
-export interface ReleaseGuardianConfigurationInput {
- /**
- * The monitoring window in milliseconds
- */
- 'monitoringWindowMilliseconds'?: number;
- /**
- * The rollout weight
- */
- 'rolloutWeight'?: number;
- /**
- * Whether or not to rollback on regression
- */
- 'rollbackOnRegression'?: boolean;
+ 'metricKey'?: string;
/**
- * The randomization unit for the measured rollout
+ * A description of the failed health check.
*/
- 'randomizationUnit'?: string;
+ 'message': string;
}
+
+
+/**
+ * A release health check: - `flag_evaluations_any`: The flag has recently been evaluated. - `flag_evaluations_with_context`: The flag has recently been evaluated for contexts of the `randomizationUnit` kind. - `metric_events_any`: Guarded releases only. The metric has received events. - `metric_events_with_context`: Guarded releases only. The metric has received events for contexts of the `randomizationUnit` kind.
+ */
+
+export const ReleaseHealthCheckKind = {
+ ReleaseHealthCheckKindFlagEvaluationsAny: 'flag_evaluations_any',
+ ReleaseHealthCheckKindFlagEvaluationsWithContext: 'flag_evaluations_with_context',
+ ReleaseHealthCheckKindMetricEventsAny: 'metric_events_any',
+ ReleaseHealthCheckKindMetricEventsWithContext: 'metric_events_with_context'
+} as const;
+
+export type ReleaseHealthCheckKind = typeof ReleaseHealthCheckKind[keyof typeof ReleaseHealthCheckKind];
+
+
/**
* The release method for this policy
*/
@@ -9350,34 +11108,31 @@ export const ReleaseMethod = {
export type ReleaseMethod = typeof ReleaseMethod[keyof typeof ReleaseMethod];
-export interface ReleasePhase {
- /**
- * The phase ID
- */
- '_id': string;
- /**
- * The release phase name
- */
- '_name': string;
- /**
- * Whether this phase is complete
- */
- 'complete': boolean;
- '_creationDate': number;
- '_completionDate'?: number;
- '_completedBy'?: CompletedBy;
+/**
+ * A metric shared by every phase of a guarded release.
+ */
+export interface ReleaseMetric {
+ 'metricKey': string;
+ 'metricVersionId'?: string;
/**
- * A logical grouping of one or more environments that share attributes for rolling out changes
+ * Whether a regression automatically reverts the release.
*/
- '_audiences': Array;
- 'status'?: string;
+ 'autoRollback': boolean;
/**
- * Whether or not this phase has started
+ * Present only when the caller requests `expand=metrics` and the pinned metric version still exists. A metric whose pinned version has been deleted keeps its `metricKey` and `metricVersionId` but has no definition.
*/
- 'started'?: boolean;
- '_startedDate'?: number;
- 'configuration'?: object;
+ 'definition'?: EnvironmentReleasesMetricListingRep;
}
+
+export const ReleaseMetricStatus = {
+ ReleaseMetricStatusOK: 'ok',
+ ReleaseMetricStatusRegressed: 'regressed',
+ ReleaseMetricStatusRegressionDismissed: 'regression_dismissed'
+} as const;
+
+export type ReleaseMetricStatus = typeof ReleaseMetricStatus[keyof typeof ReleaseMetricStatus];
+
+
export interface ReleasePipeline {
/**
* Timestamp of when the release pipeline was created
@@ -9546,7 +11301,7 @@ export interface ReleasePolicyScope {
*/
'environmentKeys'?: Array;
/**
- * List of flag tag keys this policy applies to
+ * List of flag tag keys this policy applies to. At most 1000 keys. Each key must only contain letters, numbers, \'-\', \'_\', or \'.\', and be at most 64 characters.
*/
'flagTagKeys'?: Array;
}
@@ -9554,64 +11309,73 @@ export interface ReleasePolicyStage {
'allocation': number;
'durationMillis': number;
}
-export interface ReleaseProgression {
- '_createdAt': number;
- '_completedAt'?: number;
- /**
- * The flag key
- */
- 'flagKey': string;
- /**
- * The ID of the currently active release phase
- */
- 'activePhaseId'?: string;
- 'activePhaseStatus'?: string;
- /**
- * The location and content type of related resources
- */
- '_links': { [key: string]: Link; };
-}
-export interface ReleaseProgressionCollection {
- /**
- * The number of active releases
- */
- 'activeCount': number;
- /**
- * The number of completed releases
- */
- 'completedCount': number;
- /**
- * A list of details for each release, across all flags, for this release pipeline
- */
- 'items': Array;
- /**
- * A list of details for each phase, across all releases, for this release pipeline
- */
- 'phases': Array;
- /**
- * The total number of releases for this release pipeline
- */
- 'totalCount': number;
+/**
+ * High-level status of an environment release or release phase. - `pending`: The release or phase has not started. - `in_progress`: The release or phase is progressing without requiring action. - `waiting`: The release is partially rolled out, but is paused and waiting for action from the user. - `completed`: The release or phase reached the target variation. - `reverted`: The release or phase returned to the original variation.
+ */
+
+export const ReleaseStatus = {
+ ReleaseStatusPending: 'pending',
+ ReleaseStatusInProgress: 'in_progress',
+ ReleaseStatusWaiting: 'waiting',
+ ReleaseStatusCompleted: 'completed',
+ ReleaseStatusReverted: 'reverted'
+} as const;
+
+export type ReleaseStatus = typeof ReleaseStatus[keyof typeof ReleaseStatus];
+
+
+/**
+ * Additional detail for a `waiting`, `completed`, or `reverted` status. The field may be absent for a `waiting` status when there is no specific reason. `waiting_phase_ended` appears only on the release, never on a phase. It means a phase of a multi-phase release with `advancementMode` `manual` ended and the release must be advanced to the next phase. `reverted_discarded` means the phase ended without a regression or a member rolling it back. A running phase is discarded when the flag changes underneath it, for example when the flag is turned off, archived, or deleted. A pending phase is discarded when the release ends before it starts, either because an earlier phase reverted or because the release was stopped with a resolution that removes pending phases. A release reports `reverted_discarded` only when the last phase that started was discarded.
+ */
+
+export const ReleaseStatusReason = {
+ ReleaseStatusReasonWaitingRegressionDetected: 'waiting_regression_detected',
+ ReleaseStatusReasonWaitingPhaseEnded: 'waiting_phase_ended',
+ ReleaseStatusReasonCompletedAutomatic: 'completed_automatic',
+ ReleaseStatusReasonCompletedManual: 'completed_manual',
+ ReleaseStatusReasonRevertedRegressionDetected: 'reverted_regression_detected',
+ ReleaseStatusReasonRevertedManual: 'reverted_manual',
+ ReleaseStatusReasonRevertedDiscarded: 'reverted_discarded',
+ ReleaseStatusReasonRevertedInsufficientData: 'reverted_insufficient_data'
+} as const;
+
+export type ReleaseStatusReason = typeof ReleaseStatusReason[keyof typeof ReleaseStatusReason];
+
+
+/**
+ * One step in a phase\'s rollout schedule.
+ */
+export interface ReleaseStep {
/**
- * The location and content type of related resources
+ * Zero-based index of this step.
*/
- '_links': { [key: string]: Link; };
-}
-export interface ReleaserAudienceConfigInput {
+ 'stepIndex': number;
/**
- * UUID of the audience.
+ * Thousandths of a percent. `100000` is 100%, and `10000` is 10%. Guarded releases cannot exceed `50000`, preserving a control group.
*/
- 'audienceId'?: string;
- 'releaseGuardianConfiguration'?: ReleaseGuardianConfigurationInput;
+ 'allocation': number;
+ 'durationMillis': number;
/**
- * An array of member IDs. These members are notified to review the approval request.
+ * Start of the step in Unix milliseconds.
*/
- 'notifyMemberIds'?: Array;
+ 'startedAt'?: number;
/**
- * An array of team keys. The members of these teams are notified to review the approval request.
+ * End of the step in Unix milliseconds.
*/
- 'notifyTeamKeys'?: Array;
+ 'endedAt'?: number;
}
+/**
+ * Whether the release uses metric monitoring.
+ */
+
+export const ReleaseType = {
+ ReleaseTypeProgressive: 'progressive',
+ ReleaseTypeGuarded: 'guarded'
+} as const;
+
+export type ReleaseType = typeof ReleaseType[keyof typeof ReleaseType];
+
+
export interface RepositoryCollectionRep {
'_links': { [key: string]: Link; };
/**
@@ -9742,15 +11506,33 @@ export interface ResourceSummary {
'totalCount': number;
}
export interface RestrictedModelError {
+ /**
+ * The model config key that was not added
+ */
'key': string;
+ /**
+ * Why the key was not added. A key that a config variation uses cannot be restricted. Move those variations to a different model first.
+ */
'message': string;
+ /**
+ * HTTP status code for this key. `400` means a config variation uses the key. `404` means the key does not exist in the project.
+ */
'code': number;
}
export interface RestrictedModelsRequest {
+ /**
+ * Model config keys, not provider model IDs. Get keys from the list AI model configs endpoint.
+ */
'keys': Array;
}
export interface RestrictedModelsResponse {
+ /**
+ * Model config keys that were added to the restricted list
+ */
'successes': Array;
+ /**
+ * Model config keys that were not added, with the reason for each key
+ */
'errors': Array;
}
export interface ReviewOutput {
@@ -9822,7 +11604,7 @@ export interface Rule {
*/
'clauses': Array;
/**
- * Whether LaunchDarkly tracks events for this rule
+ * Whether the SDK sends a detailed event for every evaluation of this rule, instead of only summary counts. Required for Data Export, but doesn\'t enable Data Export on its own.
*/
'trackEvents': boolean;
/**
@@ -9991,6 +11773,10 @@ export interface SdkKeyListItem {
*/
'_version': number;
'environmentSummary'?: SdkKeysEnvironmentSummary;
+ /**
+ * Summaries of views associated with the SDK key.
+ */
+ 'viewSummaries'?: Array;
}
@@ -10023,6 +11809,10 @@ export interface SdkKeyPost {
*/
'description'?: string;
'expiry'?: number;
+ /**
+ * List of view keys to associate with the SDK key.
+ */
+ 'viewKeys'?: Array;
}
export const SdkKeyPostKindEnum = {
@@ -10032,6 +11822,20 @@ export const SdkKeyPostKindEnum = {
export type SdkKeyPostKindEnum = typeof SdkKeyPostKindEnum[keyof typeof SdkKeyPostKindEnum];
+export interface SdkKeyViewsPut {
+ /**
+ * The complete target list of view keys to associate with this SDK key. An empty array removes all views from the SDK key.
+ */
+ 'viewKeys': Array;
+}
+export interface SdkKeys {
+ '_links'?: SdkKeysSelfLink;
+ 'items': Array;
+ /**
+ * The total number of SDK keys matching the query, before pagination.
+ */
+ 'totalCount': number;
+}
export interface SdkKeysEnvironmentSummary {
/**
* The location and content type of related resources
@@ -10248,6 +12052,9 @@ export interface SnippetReferences {
* The type of the resource being referenced.
*/
'resourceType': string;
+ /**
+ * The resources that reference this prompt snippet
+ */
'items': Array;
/**
* The total number of references.
@@ -10319,6 +12126,62 @@ export interface StaleFlagData {
*/
'cleanupId'?: string;
}
+export interface StartEnvironmentReleaseBadRequest {
+ 'code': string;
+ 'message': string;
+ /**
+ * Present when `code` is `health_checks_failed`.
+ */
+ 'failingChecks'?: Array;
+}
+export interface StartEnvironmentReleaseRequest {
+ /**
+ * Insert the newly created rule or phase rules before this rule. If omitted, append them to the end of the rule list.
+ */
+ 'beforeRuleId'?: string;
+ /**
+ * ID of the variation the release starts from. The release gradually moves traffic from it to the target variation, and moves traffic back to it if the release reverts.
+ */
+ 'originalVariationId': string;
+ /**
+ * ID of the variation being released. The release gradually moves traffic to it from the original variation, and moves traffic back to the original variation if the release reverts.
+ */
+ 'targetVariationId': string;
+ /**
+ * Key of an environment release plan in this environment. The plan supplies `randomizationUnit`, `phases`, `metrics`, `advancementMode`, and `cleanupBehavior`, so omit them. Omit this field to configure the release inline.
+ */
+ 'releasePlanKey'?: string;
+ /**
+ * Key of an existing, non-archived context kind in the project that the release randomizes on, such as `user`. Each phase\'s rule must include the clause `{\"contextKind\": \"\", \"attribute\": \"kind\", \"op\": \"in\", \"values\": [\"\"]}`. Required unless `releasePlanKey` is set.
+ */
+ 'randomizationUnit'?: string;
+ /**
+ * How the release moves between phases. Required when `phases` has more than one entry; a single-phase release ignores it and may omit it. Omit when `releasePlanKey` is set.
+ */
+ 'advancementMode'?: EnvironmentReleaseAdvancementMode;
+ /**
+ * Ordered phases of the release. Required unless `releasePlanKey` is set.
+ */
+ 'phases'?: Array;
+ /**
+ * Metrics shared by every phase. Omit or pass an empty array for a progressive release. Metric groups cannot be listed inline; a release plan\'s metric groups expand into their member metrics at start. Omit when `releasePlanKey` is set.
+ */
+ 'metrics'?: Array;
+ /**
+ * Health check kinds that do not block this request. LaunchDarkly still runs and enforces every health check kind not listed here.
+ */
+ 'bypassHealthChecks'?: Set;
+ /**
+ * What happens to the release rules after the release completes. Omit for `leave_rules_in_place`. Omit when `releasePlanKey` is set.
+ */
+ 'cleanupBehavior'?: CleanupBehavior;
+ /**
+ * Optional comment written to the flag\'s audit-log entry.
+ */
+ 'comment'?: string;
+}
+
+
export interface Statement {
/**
* Resource specifier strings
@@ -10471,6 +12334,15 @@ export interface StatusServiceUnavailable {
*/
'message': string;
}
+export interface StopEnvironmentReleaseRequest {
+ 'resolution': EnvironmentReleaseResolution;
+ /**
+ * Optional comment written to the flag\'s audit-log entry.
+ */
+ 'comment'?: string;
+}
+
+
export interface StoreIntegrationError {
'statusCode'?: number;
'message'?: string;
@@ -10752,6 +12624,7 @@ export interface Token {
*/
'defaultApiVersion'?: number;
'lastUsed'?: number;
+ 'expiry'?: number;
}
export interface TokenSummary {
'_links'?: { [key: string]: Link; };
@@ -10819,6 +12692,9 @@ export interface ToolReferences {
* The type of the resource being referenced.
*/
'resourceType': string;
+ /**
+ * The resources that reference this tool
+ */
'items': Array;
/**
* The total number of references.
@@ -11004,12 +12880,16 @@ export interface UnlinkResourceSuccessResponse {
*/
'failedResources'?: Array;
}
+export interface UpdateAdaptiveTriggerRequest {
+ 'name'?: string;
+ 'task'?: AdaptiveTriggerTask;
+}
export interface UpdatePhaseStatusInput {
'status'?: string;
/**
* Extra configuration for audiences required upon phase initialization.
*/
- 'audiences'?: Array;
+ 'audiences'?: Array;
}
export interface UpdateReleasePipelineInput {
/**
@@ -11642,7 +13522,7 @@ export interface ViewPatch {
}
export interface ViewPost {
/**
- * Unique key for the view within the account/project
+ * Unique key for the view within the account/project. The key is converted to lowercase when the view is created, so use the lowercase form to reference the view afterward.
*/
'key': string;
/**
@@ -11860,7 +13740,7 @@ export interface WarehouseDestinationSetupScriptRep {
*/
'redshiftIAMTrustPolicy'?: string;
/**
- * The auto-generated S3 staging bucket name (ClickHouse and Redshift)
+ * The S3 staging bucket name (ClickHouse and Redshift). For Redshift this is the name chosen for setup, a previously saved name, or an auto-generated default.
*/
's3BucketName'?: string;
}
@@ -11992,241 +13872,6 @@ export interface WorkflowTemplatesListingOutputRep {
'items': Array;
}
-/**
- * AIConfigsApi - axios parameter creator
- */
-export const AIConfigsApiAxiosParamCreator = function (configuration?: Configuration) {
- return {
- /**
- * Get all AgentControl config variations that currently reference this tool.
- * @summary List AI tool references
- * @param {string} projectKey
- * @param {string} toolKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- listAIToolReferences: async (projectKey: string, toolKey: string, limit?: number, offset?: number, options: RawAxiosRequestConfig = {}): Promise => {
- // verify required parameter 'projectKey' is not null or undefined
- assertParamExists('listAIToolReferences', 'projectKey', projectKey)
- // verify required parameter 'toolKey' is not null or undefined
- assertParamExists('listAIToolReferences', 'toolKey', toolKey)
- const localVarPath = `/api/v2/projects/{projectKey}/ai-tools/{toolKey}/references`
- .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
- .replace(`{${"toolKey"}}`, encodeURIComponent(String(toolKey)));
- // use dummy base URL string because the URL constructor only accepts absolute URLs.
- const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
- let baseOptions;
- if (configuration) {
- baseOptions = configuration.baseOptions;
- }
-
- const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
- const localVarHeaderParameter = {} as any;
- const localVarQueryParameter = {} as any;
-
- // authentication ApiKey required
- await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
-
- if (limit !== undefined) {
- localVarQueryParameter['limit'] = limit;
- }
-
- if (offset !== undefined) {
- localVarQueryParameter['offset'] = offset;
- }
-
- localVarHeaderParameter['Accept'] = 'application/json';
-
- // CUSTOM-START
- // Set default API version.
- localVarHeaderParameter['LD-API-Version'] = '20240415';
- // Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
- // CUSTOM-END
-
- setSearchParams(localVarUrlObj, localVarQueryParameter);
- let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
- localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
-
- return {
- url: toPathString(localVarUrlObj),
- options: localVarRequestOptions,
- };
- },
- /**
- * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- listAgentOptimizationRuns: async (projectKey: string, optimizationKey: string, limit?: number, offset?: number, options: RawAxiosRequestConfig = {}): Promise => {
- // verify required parameter 'projectKey' is not null or undefined
- assertParamExists('listAgentOptimizationRuns', 'projectKey', projectKey)
- // verify required parameter 'optimizationKey' is not null or undefined
- assertParamExists('listAgentOptimizationRuns', 'optimizationKey', optimizationKey)
- const localVarPath = `/api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/runs`
- .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
- .replace(`{${"optimizationKey"}}`, encodeURIComponent(String(optimizationKey)));
- // use dummy base URL string because the URL constructor only accepts absolute URLs.
- const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
- let baseOptions;
- if (configuration) {
- baseOptions = configuration.baseOptions;
- }
-
- const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
- const localVarHeaderParameter = {} as any;
- const localVarQueryParameter = {} as any;
-
- // authentication ApiKey required
- await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
-
- if (limit !== undefined) {
- localVarQueryParameter['limit'] = limit;
- }
-
- if (offset !== undefined) {
- localVarQueryParameter['offset'] = offset;
- }
-
- localVarHeaderParameter['Accept'] = 'application/json';
-
- // CUSTOM-START
- // Set default API version.
- localVarHeaderParameter['LD-API-Version'] = '20240415';
- // Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
- // CUSTOM-END
-
- setSearchParams(localVarUrlObj, localVarQueryParameter);
- let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
- localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
-
- return {
- url: toPathString(localVarUrlObj),
- options: localVarRequestOptions,
- };
- },
- }
-};
-
-/**
- * AIConfigsApi - functional programming interface
- */
-export const AIConfigsApiFp = function(configuration?: Configuration) {
- const localVarAxiosParamCreator = AIConfigsApiAxiosParamCreator(configuration)
- return {
- /**
- * Get all AgentControl config variations that currently reference this tool.
- * @summary List AI tool references
- * @param {string} projectKey
- * @param {string} toolKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- async listAIToolReferences(projectKey: string, toolKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.listAIToolReferences(projectKey, toolKey, limit, offset, options);
- const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
- const localVarOperationServerBasePath = operationServerMap['AIConfigsApi.listAIToolReferences']?.[localVarOperationServerIndex]?.url;
- return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
- },
- /**
- * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- async listAgentOptimizationRuns(projectKey: string, optimizationKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.listAgentOptimizationRuns(projectKey, optimizationKey, limit, offset, options);
- const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
- const localVarOperationServerBasePath = operationServerMap['AIConfigsApi.listAgentOptimizationRuns']?.[localVarOperationServerIndex]?.url;
- return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
- },
- }
-};
-
-/**
- * AIConfigsApi - factory interface
- */
-export const AIConfigsApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
- const localVarFp = AIConfigsApiFp(configuration)
- return {
- /**
- * Get all AgentControl config variations that currently reference this tool.
- * @summary List AI tool references
- * @param {string} projectKey
- * @param {string} toolKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- listAIToolReferences(projectKey: string, toolKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): AxiosPromise {
- return localVarFp.listAIToolReferences(projectKey, toolKey, limit, offset, options).then((request) => request(axios, basePath));
- },
- /**
- * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- listAgentOptimizationRuns(projectKey: string, optimizationKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): AxiosPromise {
- return localVarFp.listAgentOptimizationRuns(projectKey, optimizationKey, limit, offset, options).then((request) => request(axios, basePath));
- },
- };
-};
-
-/**
- * AIConfigsApi - object-oriented interface
- */
-export class AIConfigsApi extends BaseAPI {
- /**
- * Get all AgentControl config variations that currently reference this tool.
- * @summary List AI tool references
- * @param {string} projectKey
- * @param {string} toolKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- public listAIToolReferences(projectKey: string, toolKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig) {
- return AIConfigsApiFp(this.configuration).listAIToolReferences(projectKey, toolKey, limit, offset, options).then((request) => request(this.axios, this.basePath));
- }
-
- /**
- * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {number} [limit] The number of resources to return.
- * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- public listAgentOptimizationRuns(projectKey: string, optimizationKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig) {
- return AIConfigsApiFp(this.configuration).listAgentOptimizationRuns(projectKey, optimizationKey, limit, offset, options).then((request) => request(this.axios, this.basePath));
- }
-}
-
-
-
/**
* AccessTokensApi - axios parameter creator
*/
@@ -12264,7 +13909,7 @@ export const AccessTokensApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12308,7 +13953,7 @@ export const AccessTokensApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12363,7 +14008,7 @@ export const AccessTokensApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12411,7 +14056,7 @@ export const AccessTokensApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12456,7 +14101,7 @@ export const AccessTokensApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12470,11 +14115,12 @@ export const AccessTokensApiAxiosParamCreator = function (configuration?: Config
};
},
/**
- * Reset an access token\'s secret key with an optional expiry time for the old key.
- * @summary Reset access token
+ * Reset an access token\'s secret key with an optional expiry time for the old key. Use of this legacy handler is discouraged. Patch the `expiry` field on the token directly instead.
+ * @summary Reset access token (legacy)
* @param {string} id The ID of the access token to update
* @param {number} [expiry] An expiration time for the old token key, expressed as a Unix epoch time in milliseconds. By default, the token will expire immediately.
* @param {*} [options] Override http request option.
+ * @deprecated
* @throws {RequiredError}
*/
resetToken: async (id: string, expiry?: number, options: RawAxiosRequestConfig = {}): Promise => {
@@ -12506,7 +14152,7 @@ export const AccessTokensApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12596,11 +14242,12 @@ export const AccessTokensApiFp = function(configuration?: Configuration) {
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
/**
- * Reset an access token\'s secret key with an optional expiry time for the old key.
- * @summary Reset access token
+ * Reset an access token\'s secret key with an optional expiry time for the old key. Use of this legacy handler is discouraged. Patch the `expiry` field on the token directly instead.
+ * @summary Reset access token (legacy)
* @param {string} id The ID of the access token to update
* @param {number} [expiry] An expiration time for the old token key, expressed as a Unix epoch time in milliseconds. By default, the token will expire immediately.
* @param {*} [options] Override http request option.
+ * @deprecated
* @throws {RequiredError}
*/
async resetToken(id: string, expiry?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
@@ -12672,11 +14319,12 @@ export const AccessTokensApiFactory = function (configuration?: Configuration, b
return localVarFp.postToken(accessTokenPost, options).then((request) => request(axios, basePath));
},
/**
- * Reset an access token\'s secret key with an optional expiry time for the old key.
- * @summary Reset access token
+ * Reset an access token\'s secret key with an optional expiry time for the old key. Use of this legacy handler is discouraged. Patch the `expiry` field on the token directly instead.
+ * @summary Reset access token (legacy)
* @param {string} id The ID of the access token to update
* @param {number} [expiry] An expiration time for the old token key, expressed as a Unix epoch time in milliseconds. By default, the token will expire immediately.
* @param {*} [options] Override http request option.
+ * @deprecated
* @throws {RequiredError}
*/
resetToken(id: string, expiry?: number, options?: RawAxiosRequestConfig): AxiosPromise {
@@ -12748,11 +14396,12 @@ export class AccessTokensApi extends BaseAPI {
}
/**
- * Reset an access token\'s secret key with an optional expiry time for the old key.
- * @summary Reset access token
+ * Reset an access token\'s secret key with an optional expiry time for the old key. Use of this legacy handler is discouraged. Patch the `expiry` field on the token directly instead.
+ * @summary Reset access token (legacy)
* @param {string} id The ID of the access token to update
* @param {number} [expiry] An expiration time for the old token key, expressed as a Unix epoch time in milliseconds. By default, the token will expire immediately.
* @param {*} [options] Override http request option.
+ * @deprecated
* @throws {RequiredError}
*/
public resetToken(id: string, expiry?: number, options?: RawAxiosRequestConfig) {
@@ -12799,7 +14448,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12848,7 +14497,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12913,7 +14562,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -12961,7 +14610,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13006,7 +14655,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13055,7 +14704,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13069,7 +14718,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
};
},
/**
- * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
+ * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. You can assign new members to teams with the `teamKeys` field. Teams are available only on Enterprise plans. If your plan does not include teams, a request that includes a non-empty `teamKeys` field returns an HTTP response code of 403 (Forbidden). Omit `teamKeys` to invite members without assigning them to a team. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
* @summary Invite new members
* @param {Array} newMemberForm
* @param {*} [options] Override http request option.
@@ -13100,7 +14749,7 @@ export const AccountMembersApiAxiosParamCreator = function (configuration?: Conf
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13208,7 +14857,7 @@ export const AccountMembersApiFp = function(configuration?: Configuration) {
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
/**
- * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
+ * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. You can assign new members to teams with the `teamKeys` field. Teams are available only on Enterprise plans. If your plan does not include teams, a request that includes a non-empty `teamKeys` field returns an HTTP response code of 403 (Forbidden). Omit `teamKeys` to invite members without assigning them to a team. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
* @summary Invite new members
* @param {Array} newMemberForm
* @param {*} [options] Override http request option.
@@ -13297,7 +14946,7 @@ export const AccountMembersApiFactory = function (configuration?: Configuration,
return localVarFp.postMemberTeams(id, memberTeamsPostInput, options).then((request) => request(axios, basePath));
},
/**
- * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
+ * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. You can assign new members to teams with the `teamKeys` field. Teams are available only on Enterprise plans. If your plan does not include teams, a request that includes a non-empty `teamKeys` field returns an HTTP response code of 403 (Forbidden). Omit `teamKeys` to invite members without assigning them to a team. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
* @summary Invite new members
* @param {Array} newMemberForm
* @param {*} [options] Override http request option.
@@ -13387,7 +15036,7 @@ export class AccountMembersApi extends BaseAPI {
}
/**
- * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
+ * Invite one or more new members to join an account. Each member is sent an invitation. Members with Admin or Owner roles may create new members, as well as anyone with a `createMember` permission for \"member/\\*\". If a member cannot be invited, the entire request is rejected and no members are invited from that request. Each member _must_ have an `email` field and either a `role` or a `customRoles` field. If any of the fields are not populated correctly, the request is rejected with the reason specified in the \"message\" field of the response. Valid base role names that you can provide for the `role` field include `reader`, `writer`, `admin`, `owner/admin`, and `no_access`. To learn more about base roles, read [Organization roles](https://launchdarkly.com/docs/home/account/roles/organization-roles). If you are using the `customRoles` field instead, you can provide the key for any role that you have created, or for any preset [organization role](https://launchdarkly.com/docs/home/account/roles/organization-roles) or [project role](https://launchdarkly.com/docs/home/account/roles/project-roles) provided by LaunchDarkly. Some preset roles additionally require that you specify `roleAttributes`. To learn more, read [Using role scope](https://launchdarkly.com/docs/home/account/roles/role-scope). Requests to create account members will not work if SCIM is enabled for the account. You can assign new members to teams with the `teamKeys` field. Teams are available only on Enterprise plans. If your plan does not include teams, a request that includes a non-empty `teamKeys` field returns an HTTP response code of 403 (Forbidden). Omit `teamKeys` to invite members without assigning them to a team. _No more than 50 members may be created per request._ A request may also fail because of conflicts with existing members. These conflicts are reported using the additional `code` and `invalid_emails` response fields with the following possible values for `code`: - **email_already_exists_in_account**: A member with this email address already exists in this account. - **email_taken_in_different_account**: A member with this email address exists in another account. - **duplicate_email**s: This request contains two or more members with the same email address. A request that fails for one of the above reasons returns an HTTP response code of 400 (Bad Request).
* @summary Invite new members
* @param {Array} newMemberForm
* @param {*} [options] Override http request option.
@@ -13483,7 +15132,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13573,7 +15222,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13663,7 +15312,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13758,7 +15407,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13771,20 +15420,21 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
};
},
/**
- * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days.
+ * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days. `groupBy=projectId` resolves legacy rows through the account\'s current environment-to-project mapping and returns `409` instead of a partial series when any successful row remains unattributed. Plain project filtering keeps its current-environment compatibility behavior.
* @summary Get data export events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `groupBy=projectId`, filters to the project\'s current environments so retained pre-materialization usage remains visible. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `environmentId`, `eventKind`.
+ * @param {string} [destinationKind] A Streaming configuration kind to filter results by. Values preserve raw product identity; `snowflake` is legacy Streaming Snowflake and is distinct from Warehouse `snowflake-v2`. Can be specified multiple times.<br/>Valid values: `kinesis`, `google-pubsub`, `mparticle`, `segment`, `azure-event-hubs`, `snowflake`, `unknown`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension. `projectId` requires one or more explicit `projectKey` filters and is capped at 100 selected projects. `destinationId` returns one series per streaming destination with `destinationName` metadata, plus `destinationViewable` when the destination is in the current configuration. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. A destination ID absent from the current configuration is named `Unknown historical destination`. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.<br/>Valid values: `projectId`, `environmentId`, `eventKind`, `destinationKind`, `destinationId`.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- getDataExportEventsUsage: async (from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options: RawAxiosRequestConfig = {}): Promise => {
+ getDataExportEventsUsage: async (from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, destinationKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options: RawAxiosRequestConfig = {}): Promise => {
const localVarPath = `/api/v2/usage/data-export-events`;
// use dummy base URL string because the URL constructor only accepts absolute URLs.
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -13820,6 +15470,10 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
localVarQueryParameter['eventKind'] = eventKind;
}
+ if (destinationKind !== undefined) {
+ localVarQueryParameter['destinationKind'] = destinationKind;
+ }
+
if (groupBy !== undefined) {
localVarQueryParameter['groupBy'] = groupBy;
}
@@ -13838,7 +15492,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13851,7 +15505,91 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
};
},
/**
- * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
+ * Rank projects with usage in the requested range by successful Streaming transfers. Legacy rows are attributed through the account\'s complete current environment-to-project mapping. If any successful row remains unattributed after resolution, the operation returns `409` instead of a partial ranking. The result limit does not cap the account-wide project universe or environment mapping. This source-specific operation does not provide Combined or Warehouse ranking.
+ * @summary Rank Streaming usage by project
+ * @param {number} from Inclusive UTC range start in Unix milliseconds.
+ * @param {number} to Exclusive UTC range end in Unix milliseconds.
+ * @param {string} [source] The source scope. Only `streaming` is supported.
+ * @param {string} [dimension] The ranking dimension. Only `project` is supported.
+ * @param {Array} [projectKey] A canonical project key to include. Can be specified multiple times, with at most 100 unique explicit selections; duplicates do not consume the limit. When omitted, all account projects with usage in the requested range are ranked.
+ * @param {string} [search] A case-insensitive substring matched against canonical project keys before querying usage. Project names are not searched.
+ * @param {string} [cursor] An opaque cursor returned by a previous response. Cursors are bound to the account and ranking inputs.
+ * @param {number} [limit] The maximum number of ranked projects to return. This bounds response rows and look-ahead, not the account-wide candidate universe.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ getDataExportProjectRanking: async (from: number, to: number, source?: string, dimension?: string, projectKey?: Array, search?: string, cursor?: string, limit?: number, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'from' is not null or undefined
+ assertParamExists('getDataExportProjectRanking', 'from', from)
+ // verify required parameter 'to' is not null or undefined
+ assertParamExists('getDataExportProjectRanking', 'to', to)
+ const localVarPath = `/api/v2/usage/data-export-events/projects/ranking`;
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ if (from !== undefined) {
+ localVarQueryParameter['from'] = from;
+ }
+
+ if (to !== undefined) {
+ localVarQueryParameter['to'] = to;
+ }
+
+ if (source !== undefined) {
+ localVarQueryParameter['source'] = source;
+ }
+
+ if (dimension !== undefined) {
+ localVarQueryParameter['dimension'] = dimension;
+ }
+
+ if (projectKey) {
+ localVarQueryParameter['projectKey'] = projectKey;
+ }
+
+ if (search !== undefined) {
+ localVarQueryParameter['search'] = search;
+ }
+
+ if (cursor !== undefined) {
+ localVarQueryParameter['cursor'] = cursor;
+ }
+
+ if (limit !== undefined) {
+ localVarQueryParameter['limit'] = limit;
+ }
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the returned data depends on the length of the requested time range: ranges shorter than two hours return minutely data, ranges shorter than two days return hourly data, and ranges of two days or longer return daily data. Minutely data is retained for 70 days; a range shorter than two hours that starts before then is returned at hourly granularity instead, with the start of the range widened to the containing hour. Ranges that predate available data return an empty series list. If a flag has served many distinct variation values in the requested range, the least recently seen values may be aggregated into a single additional series labeled \"Other Variations\".
* @summary Get evaluations usage
* @param {string} projectKey The project key
* @param {string} environmentKey The environment key
@@ -13905,7 +15643,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13959,7 +15697,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -13976,7 +15714,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
* @summary Get experimentation events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters to the project\'s current environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKey] An event key to filter results by. Can be specified multiple times, one query parameter per event key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
@@ -14044,7 +15782,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14061,7 +15799,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
* @summary Get experimentation keys usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters by project, including projects that currently have no environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [experimentId] An experiment ID to filter results by. Can be specified multiple times, one query parameter per experiment ID.
* @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `experimentId`.
@@ -14124,7 +15862,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14209,7 +15947,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14299,7 +16037,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14354,7 +16092,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14445,7 +16183,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14496,7 +16234,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14561,7 +16299,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14626,7 +16364,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14691,7 +16429,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14756,7 +16494,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14821,7 +16559,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14891,7 +16629,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14931,7 +16669,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -14954,9 +16692,9 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
* @param {string} [relayVersion] A relay version to filter results by. Can be specified multiple times, one query parameter per relay version.
* @param {string} [sdkName] An SDK name to filter results by. Can be specified multiple times, one query parameter per SDK name.
* @param {string} [sdkVersion] An SDK version to filter results by. Can be specified multiple times, one query parameter per SDK version.
- * @param {string} [sdkType] An SDK type to filter results by. Can be specified multiple times, one query parameter per SDK type.
+ * @param {string} [sdkType] Deprecated. This endpoint reports server-side connections only, so `server` is the only value that returns data and omitting the parameter is equivalent. Any other value returns an empty series. To report client-side connections, use `GET /api/v2/usage/streams/{source}`.
* @param {string} [sdkAppId] An SDK app ID to filter results by. Can be specified multiple times, one query parameter per SDK app ID.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkType`, `sdkAppId`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkAppId`.<br/>`sdkType` is no longer offered: this endpoint reports server-side connections only, so grouping by it returns a single group. It is still accepted, for compatibility.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
@@ -15036,7 +16774,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -15095,7 +16833,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -15164,7 +16902,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -15208,7 +16946,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -15273,7 +17011,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -15292,14 +17030,15 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
* @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
- * @param {string} [destination] A destination kind to filter results by. Can be specified multiple times, one query parameter per destination kind.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `destination`.
+ * @param {string} [destinationKind] A Warehouse configuration kind to filter results by. Cannot be combined with `destination`. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`, `s3`.
+ * @param {string} [destination] A Warehouse configuration kind to filter results by. Cannot be combined with `destinationKind`. Existing behavior is unchanged. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times.<br/>Valid values: `projectId`, `environmentId`, `destination`, `destinationKind`, `destinationId`. `destination` and `destinationKind` return the same raw Warehouse configuration kinds. `destinationId` returns one series per warehouse destination with `destinationName` metadata. When a current destination you can view matches, its `destinationId` is the LaunchDarkly destination ID, with `destinationViewable`. Otherwise, it is the warehouse provider\'s destination ID, named `Unknown destination`. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- getWarehouseExportUsage: async (from?: string, to?: string, projectKey?: string, environmentKey?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options: RawAxiosRequestConfig = {}): Promise => {
+ getWarehouseExportUsage: async (from?: string, to?: string, projectKey?: string, environmentKey?: string, destinationKind?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options: RawAxiosRequestConfig = {}): Promise => {
const localVarPath = `/api/v2/usage/warehouse-export`;
// use dummy base URL string because the URL constructor only accepts absolute URLs.
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -15331,6 +17070,10 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
localVarQueryParameter['environmentKey'] = environmentKey;
}
+ if (destinationKind !== undefined) {
+ localVarQueryParameter['destinationKind'] = destinationKind;
+ }
+
if (destination !== undefined) {
localVarQueryParameter['destination'] = destination;
}
@@ -15353,7 +17096,7 @@ export const AccountUsageBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -15464,27 +17207,48 @@ export const AccountUsageBetaApiFp = function(configuration?: Configuration) {
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
/**
- * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days.
+ * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days. `groupBy=projectId` resolves legacy rows through the account\'s current environment-to-project mapping and returns `409` instead of a partial series when any successful row remains unattributed. Plain project filtering keeps its current-environment compatibility behavior.
* @summary Get data export events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `groupBy=projectId`, filters to the project\'s current environments so retained pre-materialization usage remains visible. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `environmentId`, `eventKind`.
+ * @param {string} [destinationKind] A Streaming configuration kind to filter results by. Values preserve raw product identity; `snowflake` is legacy Streaming Snowflake and is distinct from Warehouse `snowflake-v2`. Can be specified multiple times.<br/>Valid values: `kinesis`, `google-pubsub`, `mparticle`, `segment`, `azure-event-hubs`, `snowflake`, `unknown`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension. `projectId` requires one or more explicit `projectKey` filters and is capped at 100 selected projects. `destinationId` returns one series per streaming destination with `destinationName` metadata, plus `destinationViewable` when the destination is in the current configuration. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. A destination ID absent from the current configuration is named `Unknown historical destination`. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.<br/>Valid values: `projectId`, `environmentId`, `eventKind`, `destinationKind`, `destinationId`.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- async getDataExportEventsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.getDataExportEventsUsage(from, to, projectKey, environmentKey, eventKind, groupBy, aggregationType, granularity, options);
+ async getDataExportEventsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, destinationKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.getDataExportEventsUsage(from, to, projectKey, environmentKey, eventKind, destinationKind, groupBy, aggregationType, granularity, options);
const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
const localVarOperationServerBasePath = operationServerMap['AccountUsageBetaApi.getDataExportEventsUsage']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
/**
- * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
+ * Rank projects with usage in the requested range by successful Streaming transfers. Legacy rows are attributed through the account\'s complete current environment-to-project mapping. If any successful row remains unattributed after resolution, the operation returns `409` instead of a partial ranking. The result limit does not cap the account-wide project universe or environment mapping. This source-specific operation does not provide Combined or Warehouse ranking.
+ * @summary Rank Streaming usage by project
+ * @param {number} from Inclusive UTC range start in Unix milliseconds.
+ * @param {number} to Exclusive UTC range end in Unix milliseconds.
+ * @param {string} [source] The source scope. Only `streaming` is supported.
+ * @param {string} [dimension] The ranking dimension. Only `project` is supported.
+ * @param {Array} [projectKey] A canonical project key to include. Can be specified multiple times, with at most 100 unique explicit selections; duplicates do not consume the limit. When omitted, all account projects with usage in the requested range are ranked.
+ * @param {string} [search] A case-insensitive substring matched against canonical project keys before querying usage. Project names are not searched.
+ * @param {string} [cursor] An opaque cursor returned by a previous response. Cursors are bound to the account and ranking inputs.
+ * @param {number} [limit] The maximum number of ranked projects to return. This bounds response rows and look-ahead, not the account-wide candidate universe.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async getDataExportProjectRanking(from: number, to: number, source?: string, dimension?: string, projectKey?: Array, search?: string, cursor?: string, limit?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.getDataExportProjectRanking(from, to, source, dimension, projectKey, search, cursor, limit, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AccountUsageBetaApi.getDataExportProjectRanking']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
+ /**
+ * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the returned data depends on the length of the requested time range: ranges shorter than two hours return minutely data, ranges shorter than two days return hourly data, and ranges of two days or longer return daily data. Minutely data is retained for 70 days; a range shorter than two hours that starts before then is returned at hourly granularity instead, with the start of the range widened to the containing hour. Ranges that predate available data return an empty series list. If a flag has served many distinct variation values in the requested range, the least recently seen values may be aggregated into a single additional series labeled \"Other Variations\".
* @summary Get evaluations usage
* @param {string} projectKey The project key
* @param {string} environmentKey The environment key
@@ -15521,7 +17285,7 @@ export const AccountUsageBetaApiFp = function(configuration?: Configuration) {
* @summary Get experimentation events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters to the project\'s current environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKey] An event key to filter results by. Can be specified multiple times, one query parameter per event key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
@@ -15542,7 +17306,7 @@ export const AccountUsageBetaApiFp = function(configuration?: Configuration) {
* @summary Get experimentation keys usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters by project, including projects that currently have no environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [experimentId] An experiment ID to filter results by. Can be specified multiple times, one query parameter per experiment ID.
* @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `experimentId`.
@@ -15779,9 +17543,9 @@ export const AccountUsageBetaApiFp = function(configuration?: Configuration) {
* @param {string} [relayVersion] A relay version to filter results by. Can be specified multiple times, one query parameter per relay version.
* @param {string} [sdkName] An SDK name to filter results by. Can be specified multiple times, one query parameter per SDK name.
* @param {string} [sdkVersion] An SDK version to filter results by. Can be specified multiple times, one query parameter per SDK version.
- * @param {string} [sdkType] An SDK type to filter results by. Can be specified multiple times, one query parameter per SDK type.
+ * @param {string} [sdkType] Deprecated. This endpoint reports server-side connections only, so `server` is the only value that returns data and omitting the parameter is equivalent. Any other value returns an empty series. To report client-side connections, use `GET /api/v2/usage/streams/{source}`.
* @param {string} [sdkAppId] An SDK app ID to filter results by. Can be specified multiple times, one query parameter per SDK app ID.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkType`, `sdkAppId`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkAppId`.<br/>`sdkType` is no longer offered: this endpoint reports server-side connections only, so grouping by it returns a single group. It is still accepted, for compatibility.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
@@ -15864,15 +17628,16 @@ export const AccountUsageBetaApiFp = function(configuration?: Configuration) {
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
* @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
- * @param {string} [destination] A destination kind to filter results by. Can be specified multiple times, one query parameter per destination kind.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `destination`.
+ * @param {string} [destinationKind] A Warehouse configuration kind to filter results by. Cannot be combined with `destination`. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`, `s3`.
+ * @param {string} [destination] A Warehouse configuration kind to filter results by. Cannot be combined with `destinationKind`. Existing behavior is unchanged. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times.<br/>Valid values: `projectId`, `environmentId`, `destination`, `destinationKind`, `destinationId`. `destination` and `destinationKind` return the same raw Warehouse configuration kinds. `destinationId` returns one series per warehouse destination with `destinationName` metadata. When a current destination you can view matches, its `destinationId` is the LaunchDarkly destination ID, with `destinationViewable`. Otherwise, it is the warehouse provider\'s destination ID, named `Unknown destination`. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- async getWarehouseExportUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.getWarehouseExportUsage(from, to, projectKey, environmentKey, destination, groupBy, aggregationType, granularity, options);
+ async getWarehouseExportUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, destinationKind?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.getWarehouseExportUsage(from, to, projectKey, environmentKey, destinationKind, destination, groupBy, aggregationType, granularity, options);
const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
const localVarOperationServerBasePath = operationServerMap['AccountUsageBetaApi.getWarehouseExportUsage']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -15964,24 +17729,42 @@ export const AccountUsageBetaApiFactory = function (configuration?: Configuratio
return localVarFp.getContextsTotalUsage(from, to, projectKey, environmentKey, contextKind, sdkName, sdkType, anonymous, groupBy, aggregationType, granularity, options).then((request) => request(axios, basePath));
},
/**
- * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days.
+ * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days. `groupBy=projectId` resolves legacy rows through the account\'s current environment-to-project mapping and returns `409` instead of a partial series when any successful row remains unattributed. Plain project filtering keeps its current-environment compatibility behavior.
* @summary Get data export events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `groupBy=projectId`, filters to the project\'s current environments so retained pre-materialization usage remains visible. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `environmentId`, `eventKind`.
+ * @param {string} [destinationKind] A Streaming configuration kind to filter results by. Values preserve raw product identity; `snowflake` is legacy Streaming Snowflake and is distinct from Warehouse `snowflake-v2`. Can be specified multiple times.<br/>Valid values: `kinesis`, `google-pubsub`, `mparticle`, `segment`, `azure-event-hubs`, `snowflake`, `unknown`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension. `projectId` requires one or more explicit `projectKey` filters and is capped at 100 selected projects. `destinationId` returns one series per streaming destination with `destinationName` metadata, plus `destinationViewable` when the destination is in the current configuration. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. A destination ID absent from the current configuration is named `Unknown historical destination`. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.<br/>Valid values: `projectId`, `environmentId`, `eventKind`, `destinationKind`, `destinationId`.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- getDataExportEventsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): AxiosPromise {
- return localVarFp.getDataExportEventsUsage(from, to, projectKey, environmentKey, eventKind, groupBy, aggregationType, granularity, options).then((request) => request(axios, basePath));
+ getDataExportEventsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, destinationKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.getDataExportEventsUsage(from, to, projectKey, environmentKey, eventKind, destinationKind, groupBy, aggregationType, granularity, options).then((request) => request(axios, basePath));
},
/**
- * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
+ * Rank projects with usage in the requested range by successful Streaming transfers. Legacy rows are attributed through the account\'s complete current environment-to-project mapping. If any successful row remains unattributed after resolution, the operation returns `409` instead of a partial ranking. The result limit does not cap the account-wide project universe or environment mapping. This source-specific operation does not provide Combined or Warehouse ranking.
+ * @summary Rank Streaming usage by project
+ * @param {number} from Inclusive UTC range start in Unix milliseconds.
+ * @param {number} to Exclusive UTC range end in Unix milliseconds.
+ * @param {string} [source] The source scope. Only `streaming` is supported.
+ * @param {string} [dimension] The ranking dimension. Only `project` is supported.
+ * @param {Array} [projectKey] A canonical project key to include. Can be specified multiple times, with at most 100 unique explicit selections; duplicates do not consume the limit. When omitted, all account projects with usage in the requested range are ranked.
+ * @param {string} [search] A case-insensitive substring matched against canonical project keys before querying usage. Project names are not searched.
+ * @param {string} [cursor] An opaque cursor returned by a previous response. Cursors are bound to the account and ranking inputs.
+ * @param {number} [limit] The maximum number of ranked projects to return. This bounds response rows and look-ahead, not the account-wide candidate universe.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ getDataExportProjectRanking(from: number, to: number, source?: string, dimension?: string, projectKey?: Array, search?: string, cursor?: string, limit?: number, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.getDataExportProjectRanking(from, to, source, dimension, projectKey, search, cursor, limit, options).then((request) => request(axios, basePath));
+ },
+ /**
+ * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the returned data depends on the length of the requested time range: ranges shorter than two hours return minutely data, ranges shorter than two days return hourly data, and ranges of two days or longer return daily data. Minutely data is retained for 70 days; a range shorter than two hours that starts before then is returned at hourly granularity instead, with the start of the range widened to the containing hour. Ranges that predate available data return an empty series list. If a flag has served many distinct variation values in the requested range, the least recently seen values may be aggregated into a single additional series labeled \"Other Variations\".
* @summary Get evaluations usage
* @param {string} projectKey The project key
* @param {string} environmentKey The environment key
@@ -16012,7 +17795,7 @@ export const AccountUsageBetaApiFactory = function (configuration?: Configuratio
* @summary Get experimentation events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters to the project\'s current environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKey] An event key to filter results by. Can be specified multiple times, one query parameter per event key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
@@ -16030,7 +17813,7 @@ export const AccountUsageBetaApiFactory = function (configuration?: Configuratio
* @summary Get experimentation keys usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters by project, including projects that currently have no environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [experimentId] An experiment ID to filter results by. Can be specified multiple times, one query parameter per experiment ID.
* @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `experimentId`.
@@ -16228,9 +18011,9 @@ export const AccountUsageBetaApiFactory = function (configuration?: Configuratio
* @param {string} [relayVersion] A relay version to filter results by. Can be specified multiple times, one query parameter per relay version.
* @param {string} [sdkName] An SDK name to filter results by. Can be specified multiple times, one query parameter per SDK name.
* @param {string} [sdkVersion] An SDK version to filter results by. Can be specified multiple times, one query parameter per SDK version.
- * @param {string} [sdkType] An SDK type to filter results by. Can be specified multiple times, one query parameter per SDK type.
+ * @param {string} [sdkType] Deprecated. This endpoint reports server-side connections only, so `server` is the only value that returns data and omitting the parameter is equivalent. Any other value returns an empty series. To report client-side connections, use `GET /api/v2/usage/streams/{source}`.
* @param {string} [sdkAppId] An SDK app ID to filter results by. Can be specified multiple times, one query parameter per SDK app ID.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkType`, `sdkAppId`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkAppId`.<br/>`sdkType` is no longer offered: this endpoint reports server-side connections only, so grouping by it returns a single group. It is still accepted, for compatibility.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
@@ -16298,15 +18081,16 @@ export const AccountUsageBetaApiFactory = function (configuration?: Configuratio
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
* @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
- * @param {string} [destination] A destination kind to filter results by. Can be specified multiple times, one query parameter per destination kind.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `destination`.
+ * @param {string} [destinationKind] A Warehouse configuration kind to filter results by. Cannot be combined with `destination`. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`, `s3`.
+ * @param {string} [destination] A Warehouse configuration kind to filter results by. Cannot be combined with `destinationKind`. Existing behavior is unchanged. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times.<br/>Valid values: `projectId`, `environmentId`, `destination`, `destinationKind`, `destinationId`. `destination` and `destinationKind` return the same raw Warehouse configuration kinds. `destinationId` returns one series per warehouse destination with `destinationName` metadata. When a current destination you can view matches, its `destinationId` is the LaunchDarkly destination ID, with `destinationViewable`. Otherwise, it is the warehouse provider\'s destination ID, named `Unknown destination`. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- getWarehouseExportUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): AxiosPromise {
- return localVarFp.getWarehouseExportUsage(from, to, projectKey, environmentKey, destination, groupBy, aggregationType, granularity, options).then((request) => request(axios, basePath));
+ getWarehouseExportUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, destinationKind?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.getWarehouseExportUsage(from, to, projectKey, environmentKey, destinationKind, destination, groupBy, aggregationType, granularity, options).then((request) => request(axios, basePath));
},
};
};
@@ -16397,25 +18181,44 @@ export class AccountUsageBetaApi extends BaseAPI {
}
/**
- * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days.
+ * Get a time series array showing the number of data export events from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days. `groupBy=projectId` resolves legacy rows through the account\'s current environment-to-project mapping and returns `409` instead of a partial series when any successful row remains unattributed. Plain project filtering keeps its current-environment compatibility behavior.
* @summary Get data export events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `groupBy=projectId`, filters to the project\'s current environments so retained pre-materialization usage remains visible. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `environmentId`, `eventKind`.
+ * @param {string} [destinationKind] A Streaming configuration kind to filter results by. Values preserve raw product identity; `snowflake` is legacy Streaming Snowflake and is distinct from Warehouse `snowflake-v2`. Can be specified multiple times.<br/>Valid values: `kinesis`, `google-pubsub`, `mparticle`, `segment`, `azure-event-hubs`, `snowflake`, `unknown`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension. `projectId` requires one or more explicit `projectKey` filters and is capped at 100 selected projects. `destinationId` returns one series per streaming destination with `destinationName` metadata, plus `destinationViewable` when the destination is in the current configuration. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. A destination ID absent from the current configuration is named `Unknown historical destination`. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.<br/>Valid values: `projectId`, `environmentId`, `eventKind`, `destinationKind`, `destinationId`.
* @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
* @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getDataExportEventsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getDataExportEventsUsage(from, to, projectKey, environmentKey, eventKind, groupBy, aggregationType, granularity, options).then((request) => request(this.axios, this.basePath));
+ public getDataExportEventsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, eventKind?: string, destinationKind?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getDataExportEventsUsage(from, to, projectKey, environmentKey, eventKind, destinationKind, groupBy, aggregationType, granularity, options).then((request) => request(this.axios, this.basePath));
}
/**
- * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
+ * Rank projects with usage in the requested range by successful Streaming transfers. Legacy rows are attributed through the account\'s complete current environment-to-project mapping. If any successful row remains unattributed after resolution, the operation returns `409` instead of a partial ranking. The result limit does not cap the account-wide project universe or environment mapping. This source-specific operation does not provide Combined or Warehouse ranking.
+ * @summary Rank Streaming usage by project
+ * @param {number} from Inclusive UTC range start in Unix milliseconds.
+ * @param {number} to Exclusive UTC range end in Unix milliseconds.
+ * @param {string} [source] The source scope. Only `streaming` is supported.
+ * @param {string} [dimension] The ranking dimension. Only `project` is supported.
+ * @param {Array} [projectKey] A canonical project key to include. Can be specified multiple times, with at most 100 unique explicit selections; duplicates do not consume the limit. When omitted, all account projects with usage in the requested range are ranked.
+ * @param {string} [search] A case-insensitive substring matched against canonical project keys before querying usage. Project names are not searched.
+ * @param {string} [cursor] An opaque cursor returned by a previous response. Cursors are bound to the account and ranking inputs.
+ * @param {number} [limit] The maximum number of ranked projects to return. This bounds response rows and look-ahead, not the account-wide candidate universe.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getDataExportProjectRanking(from: number, to: number, source?: string, dimension?: string, projectKey?: Array, search?: string, cursor?: string, limit?: number, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getDataExportProjectRanking(from, to, source, dimension, projectKey, search, cursor, limit, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the returned data depends on the length of the requested time range: ranges shorter than two hours return minutely data, ranges shorter than two days return hourly data, and ranges of two days or longer return daily data. Minutely data is retained for 70 days; a range shorter than two hours that starts before then is returned at hourly granularity instead, with the start of the range widened to the containing hour. Ranges that predate available data return an empty series list. If a flag has served many distinct variation values in the requested range, the least recently seen values may be aggregated into a single additional series labeled \"Other Variations\".
* @summary Get evaluations usage
* @param {string} projectKey The project key
* @param {string} environmentKey The environment key
@@ -16448,7 +18251,7 @@ export class AccountUsageBetaApi extends BaseAPI {
* @summary Get experimentation events usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters to the project\'s current environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [eventKey] An event key to filter results by. Can be specified multiple times, one query parameter per event key.
* @param {string} [eventKind] An event kind to filter results by. Can be specified multiple times, one query parameter per event kind.
@@ -16467,7 +18270,7 @@ export class AccountUsageBetaApi extends BaseAPI {
* @summary Get experimentation keys usage
* @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
* @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [projectKey] A project key to filter results by. Without `environmentKey`, filters by project, including projects that currently have no environments. Can be specified multiple times, one query parameter per project key.
* @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
* @param {string} [experimentId] An experiment ID to filter results by. Can be specified multiple times, one query parameter per experiment ID.
* @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `experimentId`.
@@ -16581,187 +18384,903 @@ export class AccountUsageBetaApi extends BaseAPI {
return AccountUsageBetaApiFp(this.configuration).getObservabilityErrorsUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
}
- /**
- * Get time-series arrays of the number of observability logs. Supports `daily` and `monthly` granularity.
- * @summary Get observability logs usage
- * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
- * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
- * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- public getObservabilityLogsUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getObservabilityLogsUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
- }
+ /**
+ * Get time-series arrays of the number of observability logs. Supports `daily` and `monthly` granularity.
+ * @summary Get observability logs usage
+ * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
+ * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
+ * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
+ * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getObservabilityLogsUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getObservabilityLogsUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get time-series arrays of the number of observability metrics. Supports `hourly`, `daily`, and `monthly` granularity.
+ * @summary Get observability metrics usage
+ * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
+ * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
+ * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `hourly`, `daily`, and `monthly`; **average** supports `hourly`, `daily`, and `monthly`.
+ * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `average`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getObservabilityMetricsUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getObservabilityMetricsUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get time-series arrays of the number of observability sessions. Supports `daily` and `monthly` granularity.
+ * @summary Get observability sessions usage
+ * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
+ * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
+ * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
+ * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getObservabilitySessionsUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getObservabilitySessionsUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get time-series arrays of the number of observability traces. Supports `daily` and `monthly` granularity.
+ * @summary Get observability traces usage
+ * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
+ * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
+ * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
+ * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getObservabilityTracesUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getObservabilityTracesUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get detailed SDK version usage data for all versions observed in the last 24 hours in your account. Unlike the `/details` endpoint which returns only the max version per SDK, this endpoint returns all SDK versions for the specified filters. This data is refreshed hourly.
All query parameters are optional, allowing you to filter results as broadly or narrowly as needed.
+ * @summary Get usage details for all SDK versions
+ * @param {string} [environmentId] Filter to a specific environment ID.
+ * @param {string} [projectId] Filter to a specific project ID.
+ * @param {string} [sdkName] Filter to a specific SDK name.
+ * @param {string} [sdkType] Filter to a specific SDK type (for example, \'server\', \'browser\', \'mobile\').
+ * @param {string} [sdkAppId] Filter to a specific SDK application ID.
+ * @param {string} [connectionType] Filter to a specific connection type (for example, \'direct\', \'proxy\').
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getSdkAllVersions(environmentId?: string, projectId?: string, sdkName?: string, sdkType?: string, sdkAppId?: string, connectionType?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getSdkAllVersions(environmentId, projectId, sdkName, sdkType, sdkAppId, connectionType, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get detailed SDK version usage data for your account, including version information, EOL status, and relay proxy metadata. Refreshed hourly, returns the max version for each SDK observed in the last 24 hours, including those without EOL metadata available.
This endpoint provides comprehensive information about SDK versions in use across your projects and environments.
+ * @summary Get SDK versions usage details
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getSdkVersionsDetails(options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getSdkVersionsDetails(options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get a time series array showing the number of service connection minutes from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days.
+ * @summary Get service connections usage
+ * @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
+ * @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
+ * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
+ * @param {string} [connectionType] A connection type to filter results by. Can be specified multiple times, one query parameter per connection type.
+ * @param {string} [relayVersion] A relay version to filter results by. Can be specified multiple times, one query parameter per relay version.
+ * @param {string} [sdkName] An SDK name to filter results by. Can be specified multiple times, one query parameter per SDK name.
+ * @param {string} [sdkVersion] An SDK version to filter results by. Can be specified multiple times, one query parameter per SDK version.
+ * @param {string} [sdkType] Deprecated. This endpoint reports server-side connections only, so `server` is the only value that returns data and omitting the parameter is equivalent. Any other value returns an empty series. To report client-side connections, use `GET /api/v2/usage/streams/{source}`.
+ * @param {string} [sdkAppId] An SDK app ID to filter results by. Can be specified multiple times, one query parameter per SDK app ID.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkAppId`.<br/>`sdkType` is no longer offered: this endpoint reports server-side connections only, so grouping by it returns a single group. It is still accepted, for compatibility.
+ * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
+ * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getServiceConnectionsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, connectionType?: string, relayVersion?: string, sdkName?: string, sdkVersion?: string, sdkType?: string, sdkAppId?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getServiceConnectionsUsage(from, to, projectKey, environmentKey, connectionType, relayVersion, sdkName, sdkVersion, sdkType, sdkAppId, groupBy, aggregationType, granularity, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get a time-series array of the number of streaming connections to LaunchDarkly in each time period. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
+ * @summary Get stream usage
+ * @param {string} source The source of streaming connections to describe. Must be either `client` or `server`.
+ * @param {string} [from] The series of data returned starts from this timestamp. Defaults to 30 days ago.
+ * @param {string} [to] The series of data returned ends at this timestamp. Defaults to the current time.
+ * @param {string} [tz] The timezone to use for breaks between days when returning daily data.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getStreamUsage(source: string, from?: string, to?: string, tz?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getStreamUsage(source, from, to, tz, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get multiple series of the number of streaming connections to LaunchDarkly in each time period, separated by SDK type and version. Information about each series is in the metadata array. The granularity of the data depends on the age of the data requested. If the requested range is within the past 2 hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
+ * @summary Get stream usage by SDK version
+ * @param {string} source The source of streaming connections to describe. Must be either `client` or `server`.
+ * @param {string} [from] The series of data returned starts from this timestamp. Defaults to 24 hours ago.
+ * @param {string} [to] The series of data returned ends at this timestamp. Defaults to the current time.
+ * @param {string} [tz] The timezone to use for breaks between days when returning daily data.
+ * @param {string} [sdk] If included, this filters the returned series to only those that match this SDK name.
+ * @param {string} [version] If included, this filters the returned series to only those that match this SDK version.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getStreamUsageBySdkVersion(source: string, from?: string, to?: string, tz?: string, sdk?: string, version?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getStreamUsageBySdkVersion(source, from, to, tz, sdk, version, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get a list of SDK version objects, which contain an SDK name and version. These are all of the SDKs that have connected to LaunchDarkly from your account in the past 60 days.
+ * @summary Get stream usage SDK versions
+ * @param {string} source The source of streaming connections to describe. Must be either `client` or `server`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getStreamUsageSdkversion(source: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getStreamUsageSdkversion(source, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get time-series arrays of the number of Vega AI usage. Supports `daily` and `monthly` granularity.
+ * @summary Get Vega AI usage
+ * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
+ * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
+ * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
+ * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getVegaAIUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getVegaAIUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
+ }
+
+ /**
+ * Get a time series array showing the number of rows exported to your warehouse Data Export destinations. The supported granularity varies by aggregation type. The maximum time range is 365 days.
+ * @summary Get warehouse Data Export usage
+ * @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
+ * @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
+ * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
+ * @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
+ * @param {string} [destinationKind] A Warehouse configuration kind to filter results by. Cannot be combined with `destination`. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`, `s3`.
+ * @param {string} [destination] A Warehouse configuration kind to filter results by. Cannot be combined with `destinationKind`. Existing behavior is unchanged. Can be specified multiple times.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
+ * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times.<br/>Valid values: `projectId`, `environmentId`, `destination`, `destinationKind`, `destinationId`. `destination` and `destinationKind` return the same raw Warehouse configuration kinds. `destinationId` returns one series per warehouse destination with `destinationName` metadata. When a current destination you can view matches, its `destinationId` is the LaunchDarkly destination ID, with `destinationViewable`. Otherwise, it is the warehouse provider\'s destination ID, named `Unknown destination`. The destination\'s own kind is added as `destinationKind` only when you can view the destination. A kind requested with `groupBy=destinationKind` is returned unchanged. Destinations you cannot view are reported together in one `Unknown destination` series with `destinationId` `hidden` and `destinationViewable` `false`, one per combination of the other requested dimensions, such as `destinationKind`. Usage without a destination ID is one series with an empty `destinationId` named `Unattributed`.
+ * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
+ * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public getWarehouseExportUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, destinationKind?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig) {
+ return AccountUsageBetaApiFp(this.configuration).getWarehouseExportUsage(from, to, projectKey, environmentKey, destinationKind, destination, groupBy, aggregationType, granularity, options).then((request) => request(this.axios, this.basePath));
+ }
+}
+
+
+
+/**
+ * AdaptiveTriggersApi - axios parameter creator
+ */
+export const AdaptiveTriggersApiAxiosParamCreator = function (configuration?: Configuration) {
+ return {
+ /**
+ * Delete a single adaptive trigger.
+ * @summary Delete an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ deleteAdaptiveTrigger: async (projectKey: string, environmentKey: string, triggerID: string, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('deleteAdaptiveTrigger', 'projectKey', projectKey)
+ // verify required parameter 'environmentKey' is not null or undefined
+ assertParamExists('deleteAdaptiveTrigger', 'environmentKey', environmentKey)
+ // verify required parameter 'triggerID' is not null or undefined
+ assertParamExists('deleteAdaptiveTrigger', 'triggerID', triggerID)
+ const localVarPath = `/api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID}`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"environmentKey"}}`, encodeURIComponent(String(environmentKey)))
+ .replace(`{${"triggerID"}}`, encodeURIComponent(String(triggerID)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'DELETE', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Get a single adaptive trigger.
+ * @summary Get an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ getAdaptiveTrigger: async (projectKey: string, environmentKey: string, triggerID: string, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('getAdaptiveTrigger', 'projectKey', projectKey)
+ // verify required parameter 'environmentKey' is not null or undefined
+ assertParamExists('getAdaptiveTrigger', 'environmentKey', environmentKey)
+ // verify required parameter 'triggerID' is not null or undefined
+ assertParamExists('getAdaptiveTrigger', 'triggerID', triggerID)
+ const localVarPath = `/api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID}`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"environmentKey"}}`, encodeURIComponent(String(environmentKey)))
+ .replace(`{${"triggerID"}}`, encodeURIComponent(String(triggerID)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * List all adaptive triggers for a resource.
+ * @summary List adaptive triggers
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {AdaptiveTriggerResourceKind} resourceKind
+ * @param {string} resourceKey
+ * @param {number} [limit] The number of items to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ listAdaptiveTriggers: async (projectKey: string, environmentKey: string, resourceKind: AdaptiveTriggerResourceKind, resourceKey: string, limit?: number, offset?: number, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('listAdaptiveTriggers', 'projectKey', projectKey)
+ // verify required parameter 'environmentKey' is not null or undefined
+ assertParamExists('listAdaptiveTriggers', 'environmentKey', environmentKey)
+ // verify required parameter 'resourceKind' is not null or undefined
+ assertParamExists('listAdaptiveTriggers', 'resourceKind', resourceKind)
+ // verify required parameter 'resourceKey' is not null or undefined
+ assertParamExists('listAdaptiveTriggers', 'resourceKey', resourceKey)
+ const localVarPath = `/api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"environmentKey"}}`, encodeURIComponent(String(environmentKey)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ if (resourceKind !== undefined) {
+ localVarQueryParameter['resourceKind'] = resourceKind;
+ }
+
+ if (resourceKey !== undefined) {
+ localVarQueryParameter['resourceKey'] = resourceKey;
+ }
+
+ if (limit !== undefined) {
+ localVarQueryParameter['limit'] = limit;
+ }
+
+ if (offset !== undefined) {
+ localVarQueryParameter['offset'] = offset;
+ }
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Update a single adaptive trigger.
+ * @summary Update an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {UpdateAdaptiveTriggerRequest} updateAdaptiveTriggerRequest
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ patchAdaptiveTrigger: async (projectKey: string, environmentKey: string, triggerID: string, updateAdaptiveTriggerRequest: UpdateAdaptiveTriggerRequest, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('patchAdaptiveTrigger', 'projectKey', projectKey)
+ // verify required parameter 'environmentKey' is not null or undefined
+ assertParamExists('patchAdaptiveTrigger', 'environmentKey', environmentKey)
+ // verify required parameter 'triggerID' is not null or undefined
+ assertParamExists('patchAdaptiveTrigger', 'triggerID', triggerID)
+ // verify required parameter 'updateAdaptiveTriggerRequest' is not null or undefined
+ assertParamExists('patchAdaptiveTrigger', 'updateAdaptiveTriggerRequest', updateAdaptiveTriggerRequest)
+ const localVarPath = `/api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID}`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"environmentKey"}}`, encodeURIComponent(String(environmentKey)))
+ .replace(`{${"triggerID"}}`, encodeURIComponent(String(triggerID)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'PATCH', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ localVarHeaderParameter['Content-Type'] = 'application/json';
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+ localVarRequestOptions.data = serializeDataIfNeeded(updateAdaptiveTriggerRequest, localVarRequestOptions, configuration)
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Create a new adaptive trigger for a resource.
+ * @summary Create an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {CreateAdaptiveTriggerRequest} createAdaptiveTriggerRequest
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ postAdaptiveTrigger: async (projectKey: string, environmentKey: string, createAdaptiveTriggerRequest: CreateAdaptiveTriggerRequest, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('postAdaptiveTrigger', 'projectKey', projectKey)
+ // verify required parameter 'environmentKey' is not null or undefined
+ assertParamExists('postAdaptiveTrigger', 'environmentKey', environmentKey)
+ // verify required parameter 'createAdaptiveTriggerRequest' is not null or undefined
+ assertParamExists('postAdaptiveTrigger', 'createAdaptiveTriggerRequest', createAdaptiveTriggerRequest)
+ const localVarPath = `/api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"environmentKey"}}`, encodeURIComponent(String(environmentKey)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ localVarHeaderParameter['Content-Type'] = 'application/json';
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+ localVarRequestOptions.data = serializeDataIfNeeded(createAdaptiveTriggerRequest, localVarRequestOptions, configuration)
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Disable an adaptive trigger.
+ * @summary Disable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ postDisableAdaptiveTrigger: async (projectKey: string, environmentKey: string, triggerID: string, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('postDisableAdaptiveTrigger', 'projectKey', projectKey)
+ // verify required parameter 'environmentKey' is not null or undefined
+ assertParamExists('postDisableAdaptiveTrigger', 'environmentKey', environmentKey)
+ // verify required parameter 'triggerID' is not null or undefined
+ assertParamExists('postDisableAdaptiveTrigger', 'triggerID', triggerID)
+ const localVarPath = `/api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID}/disable`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"environmentKey"}}`, encodeURIComponent(String(environmentKey)))
+ .replace(`{${"triggerID"}}`, encodeURIComponent(String(triggerID)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Enable an adaptive trigger.
+ * @summary Enable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ postEnableAdaptiveTrigger: async (projectKey: string, environmentKey: string, triggerID: string, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('postEnableAdaptiveTrigger', 'projectKey', projectKey)
+ // verify required parameter 'environmentKey' is not null or undefined
+ assertParamExists('postEnableAdaptiveTrigger', 'environmentKey', environmentKey)
+ // verify required parameter 'triggerID' is not null or undefined
+ assertParamExists('postEnableAdaptiveTrigger', 'triggerID', triggerID)
+ const localVarPath = `/api/v2/projects/{projectKey}/environments/{environmentKey}/adaptive-triggers/{triggerID}/enable`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"environmentKey"}}`, encodeURIComponent(String(environmentKey)))
+ .replace(`{${"triggerID"}}`, encodeURIComponent(String(triggerID)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
- /**
- * Get time-series arrays of the number of observability metrics. Supports `hourly`, `daily`, and `monthly` granularity.
- * @summary Get observability metrics usage
- * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
- * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `hourly`, `daily`, and `monthly`; **average** supports `hourly`, `daily`, and `monthly`.
- * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `average`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- public getObservabilityMetricsUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getObservabilityMetricsUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
- }
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
- /**
- * Get time-series arrays of the number of observability sessions. Supports `daily` and `monthly` granularity.
- * @summary Get observability sessions usage
- * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
- * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
- * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- public getObservabilitySessionsUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getObservabilitySessionsUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
- }
+ localVarHeaderParameter['Accept'] = 'application/json';
- /**
- * Get time-series arrays of the number of observability traces. Supports `daily` and `monthly` granularity.
- * @summary Get observability traces usage
- * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
- * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
- * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- public getObservabilityTracesUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getObservabilityTracesUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
}
+};
- /**
- * Get detailed SDK version usage data for all versions observed in the last 24 hours in your account. Unlike the `/details` endpoint which returns only the max version per SDK, this endpoint returns all SDK versions for the specified filters. This data is refreshed hourly.
All query parameters are optional, allowing you to filter results as broadly or narrowly as needed.
- * @summary Get usage details for all SDK versions
- * @param {string} [environmentId] Filter to a specific environment ID.
- * @param {string} [projectId] Filter to a specific project ID.
- * @param {string} [sdkName] Filter to a specific SDK name.
- * @param {string} [sdkType] Filter to a specific SDK type (for example, \'server\', \'browser\', \'mobile\').
- * @param {string} [sdkAppId] Filter to a specific SDK application ID.
- * @param {string} [connectionType] Filter to a specific connection type (for example, \'direct\', \'proxy\').
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- public getSdkAllVersions(environmentId?: string, projectId?: string, sdkName?: string, sdkType?: string, sdkAppId?: string, connectionType?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getSdkAllVersions(environmentId, projectId, sdkName, sdkType, sdkAppId, connectionType, options).then((request) => request(this.axios, this.basePath));
+/**
+ * AdaptiveTriggersApi - functional programming interface
+ */
+export const AdaptiveTriggersApiFp = function(configuration?: Configuration) {
+ const localVarAxiosParamCreator = AdaptiveTriggersApiAxiosParamCreator(configuration)
+ return {
+ /**
+ * Delete a single adaptive trigger.
+ * @summary Delete an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async deleteAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.deleteAdaptiveTrigger(projectKey, environmentKey, triggerID, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AdaptiveTriggersApi.deleteAdaptiveTrigger']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
+ /**
+ * Get a single adaptive trigger.
+ * @summary Get an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async getAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.getAdaptiveTrigger(projectKey, environmentKey, triggerID, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AdaptiveTriggersApi.getAdaptiveTrigger']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
+ /**
+ * List all adaptive triggers for a resource.
+ * @summary List adaptive triggers
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {AdaptiveTriggerResourceKind} resourceKind
+ * @param {string} resourceKey
+ * @param {number} [limit] The number of items to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async listAdaptiveTriggers(projectKey: string, environmentKey: string, resourceKind: AdaptiveTriggerResourceKind, resourceKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.listAdaptiveTriggers(projectKey, environmentKey, resourceKind, resourceKey, limit, offset, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AdaptiveTriggersApi.listAdaptiveTriggers']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
+ /**
+ * Update a single adaptive trigger.
+ * @summary Update an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {UpdateAdaptiveTriggerRequest} updateAdaptiveTriggerRequest
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async patchAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, updateAdaptiveTriggerRequest: UpdateAdaptiveTriggerRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.patchAdaptiveTrigger(projectKey, environmentKey, triggerID, updateAdaptiveTriggerRequest, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AdaptiveTriggersApi.patchAdaptiveTrigger']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
+ /**
+ * Create a new adaptive trigger for a resource.
+ * @summary Create an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {CreateAdaptiveTriggerRequest} createAdaptiveTriggerRequest
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async postAdaptiveTrigger(projectKey: string, environmentKey: string, createAdaptiveTriggerRequest: CreateAdaptiveTriggerRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.postAdaptiveTrigger(projectKey, environmentKey, createAdaptiveTriggerRequest, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AdaptiveTriggersApi.postAdaptiveTrigger']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
+ /**
+ * Disable an adaptive trigger.
+ * @summary Disable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async postDisableAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.postDisableAdaptiveTrigger(projectKey, environmentKey, triggerID, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AdaptiveTriggersApi.postDisableAdaptiveTrigger']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
+ /**
+ * Enable an adaptive trigger.
+ * @summary Enable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async postEnableAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.postEnableAdaptiveTrigger(projectKey, environmentKey, triggerID, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AdaptiveTriggersApi.postEnableAdaptiveTrigger']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
}
+};
+
+/**
+ * AdaptiveTriggersApi - factory interface
+ */
+export const AdaptiveTriggersApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+ const localVarFp = AdaptiveTriggersApiFp(configuration)
+ return {
+ /**
+ * Delete a single adaptive trigger.
+ * @summary Delete an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ deleteAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.deleteAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(axios, basePath));
+ },
+ /**
+ * Get a single adaptive trigger.
+ * @summary Get an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ getAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.getAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(axios, basePath));
+ },
+ /**
+ * List all adaptive triggers for a resource.
+ * @summary List adaptive triggers
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {AdaptiveTriggerResourceKind} resourceKind
+ * @param {string} resourceKey
+ * @param {number} [limit] The number of items to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ listAdaptiveTriggers(projectKey: string, environmentKey: string, resourceKind: AdaptiveTriggerResourceKind, resourceKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.listAdaptiveTriggers(projectKey, environmentKey, resourceKind, resourceKey, limit, offset, options).then((request) => request(axios, basePath));
+ },
+ /**
+ * Update a single adaptive trigger.
+ * @summary Update an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {UpdateAdaptiveTriggerRequest} updateAdaptiveTriggerRequest
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ patchAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, updateAdaptiveTriggerRequest: UpdateAdaptiveTriggerRequest, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.patchAdaptiveTrigger(projectKey, environmentKey, triggerID, updateAdaptiveTriggerRequest, options).then((request) => request(axios, basePath));
+ },
+ /**
+ * Create a new adaptive trigger for a resource.
+ * @summary Create an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {CreateAdaptiveTriggerRequest} createAdaptiveTriggerRequest
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ postAdaptiveTrigger(projectKey: string, environmentKey: string, createAdaptiveTriggerRequest: CreateAdaptiveTriggerRequest, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.postAdaptiveTrigger(projectKey, environmentKey, createAdaptiveTriggerRequest, options).then((request) => request(axios, basePath));
+ },
+ /**
+ * Disable an adaptive trigger.
+ * @summary Disable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ postDisableAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.postDisableAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(axios, basePath));
+ },
+ /**
+ * Enable an adaptive trigger.
+ * @summary Enable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ postEnableAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.postEnableAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(axios, basePath));
+ },
+ };
+};
+/**
+ * AdaptiveTriggersApi - object-oriented interface
+ */
+export class AdaptiveTriggersApi extends BaseAPI {
/**
- * Get detailed SDK version usage data for your account, including version information, EOL status, and relay proxy metadata. Refreshed hourly, returns the max version for each SDK observed in the last 24 hours, including those without EOL metadata available.
This endpoint provides comprehensive information about SDK versions in use across your projects and environments.
- * @summary Get SDK versions usage details
+ * Delete a single adaptive trigger.
+ * @summary Delete an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getSdkVersionsDetails(options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getSdkVersionsDetails(options).then((request) => request(this.axios, this.basePath));
+ public deleteAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig) {
+ return AdaptiveTriggersApiFp(this.configuration).deleteAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(this.axios, this.basePath));
}
/**
- * Get a time series array showing the number of service connection minutes from your account. The supported granularity varies by aggregation type. The maximum time range is 365 days.
- * @summary Get service connections usage
- * @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
- * @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- * @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
- * @param {string} [connectionType] A connection type to filter results by. Can be specified multiple times, one query parameter per connection type.
- * @param {string} [relayVersion] A relay version to filter results by. Can be specified multiple times, one query parameter per relay version.
- * @param {string} [sdkName] An SDK name to filter results by. Can be specified multiple times, one query parameter per SDK name.
- * @param {string} [sdkVersion] An SDK version to filter results by. Can be specified multiple times, one query parameter per SDK version.
- * @param {string} [sdkType] An SDK type to filter results by. Can be specified multiple times, one query parameter per SDK type.
- * @param {string} [sdkAppId] An SDK app ID to filter results by. Can be specified multiple times, one query parameter per SDK app ID.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `connectionType`, `relayVersion`, `sdkName`, `sdkVersion`, `sdkType`, `sdkAppId`.
- * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
- * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
+ * Get a single adaptive trigger.
+ * @summary Get an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getServiceConnectionsUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, connectionType?: string, relayVersion?: string, sdkName?: string, sdkVersion?: string, sdkType?: string, sdkAppId?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getServiceConnectionsUsage(from, to, projectKey, environmentKey, connectionType, relayVersion, sdkName, sdkVersion, sdkType, sdkAppId, groupBy, aggregationType, granularity, options).then((request) => request(this.axios, this.basePath));
+ public getAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig) {
+ return AdaptiveTriggersApiFp(this.configuration).getAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(this.axios, this.basePath));
}
/**
- * Get a time-series array of the number of streaming connections to LaunchDarkly in each time period. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
- * @summary Get stream usage
- * @param {string} source The source of streaming connections to describe. Must be either `client` or `server`.
- * @param {string} [from] The series of data returned starts from this timestamp. Defaults to 30 days ago.
- * @param {string} [to] The series of data returned ends at this timestamp. Defaults to the current time.
- * @param {string} [tz] The timezone to use for breaks between days when returning daily data.
+ * List all adaptive triggers for a resource.
+ * @summary List adaptive triggers
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {AdaptiveTriggerResourceKind} resourceKind
+ * @param {string} resourceKey
+ * @param {number} [limit] The number of items to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getStreamUsage(source: string, from?: string, to?: string, tz?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getStreamUsage(source, from, to, tz, options).then((request) => request(this.axios, this.basePath));
+ public listAdaptiveTriggers(projectKey: string, environmentKey: string, resourceKind: AdaptiveTriggerResourceKind, resourceKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig) {
+ return AdaptiveTriggersApiFp(this.configuration).listAdaptiveTriggers(projectKey, environmentKey, resourceKind, resourceKey, limit, offset, options).then((request) => request(this.axios, this.basePath));
}
/**
- * Get multiple series of the number of streaming connections to LaunchDarkly in each time period, separated by SDK type and version. Information about each series is in the metadata array. The granularity of the data depends on the age of the data requested. If the requested range is within the past 2 hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
- * @summary Get stream usage by SDK version
- * @param {string} source The source of streaming connections to describe. Must be either `client` or `server`.
- * @param {string} [from] The series of data returned starts from this timestamp. Defaults to 24 hours ago.
- * @param {string} [to] The series of data returned ends at this timestamp. Defaults to the current time.
- * @param {string} [tz] The timezone to use for breaks between days when returning daily data.
- * @param {string} [sdk] If included, this filters the returned series to only those that match this SDK name.
- * @param {string} [version] If included, this filters the returned series to only those that match this SDK version.
+ * Update a single adaptive trigger.
+ * @summary Update an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
+ * @param {UpdateAdaptiveTriggerRequest} updateAdaptiveTriggerRequest
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getStreamUsageBySdkVersion(source: string, from?: string, to?: string, tz?: string, sdk?: string, version?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getStreamUsageBySdkVersion(source, from, to, tz, sdk, version, options).then((request) => request(this.axios, this.basePath));
+ public patchAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, updateAdaptiveTriggerRequest: UpdateAdaptiveTriggerRequest, options?: RawAxiosRequestConfig) {
+ return AdaptiveTriggersApiFp(this.configuration).patchAdaptiveTrigger(projectKey, environmentKey, triggerID, updateAdaptiveTriggerRequest, options).then((request) => request(this.axios, this.basePath));
}
/**
- * Get a list of SDK version objects, which contain an SDK name and version. These are all of the SDKs that have connected to LaunchDarkly from your account in the past 60 days.
- * @summary Get stream usage SDK versions
- * @param {string} source The source of streaming connections to describe. Must be either `client` or `server`.
+ * Create a new adaptive trigger for a resource.
+ * @summary Create an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {CreateAdaptiveTriggerRequest} createAdaptiveTriggerRequest
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getStreamUsageSdkversion(source: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getStreamUsageSdkversion(source, options).then((request) => request(this.axios, this.basePath));
+ public postAdaptiveTrigger(projectKey: string, environmentKey: string, createAdaptiveTriggerRequest: CreateAdaptiveTriggerRequest, options?: RawAxiosRequestConfig) {
+ return AdaptiveTriggersApiFp(this.configuration).postAdaptiveTrigger(projectKey, environmentKey, createAdaptiveTriggerRequest, options).then((request) => request(this.axios, this.basePath));
}
/**
- * Get time-series arrays of the number of Vega AI usage. Supports `daily` and `monthly` granularity.
- * @summary Get Vega AI usage
- * @param {string} [from] The series of data returned starts from this timestamp (Unix seconds). Defaults to the beginning of the current month.
- * @param {string} [to] The series of data returned ends at this timestamp (Unix seconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. Valid values depend on `aggregationType`: **month_to_date** supports `daily` and `monthly`; **incremental** and **rolling_30d** support `daily` only.
- * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`, `rolling_30d`.
+ * Disable an adaptive trigger.
+ * @summary Disable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getVegaAIUsage(from?: string, to?: string, projectKey?: string, granularity?: string, aggregationType?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getVegaAIUsage(from, to, projectKey, granularity, aggregationType, options).then((request) => request(this.axios, this.basePath));
+ public postDisableAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig) {
+ return AdaptiveTriggersApiFp(this.configuration).postDisableAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(this.axios, this.basePath));
}
/**
- * Get a time series array showing the number of rows exported to your warehouse Data Export destinations. The supported granularity varies by aggregation type. The maximum time range is 365 days.
- * @summary Get warehouse Data Export usage
- * @param {string} [from] The series of data returned starts from this timestamp (Unix milliseconds). Defaults to the beginning of the current month.
- * @param {string} [to] The series of data returned ends at this timestamp (Unix milliseconds). Defaults to the current time.
- * @param {string} [projectKey] A project key to filter results by. Can be specified multiple times, one query parameter per project key.
- * @param {string} [environmentKey] An environment key to filter results by. If specified, exactly one `projectKey` must be provided. Can be specified multiple times, one query parameter per environment key.
- * @param {string} [destination] A destination kind to filter results by. Can be specified multiple times, one query parameter per destination kind.<br/>Valid values: `snowflake-v2`, `databricks`, `bigquery`, `redshift`, `clickhouse`.
- * @param {string} [groupBy] If specified, returns data for each distinct value of the given field. Can be specified multiple times to group data by multiple dimensions, one query parameter per dimension.<br/>Valid values: `projectId`, `environmentId`, `destination`.
- * @param {string} [aggregationType] Specifies the aggregation method. Defaults to `month_to_date`.<br/>Valid values: `month_to_date`, `incremental`.
- * @param {string} [granularity] Specifies the data granularity. Defaults to `daily`. `monthly` granularity is only supported with the **month_to_date** aggregation type.<br/>Valid values: `daily`, `hourly`, `monthly`.
+ * Enable an adaptive trigger.
+ * @summary Enable an adaptive trigger
+ * @param {string} projectKey
+ * @param {string} environmentKey
+ * @param {string} triggerID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getWarehouseExportUsage(from?: string, to?: string, projectKey?: string, environmentKey?: string, destination?: string, groupBy?: string, aggregationType?: string, granularity?: string, options?: RawAxiosRequestConfig) {
- return AccountUsageBetaApiFp(this.configuration).getWarehouseExportUsage(from, to, projectKey, environmentKey, destination, groupBy, aggregationType, granularity, options).then((request) => request(this.axios, this.basePath));
+ public postEnableAdaptiveTrigger(projectKey: string, environmentKey: string, triggerID: string, options?: RawAxiosRequestConfig) {
+ return AdaptiveTriggersApiFp(this.configuration).postEnableAdaptiveTrigger(projectKey, environmentKey, triggerID, options).then((request) => request(this.axios, this.basePath));
}
}
@@ -16775,8 +19294,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Delete an existing AI Config.
* @summary Delete AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -16808,7 +19327,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -16823,9 +19342,9 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Delete a specific variation of an AI Config by config key and variation key.
* @summary Delete AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -16860,7 +19379,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -16875,8 +19394,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Delete an existing AI tool.
* @summary Delete AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -16908,7 +19427,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -16924,8 +19443,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
* Delete an existing agent graph and all of its edges.
* @summary Delete agent graph
* @param {DeleteAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -16959,7 +19478,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -16977,8 +19496,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Delete an existing agent optimization.
* @summary Delete an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17010,7 +19529,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17026,9 +19545,9 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
* Delete all results for a specific run of an agent optimization. Returns a 404 if the optimization does not exist or if the run has no results. A run whose results have already been deleted is indistinguishable from a run that never existed, so repeating this request also returns a 404.
* @summary Delete an agent optimization run
* @param {DeleteAgentOptimizationRunLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17065,7 +19584,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -17083,8 +19602,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Delete an agent skill, including all of its versions.
* @summary Delete an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17116,7 +19635,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17131,8 +19650,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Delete an AI model config.
* @summary Delete an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17164,7 +19683,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17179,8 +19698,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Delete an existing prompt snippet.
* @summary Delete a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17212,7 +19731,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17227,7 +19746,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Remove AI models, by key, from the restricted list.
* @summary Remove AI models from the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to remove from the restricted list
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -17260,7 +19779,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17276,8 +19795,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve a specific AI Config by its key.
* @summary Get AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17309,7 +19828,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17324,8 +19843,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve usage metrics for an AI Config by config key.
* @summary Get AI Config metrics
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -17388,7 +19907,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17403,8 +19922,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve usage metrics for an AI Config by config key, with results split by variation.
* @summary Get AI Config metrics by variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -17467,7 +19986,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17482,7 +20001,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve aggregate quick stats for AI Configs in a project.
* @summary Get AI Config quick stats
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} env An environment key. Only metrics from this environment will be included.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -17518,7 +20037,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17533,8 +20052,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieves a specific AI Config\'s targeting by its key
* @summary Show an AI Config\'s targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17566,7 +20085,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17581,9 +20100,9 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get an AI Config variation by key. The response includes all variation versions for the given variation key.
* @summary Get AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17618,7 +20137,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17633,7 +20152,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get a list of all AI Configs in the given project.
* @summary List AI Configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -17682,7 +20201,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17697,8 +20216,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve a specific AI tool by its key.
* @summary Get AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17730,7 +20249,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17746,8 +20265,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
* Retrieve a specific agent graph by its key, including its edges.
* @summary Get agent graph
* @param {GetAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17781,7 +20300,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -17799,8 +20318,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve a specific agent optimization by its key.
* @summary Get an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17832,7 +20351,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17847,8 +20366,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve a specific agent skill by its key.
* @summary Get an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17880,7 +20399,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17895,8 +20414,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get an AI model config by key. Specify a version to retrieve a historical custom model config version. Global model configs accept version 0 or 1 and return their current representation.
* @summary Get AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [version] Specific model config version to return. Omit to return the latest version.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -17933,7 +20452,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17948,8 +20467,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Retrieve a specific prompt snippet by its key.
* @summary Get a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -17981,7 +20500,65 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Get all AgentControl config variations that currently reference this tool.
+ * @summary List AI tool references
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ listAIToolReferences: async (projectKey: string, toolKey: string, limit?: number, offset?: number, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('listAIToolReferences', 'projectKey', projectKey)
+ // verify required parameter 'toolKey' is not null or undefined
+ assertParamExists('listAIToolReferences', 'toolKey', toolKey)
+ const localVarPath = `/api/v2/projects/{projectKey}/ai-tools/{toolKey}/references`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"toolKey"}}`, encodeURIComponent(String(toolKey)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ if (limit !== undefined) {
+ localVarQueryParameter['limit'] = limit;
+ }
+
+ if (offset !== undefined) {
+ localVarQueryParameter['offset'] = offset;
+ }
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -17996,8 +20573,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get a list of all versions of an AI tool in the given project.
* @summary List AI tool versions
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -18044,7 +20621,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18059,7 +20636,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get a list of all AI tools in the given project.
* @summary List AI tools
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -18108,7 +20685,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18124,7 +20701,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
* Get a list of all agent graphs in the given project. Returns metadata only, without edge data.
* @summary List agent graphs
* @param {ListAgentGraphsLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -18170,7 +20747,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -18187,9 +20764,9 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
},
/**
* Get the most recent result for each unique run of an agent optimization.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @summary List latest agent optimization result per run
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -18231,59 +20808,117 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
- // CUSTOM-END
-
- setSearchParams(localVarUrlObj, localVarQueryParameter);
- let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
- localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
-
- return {
- url: toPathString(localVarUrlObj),
- options: localVarRequestOptions,
- };
- },
- /**
- * Get all results for a specific run of an agent optimization, sorted by iteration descending.
- * @summary List agent optimization results for a run
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
- * @param {*} [options] Override http request option.
- * @throws {RequiredError}
- */
- listAgentOptimizationResultsByRunId: async (projectKey: string, optimizationKey: string, runId: string, options: RawAxiosRequestConfig = {}): Promise => {
- // verify required parameter 'projectKey' is not null or undefined
- assertParamExists('listAgentOptimizationResultsByRunId', 'projectKey', projectKey)
- // verify required parameter 'optimizationKey' is not null or undefined
- assertParamExists('listAgentOptimizationResultsByRunId', 'optimizationKey', optimizationKey)
- // verify required parameter 'runId' is not null or undefined
- assertParamExists('listAgentOptimizationResultsByRunId', 'runId', runId)
- const localVarPath = `/api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/runs/{runId}/results`
- .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
- .replace(`{${"optimizationKey"}}`, encodeURIComponent(String(optimizationKey)))
- .replace(`{${"runId"}}`, encodeURIComponent(String(runId)));
- // use dummy base URL string because the URL constructor only accepts absolute URLs.
- const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
- let baseOptions;
- if (configuration) {
- baseOptions = configuration.baseOptions;
- }
-
- const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
- const localVarHeaderParameter = {} as any;
- const localVarQueryParameter = {} as any;
-
- // authentication ApiKey required
- await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
-
- localVarHeaderParameter['Accept'] = 'application/json';
-
- // CUSTOM-START
- // Set default API version.
- localVarHeaderParameter['LD-API-Version'] = '20240415';
- // Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Get all results for a specific run of an agent optimization, sorted by iteration descending.
+ * @summary List agent optimization results for a run
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ listAgentOptimizationResultsByRunId: async (projectKey: string, optimizationKey: string, runId: string, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('listAgentOptimizationResultsByRunId', 'projectKey', projectKey)
+ // verify required parameter 'optimizationKey' is not null or undefined
+ assertParamExists('listAgentOptimizationResultsByRunId', 'optimizationKey', optimizationKey)
+ // verify required parameter 'runId' is not null or undefined
+ assertParamExists('listAgentOptimizationResultsByRunId', 'runId', runId)
+ const localVarPath = `/api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/runs/{runId}/results`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"optimizationKey"}}`, encodeURIComponent(String(optimizationKey)))
+ .replace(`{${"runId"}}`, encodeURIComponent(String(runId)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
+ // CUSTOM-END
+
+ setSearchParams(localVarUrlObj, localVarQueryParameter);
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+ localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+ return {
+ url: toPathString(localVarUrlObj),
+ options: localVarRequestOptions,
+ };
+ },
+ /**
+ * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
+ * @summary List agent optimization runs
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ listAgentOptimizationRuns: async (projectKey: string, optimizationKey: string, limit?: number, offset?: number, options: RawAxiosRequestConfig = {}): Promise => {
+ // verify required parameter 'projectKey' is not null or undefined
+ assertParamExists('listAgentOptimizationRuns', 'projectKey', projectKey)
+ // verify required parameter 'optimizationKey' is not null or undefined
+ assertParamExists('listAgentOptimizationRuns', 'optimizationKey', optimizationKey)
+ const localVarPath = `/api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/runs`
+ .replace(`{${"projectKey"}}`, encodeURIComponent(String(projectKey)))
+ .replace(`{${"optimizationKey"}}`, encodeURIComponent(String(optimizationKey)));
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
+ const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+ let baseOptions;
+ if (configuration) {
+ baseOptions = configuration.baseOptions;
+ }
+
+ const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+ const localVarHeaderParameter = {} as any;
+ const localVarQueryParameter = {} as any;
+
+ // authentication ApiKey required
+ await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+ if (limit !== undefined) {
+ localVarQueryParameter['limit'] = limit;
+ }
+
+ if (offset !== undefined) {
+ localVarQueryParameter['offset'] = offset;
+ }
+
+ localVarHeaderParameter['Accept'] = 'application/json';
+
+ // CUSTOM-START
+ // Set default API version.
+ localVarHeaderParameter['LD-API-Version'] = '20240415';
+ // Set a custom LaunchDarkly user agent header.
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18298,7 +20933,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get a list of all agent optimizations in the given project.
* @summary List agent optimizations
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -18342,7 +20977,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18357,8 +20992,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get all config variations that currently reference this agent skill.
* @summary List agent skill references
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -18400,7 +21035,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18415,8 +21050,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get all versions of an agent skill in the given project, ordered by version descending.
* @summary List agent skill versions
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -18458,7 +21093,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18473,7 +21108,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get a list of all agent skills in the given project.
* @summary List agent skills
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -18517,7 +21152,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18532,8 +21167,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get all results across all versions of an agent optimization.
* @summary List all agent optimization results across versions
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -18575,7 +21210,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18590,8 +21225,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get a paginated list of all available versions of an AI model config, ordered from newest to oldest. Global model configs return their single current representation.
* @summary List AI model config versions
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -18633,7 +21268,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18648,12 +21283,14 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get all AI model configs for a project.
* @summary List AI model configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {boolean} [restricted] Whether to return only restricted models
+ * @param {string} [sort] A sort to apply to the list of AgentControl configs.
+ * @param {string} [filter] A filter to apply to the list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- listModelConfigs: async (projectKey: string, restricted?: boolean, options: RawAxiosRequestConfig = {}): Promise => {
+ listModelConfigs: async (projectKey: string, restricted?: boolean, sort?: string, filter?: string, options: RawAxiosRequestConfig = {}): Promise => {
// verify required parameter 'projectKey' is not null or undefined
assertParamExists('listModelConfigs', 'projectKey', projectKey)
const localVarPath = `/api/v2/projects/{projectKey}/ai-configs/model-configs`
@@ -18676,13 +21313,21 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
localVarQueryParameter['restricted'] = restricted;
}
+ if (sort !== undefined) {
+ localVarQueryParameter['sort'] = sort;
+ }
+
+ if (filter !== undefined) {
+ localVarQueryParameter['filter'] = filter;
+ }
+
localVarHeaderParameter['Accept'] = 'application/json';
// CUSTOM-START
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18697,8 +21342,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get all config variations that currently reference this prompt snippet.
* @summary List prompt snippet references
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -18740,7 +21385,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18755,8 +21400,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get all versions of a prompt snippet in the given project, ordered by version descending.
* @summary List prompt snippet versions
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -18798,7 +21443,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18813,7 +21458,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Get a list of all prompt snippets in the given project.
* @summary List prompt snippets
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -18857,7 +21502,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18872,8 +21517,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Edit an existing AI Config. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"description\": \"Example updated description\", \"tags\": [\"new-tag\"] } ```
* @summary Update AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigPatch} [aIConfigPatch] AI Config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -18907,7 +21552,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18923,8 +21568,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Perform a partial update to an AI Config\'s targeting. The request body must be a valid semantic patch. ### Using semantic patches on an AI Config To make a semantic patch request, you must append `domain-model=launchdarkly.semanticpatch` to your `Content-Type` header. To learn more, read [Updates using semantic patch](https://launchdarkly.com/docs/api#updates-using-semantic-patch). The body of a semantic patch request for updating an AI Config\'s targeting takes the following properties: * `comment` (string): (Optional) A description of the update. * `environmentKey` (string): The key of the LaunchDarkly environment. * `instructions` (array): (Required) A list of actions the update should perform. Each action in the list must be an object with a `kind` property that indicates the instruction. If the action requires parameters, you must include those parameters as additional fields in the object. The body of a single semantic patch can contain many different instructions. ### Instructions Semantic patch requests support the following `kind` instructions for updating AI Configs. Click to expand instructions for working with targeting and variations for AI Configs
#### addClauses Adds the given clauses to the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauses\": [{ \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"USA\", \"Canada\"] }] }] } ``` #### addRule Adds a new targeting rule to the AI Config. The rule may contain `clauses` and serve the variation that `variationId` indicates, or serve a percentage rollout that `rolloutWeights`, `rolloutBucketBy`, and `rolloutContextKind` indicate. If you set `beforeRuleId`, this adds the new rule before the indicated rule. Otherwise, adds the new rule to the end of the list. ##### Parameters - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. - `beforeRuleId`: (Optional) ID of a rule. - Either - `variationId`: ID of a variation. or - `rolloutWeights`: (Optional) Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }] }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }], \"rolloutContextKind\": \"organization\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### addTargets Adds context keys to the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Returns an error if this causes the AI Config to target the same context key in multiple variations. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### addValuesToClause Adds `values` to the values of the clause that `ruleId` and `clauseId` indicate. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addValuesToClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### clearTargets Removes all individual targets from the variation that `variationId` specifies. This includes both user and non-user targets. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"clearTargets\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### removeClauses Removes the clauses specified by `clauseIds` from the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule. - `clauseIds`: Array of IDs of clauses in the rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseIds\": [\"10a58772-3121-400f-846b-b8a04e8944ed\", \"36a461dc-235e-4b08-97b9-73ce9365873e\"] }] } ``` #### removeRule Removes the targeting rule specified by `ruleId`. Does nothing if the rule does not exist. ##### Parameters - `ruleId`: ID of a rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"removeRule\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" } ] } ``` #### removeTargets Removes context keys from the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Does nothing if the flag does not target the context keys. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### removeValuesFromClause Removes `values` from the values of the clause indicated by `ruleId` and `clauseId`. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeValuesFromClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### reorderRules Rearranges the rules to match the order given in `ruleIds`. Returns an error if `ruleIds` does not match the current set of rules on the AI Config. ##### Parameters - `ruleIds`: Array of IDs of all rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"reorderRules\", \"ruleIds\": [\"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"63c238d1-835d-435e-8f21-c8d5e40b2a3d\"] }] } ``` #### replaceRules Removes all targeting rules for the AI Config and replaces them with the list you provide. ##### Parameters - `rules`: A list of rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceRules\", \"rules\": [ { \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"description\": \"My new rule\", \"clauses\": [ { \"contextKind\": \"user\", \"attribute\": \"segmentMatch\", \"op\": \"segmentMatch\", \"values\": [\"test\"] } ] } ] } ] } ``` #### replaceTargets Removes all existing targeting and replaces it with the list of targets you provide. ##### Parameters - `targets`: A list of context targeting. Each item in the list includes an optional `contextKind` that defaults to `user`, a required `variationId`, and a required list of `values`. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceTargets\", \"targets\": [ { \"contextKind\": \"user\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"values\": [\"user-key-123abc\"] }, { \"contextKind\": \"device\", \"variationId\": \"e5830889-1ec5-4b0c-9cc9-c48790090c43\", \"values\": [\"device-key-456def\"] } ] } ] } ``` #### updateClause Replaces the clause indicated by `ruleId` and `clauseId` with `clause`. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `clause`: New `clause` object, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10c7462a-2062-45ba-a8bb-dfb3de0f8af5\", \"clause\": { \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"Mexico\", \"Canada\"] } }] } ``` #### updateDefaultVariation Updates the default on or off variation of the AI Config. ##### Parameters - `onVariationValue`: (Optional) The value of the variation of the new on variation. - `offVariationValue`: (Optional) The value of the variation of the new off variation Here\'s an example: ```json { \"instructions\": [ { \"kind\": \"updateDefaultVariation\", \"OnVariationValue\": true, \"OffVariationValue\": false } ] } ``` #### updateFallthroughVariationOrRollout Updates the default or \"fallthrough\" rule for the AI Config, which the AI Config serves when a context matches none of the targeting rules. The rule can serve either the variation that `variationId` indicates, or a percentage rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"rolloutContextKind\": \"user\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### updateOffVariation Updates the default off variation to `variationId`. The AI Config serves the default off variation when the AI Config\'s targeting is **Off**. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateOffVariation\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### updateRuleDescription Updates the description of the targeting rule. ##### Parameters - `description`: The new human-readable description for this rule. - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleDescription\", \"description\": \"New rule description\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" }] } ``` #### updateRuleTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config associated with this rule. ##### Parameters - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleTrackEvents\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"trackEvents\": true }] } ``` #### updateRuleVariationOrRollout Updates what `ruleId` serves when its clauses evaluate to true. The rule can serve either the variation that `variationId` indicates, or a percent rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `ruleId`: ID of a rule. - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleVariationOrRollout\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### updateTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config, for all rules. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEvents\", \"trackEvents\": true } ] } ``` #### updateTrackEventsFallthrough Updates whether or not LaunchDarkly tracks events for the AI Config, for the default rule. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEventsFallthrough\", \"trackEvents\": true } ] } ```
* @summary Update AI Config targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigTargetingPatch} [aIConfigTargetingPatch] AI Config targeting semantic patch instructions
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -18958,7 +21603,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -18972,11 +21617,11 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
};
},
/**
- * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
+ * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the variation is in use in a project environment where approval settings require review for this AI Config, this endpoint returns 403 and the change must be submitted through an approval request. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
* @summary Update AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {AIConfigVariationPatch} [aIConfigVariationPatch] AI Config variation object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19013,7 +21658,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19029,8 +21674,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Edit an existing AI tool.
* @summary Update AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {AIToolPatch} [aIToolPatch] AI tool object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19064,7 +21709,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19081,8 +21726,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
* Edit an existing agent graph. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the update includes `rootConfigKey` or `edges`, both must be present and will be treated as full replacements.
* @summary Update agent graph
* @param {PatchAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {AgentGraphPatch} [agentGraphPatch] Agent graph object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19118,7 +21763,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -19137,8 +21782,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Update an existing agent optimization. Creates a new version of the optimization.
* @summary Update an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationPatch} agentOptimizationPatch Agent optimization fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19174,7 +21819,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19190,9 +21835,9 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Update status, activity, and AI request metadata fields on an agent optimization result.
* @summary Update an agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} resultId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} resultId The agent optimization result ID
* @param {AgentOptimizationResultPatch} agentOptimizationResultPatch Agent optimization result fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19231,7 +21876,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19247,8 +21892,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Update an existing agent skill. Creates a new version of the skill.
* @summary Update an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {AgentSkillPatch} agentSkillPatch Agent skill fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19284,7 +21929,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19300,8 +21945,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Update an AI model config.
* @summary Update an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {ModelConfigPatch} modelConfigPatch AI model config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19337,7 +21982,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19353,8 +21998,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Update an existing prompt snippet. Creates a new version of the snippet.
* @summary Update a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {PromptSnippetPatch} promptSnippetPatch Prompt snippet fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19390,7 +22035,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19406,7 +22051,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create a new AI Config within the given project.
* @summary Create new AI Config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIConfigPost} aIConfigPost AI Config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19439,7 +22084,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19455,8 +22100,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create a new variation for a given AI Config. The model in the request body requires a modelName and parameters, for example: ``` \"model\": { \"modelName\": \"claude-3-opus-20240229\", \"parameters\": { \"max_tokens\": 1024 } } ```
* @summary Create AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigVariationPost} aIConfigVariationPost AI Config variation object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19492,7 +22137,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19508,7 +22153,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create an AI tool
* @summary Create an AI tool
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIToolPost} aIToolPost AI tool object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19541,7 +22186,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19558,7 +22203,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
* Create a new agent graph within the given project.
* @summary Create new agent graph
* @param {PostAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentGraphPost} agentGraphPost Agent graph object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19593,7 +22238,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -19612,7 +22257,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create a new agent optimization within the given project.
* @summary Create agent optimization
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentOptimizationPost} agentOptimizationPost Agent optimization object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19645,7 +22290,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19661,8 +22306,8 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create a new result for an agent optimization run.
* @summary Create agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationResultPost} agentOptimizationResultPost Agent optimization result to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19698,7 +22343,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19714,7 +22359,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create a new agent skill within the given project.
* @summary Create an agent skill
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentSkillPost} agentSkillPost Agent skill object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19747,7 +22392,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19763,7 +22408,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create an AI model config. You can use this in any variation for any config in your project.
* @summary Create an AI model config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {ModelConfigPost} modelConfigPost AI model config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19796,7 +22441,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19812,7 +22457,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Create a new prompt snippet within the given project.
* @summary Create a prompt snippet
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {PromptSnippetPost} promptSnippetPost Prompt snippet object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19845,7 +22490,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19861,7 +22506,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
/**
* Add AI models, by key, to the restricted list. Keys are included in the response from the [List AI model configs](https://launchdarkly.com/docs/api/agent-control/list-model-configs) endpoint.
* @summary Add AI models to the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to add to the restricted list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -19894,7 +22539,7 @@ export const AgentControlApiAxiosParamCreator = function (configuration?: Config
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -19919,8 +22564,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Delete an existing AI Config.
* @summary Delete AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -19933,9 +22578,9 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Delete a specific variation of an AI Config by config key and variation key.
* @summary Delete AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -19948,8 +22593,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Delete an existing AI tool.
* @summary Delete AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -19963,8 +22608,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
* Delete an existing agent graph and all of its edges.
* @summary Delete agent graph
* @param {DeleteAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -19977,8 +22622,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Delete an existing agent optimization.
* @summary Delete an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -19992,9 +22637,9 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
* Delete all results for a specific run of an agent optimization. Returns a 404 if the optimization does not exist or if the run has no results. A run whose results have already been deleted is indistinguishable from a run that never existed, so repeating this request also returns a 404.
* @summary Delete an agent optimization run
* @param {DeleteAgentOptimizationRunLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20007,8 +22652,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Delete an agent skill, including all of its versions.
* @summary Delete an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20021,8 +22666,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Delete an AI model config.
* @summary Delete an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20035,8 +22680,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Delete an existing prompt snippet.
* @summary Delete a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20049,7 +22694,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Remove AI models, by key, from the restricted list.
* @summary Remove AI models from the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to remove from the restricted list
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20063,8 +22708,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve a specific AI Config by its key.
* @summary Get AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20077,8 +22722,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve usage metrics for an AI Config by config key.
* @summary Get AI Config metrics
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -20096,8 +22741,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve usage metrics for an AI Config by config key, with results split by variation.
* @summary Get AI Config metrics by variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -20115,7 +22760,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve aggregate quick stats for AI Configs in a project.
* @summary Get AI Config quick stats
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} env An environment key. Only metrics from this environment will be included.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20129,8 +22774,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieves a specific AI Config\'s targeting by its key
* @summary Show an AI Config\'s targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20143,9 +22788,9 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get an AI Config variation by key. The response includes all variation versions for the given variation key.
* @summary Get AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20158,7 +22803,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get a list of all AI Configs in the given project.
* @summary List AI Configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -20175,8 +22820,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve a specific AI tool by its key.
* @summary Get AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20190,8 +22835,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
* Retrieve a specific agent graph by its key, including its edges.
* @summary Get agent graph
* @param {GetAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20204,8 +22849,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve a specific agent optimization by its key.
* @summary Get an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20218,8 +22863,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve a specific agent skill by its key.
* @summary Get an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20232,8 +22877,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get an AI model config by key. Specify a version to retrieve a historical custom model config version. Global model configs accept version 0 or 1 and return their current representation.
* @summary Get AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [version] Specific model config version to return. Omit to return the latest version.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20247,8 +22892,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Retrieve a specific prompt snippet by its key.
* @summary Get a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20258,11 +22903,27 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
const localVarOperationServerBasePath = operationServerMap['AgentControlApi.getPromptSnippet']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
+ /**
+ * Get all AgentControl config variations that currently reference this tool.
+ * @summary List AI tool references
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async listAIToolReferences(projectKey: string, toolKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.listAIToolReferences(projectKey, toolKey, limit, offset, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AgentControlApi.listAIToolReferences']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
/**
* Get a list of all versions of an AI tool in the given project.
* @summary List AI tool versions
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -20278,7 +22939,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get a list of all AI tools in the given project.
* @summary List AI tools
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -20296,7 +22957,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
* Get a list of all agent graphs in the given project. Returns metadata only, without edge data.
* @summary List agent graphs
* @param {ListAgentGraphsLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -20311,9 +22972,9 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
},
/**
* Get the most recent result for each unique run of an agent optimization.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @summary List latest agent optimization result per run
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -20328,9 +22989,9 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get all results for a specific run of an agent optimization, sorted by iteration descending.
* @summary List agent optimization results for a run
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20340,10 +23001,26 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
const localVarOperationServerBasePath = operationServerMap['AgentControlApi.listAgentOptimizationResultsByRunId']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
+ /**
+ * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
+ * @summary List agent optimization runs
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ async listAgentOptimizationRuns(projectKey: string, optimizationKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.listAgentOptimizationRuns(projectKey, optimizationKey, limit, offset, options);
+ const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+ const localVarOperationServerBasePath = operationServerMap['AgentControlApi.listAgentOptimizationRuns']?.[localVarOperationServerIndex]?.url;
+ return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+ },
/**
* Get a list of all agent optimizations in the given project.
* @summary List agent optimizations
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -20359,8 +23036,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get all config variations that currently reference this agent skill.
* @summary List agent skill references
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -20375,8 +23052,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get all versions of an agent skill in the given project, ordered by version descending.
* @summary List agent skill versions
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -20391,7 +23068,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get a list of all agent skills in the given project.
* @summary List agent skills
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -20407,8 +23084,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get all results across all versions of an agent optimization.
* @summary List all agent optimization results across versions
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -20423,8 +23100,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get a paginated list of all available versions of an AI model config, ordered from newest to oldest. Global model configs return their single current representation.
* @summary List AI model config versions
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -20439,13 +23116,15 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get all AI model configs for a project.
* @summary List AI model configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {boolean} [restricted] Whether to return only restricted models
+ * @param {string} [sort] A sort to apply to the list of AgentControl configs.
+ * @param {string} [filter] A filter to apply to the list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- async listModelConfigs(projectKey: string, restricted?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise>> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.listModelConfigs(projectKey, restricted, options);
+ async listModelConfigs(projectKey: string, restricted?: boolean, sort?: string, filter?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise>> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.listModelConfigs(projectKey, restricted, sort, filter, options);
const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
const localVarOperationServerBasePath = operationServerMap['AgentControlApi.listModelConfigs']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -20453,8 +23132,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get all config variations that currently reference this prompt snippet.
* @summary List prompt snippet references
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -20469,8 +23148,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get all versions of a prompt snippet in the given project, ordered by version descending.
* @summary List prompt snippet versions
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -20485,7 +23164,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Get a list of all prompt snippets in the given project.
* @summary List prompt snippets
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -20501,8 +23180,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Edit an existing AI Config. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"description\": \"Example updated description\", \"tags\": [\"new-tag\"] } ```
* @summary Update AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigPatch} [aIConfigPatch] AI Config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20516,8 +23195,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Perform a partial update to an AI Config\'s targeting. The request body must be a valid semantic patch. ### Using semantic patches on an AI Config To make a semantic patch request, you must append `domain-model=launchdarkly.semanticpatch` to your `Content-Type` header. To learn more, read [Updates using semantic patch](https://launchdarkly.com/docs/api#updates-using-semantic-patch). The body of a semantic patch request for updating an AI Config\'s targeting takes the following properties: * `comment` (string): (Optional) A description of the update. * `environmentKey` (string): The key of the LaunchDarkly environment. * `instructions` (array): (Required) A list of actions the update should perform. Each action in the list must be an object with a `kind` property that indicates the instruction. If the action requires parameters, you must include those parameters as additional fields in the object. The body of a single semantic patch can contain many different instructions. ### Instructions Semantic patch requests support the following `kind` instructions for updating AI Configs. Click to expand instructions for working with targeting and variations for AI Configs
#### addClauses Adds the given clauses to the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauses\": [{ \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"USA\", \"Canada\"] }] }] } ``` #### addRule Adds a new targeting rule to the AI Config. The rule may contain `clauses` and serve the variation that `variationId` indicates, or serve a percentage rollout that `rolloutWeights`, `rolloutBucketBy`, and `rolloutContextKind` indicate. If you set `beforeRuleId`, this adds the new rule before the indicated rule. Otherwise, adds the new rule to the end of the list. ##### Parameters - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. - `beforeRuleId`: (Optional) ID of a rule. - Either - `variationId`: ID of a variation. or - `rolloutWeights`: (Optional) Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }] }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }], \"rolloutContextKind\": \"organization\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### addTargets Adds context keys to the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Returns an error if this causes the AI Config to target the same context key in multiple variations. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### addValuesToClause Adds `values` to the values of the clause that `ruleId` and `clauseId` indicate. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addValuesToClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### clearTargets Removes all individual targets from the variation that `variationId` specifies. This includes both user and non-user targets. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"clearTargets\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### removeClauses Removes the clauses specified by `clauseIds` from the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule. - `clauseIds`: Array of IDs of clauses in the rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseIds\": [\"10a58772-3121-400f-846b-b8a04e8944ed\", \"36a461dc-235e-4b08-97b9-73ce9365873e\"] }] } ``` #### removeRule Removes the targeting rule specified by `ruleId`. Does nothing if the rule does not exist. ##### Parameters - `ruleId`: ID of a rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"removeRule\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" } ] } ``` #### removeTargets Removes context keys from the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Does nothing if the flag does not target the context keys. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### removeValuesFromClause Removes `values` from the values of the clause indicated by `ruleId` and `clauseId`. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeValuesFromClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### reorderRules Rearranges the rules to match the order given in `ruleIds`. Returns an error if `ruleIds` does not match the current set of rules on the AI Config. ##### Parameters - `ruleIds`: Array of IDs of all rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"reorderRules\", \"ruleIds\": [\"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"63c238d1-835d-435e-8f21-c8d5e40b2a3d\"] }] } ``` #### replaceRules Removes all targeting rules for the AI Config and replaces them with the list you provide. ##### Parameters - `rules`: A list of rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceRules\", \"rules\": [ { \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"description\": \"My new rule\", \"clauses\": [ { \"contextKind\": \"user\", \"attribute\": \"segmentMatch\", \"op\": \"segmentMatch\", \"values\": [\"test\"] } ] } ] } ] } ``` #### replaceTargets Removes all existing targeting and replaces it with the list of targets you provide. ##### Parameters - `targets`: A list of context targeting. Each item in the list includes an optional `contextKind` that defaults to `user`, a required `variationId`, and a required list of `values`. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceTargets\", \"targets\": [ { \"contextKind\": \"user\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"values\": [\"user-key-123abc\"] }, { \"contextKind\": \"device\", \"variationId\": \"e5830889-1ec5-4b0c-9cc9-c48790090c43\", \"values\": [\"device-key-456def\"] } ] } ] } ``` #### updateClause Replaces the clause indicated by `ruleId` and `clauseId` with `clause`. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `clause`: New `clause` object, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10c7462a-2062-45ba-a8bb-dfb3de0f8af5\", \"clause\": { \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"Mexico\", \"Canada\"] } }] } ``` #### updateDefaultVariation Updates the default on or off variation of the AI Config. ##### Parameters - `onVariationValue`: (Optional) The value of the variation of the new on variation. - `offVariationValue`: (Optional) The value of the variation of the new off variation Here\'s an example: ```json { \"instructions\": [ { \"kind\": \"updateDefaultVariation\", \"OnVariationValue\": true, \"OffVariationValue\": false } ] } ``` #### updateFallthroughVariationOrRollout Updates the default or \"fallthrough\" rule for the AI Config, which the AI Config serves when a context matches none of the targeting rules. The rule can serve either the variation that `variationId` indicates, or a percentage rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"rolloutContextKind\": \"user\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### updateOffVariation Updates the default off variation to `variationId`. The AI Config serves the default off variation when the AI Config\'s targeting is **Off**. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateOffVariation\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### updateRuleDescription Updates the description of the targeting rule. ##### Parameters - `description`: The new human-readable description for this rule. - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleDescription\", \"description\": \"New rule description\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" }] } ``` #### updateRuleTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config associated with this rule. ##### Parameters - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleTrackEvents\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"trackEvents\": true }] } ``` #### updateRuleVariationOrRollout Updates what `ruleId` serves when its clauses evaluate to true. The rule can serve either the variation that `variationId` indicates, or a percent rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `ruleId`: ID of a rule. - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleVariationOrRollout\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### updateTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config, for all rules. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEvents\", \"trackEvents\": true } ] } ``` #### updateTrackEventsFallthrough Updates whether or not LaunchDarkly tracks events for the AI Config, for the default rule. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEventsFallthrough\", \"trackEvents\": true } ] } ```
* @summary Update AI Config targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigTargetingPatch} [aIConfigTargetingPatch] AI Config targeting semantic patch instructions
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20529,11 +23208,11 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
/**
- * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
+ * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the variation is in use in a project environment where approval settings require review for this AI Config, this endpoint returns 403 and the change must be submitted through an approval request. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
* @summary Update AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {AIConfigVariationPatch} [aIConfigVariationPatch] AI Config variation object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20547,8 +23226,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Edit an existing AI tool.
* @summary Update AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {AIToolPatch} [aIToolPatch] AI tool object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20563,8 +23242,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
* Edit an existing agent graph. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the update includes `rootConfigKey` or `edges`, both must be present and will be treated as full replacements.
* @summary Update agent graph
* @param {PatchAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {AgentGraphPatch} [agentGraphPatch] Agent graph object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20578,8 +23257,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Update an existing agent optimization. Creates a new version of the optimization.
* @summary Update an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationPatch} agentOptimizationPatch Agent optimization fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20593,9 +23272,9 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Update status, activity, and AI request metadata fields on an agent optimization result.
* @summary Update an agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} resultId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} resultId The agent optimization result ID
* @param {AgentOptimizationResultPatch} agentOptimizationResultPatch Agent optimization result fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20609,8 +23288,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Update an existing agent skill. Creates a new version of the skill.
* @summary Update an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {AgentSkillPatch} agentSkillPatch Agent skill fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20624,8 +23303,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Update an AI model config.
* @summary Update an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {ModelConfigPatch} modelConfigPatch AI model config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20639,8 +23318,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Update an existing prompt snippet. Creates a new version of the snippet.
* @summary Update a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {PromptSnippetPatch} promptSnippetPatch Prompt snippet fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20654,7 +23333,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create a new AI Config within the given project.
* @summary Create new AI Config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIConfigPost} aIConfigPost AI Config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20668,8 +23347,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create a new variation for a given AI Config. The model in the request body requires a modelName and parameters, for example: ``` \"model\": { \"modelName\": \"claude-3-opus-20240229\", \"parameters\": { \"max_tokens\": 1024 } } ```
* @summary Create AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigVariationPost} aIConfigVariationPost AI Config variation object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20683,7 +23362,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create an AI tool
* @summary Create an AI tool
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIToolPost} aIToolPost AI tool object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20698,7 +23377,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
* Create a new agent graph within the given project.
* @summary Create new agent graph
* @param {PostAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentGraphPost} agentGraphPost Agent graph object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20712,7 +23391,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create a new agent optimization within the given project.
* @summary Create agent optimization
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentOptimizationPost} agentOptimizationPost Agent optimization object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20726,8 +23405,8 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create a new result for an agent optimization run.
* @summary Create agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationResultPost} agentOptimizationResultPost Agent optimization result to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20741,7 +23420,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create a new agent skill within the given project.
* @summary Create an agent skill
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentSkillPost} agentSkillPost Agent skill object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20755,7 +23434,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create an AI model config. You can use this in any variation for any config in your project.
* @summary Create an AI model config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {ModelConfigPost} modelConfigPost AI model config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20769,7 +23448,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Create a new prompt snippet within the given project.
* @summary Create a prompt snippet
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {PromptSnippetPost} promptSnippetPost Prompt snippet object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20783,7 +23462,7 @@ export const AgentControlApiFp = function(configuration?: Configuration) {
/**
* Add AI models, by key, to the restricted list. Keys are included in the response from the [List AI model configs](https://launchdarkly.com/docs/api/agent-control/list-model-configs) endpoint.
* @summary Add AI models to the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to add to the restricted list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20806,8 +23485,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Delete an existing AI Config.
* @summary Delete AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20817,9 +23496,9 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Delete a specific variation of an AI Config by config key and variation key.
* @summary Delete AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20829,8 +23508,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Delete an existing AI tool.
* @summary Delete AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20841,8 +23520,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
* Delete an existing agent graph and all of its edges.
* @summary Delete agent graph
* @param {DeleteAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20852,8 +23531,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Delete an existing agent optimization.
* @summary Delete an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20864,9 +23543,9 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
* Delete all results for a specific run of an agent optimization. Returns a 404 if the optimization does not exist or if the run has no results. A run whose results have already been deleted is indistinguishable from a run that never existed, so repeating this request also returns a 404.
* @summary Delete an agent optimization run
* @param {DeleteAgentOptimizationRunLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20876,8 +23555,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Delete an agent skill, including all of its versions.
* @summary Delete an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20887,8 +23566,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Delete an AI model config.
* @summary Delete an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20898,8 +23577,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Delete an existing prompt snippet.
* @summary Delete a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20909,7 +23588,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Remove AI models, by key, from the restricted list.
* @summary Remove AI models from the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to remove from the restricted list
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20920,8 +23599,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve a specific AI Config by its key.
* @summary Get AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20931,8 +23610,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve usage metrics for an AI Config by config key.
* @summary Get AI Config metrics
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -20947,8 +23626,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve usage metrics for an AI Config by config key, with results split by variation.
* @summary Get AI Config metrics by variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -20963,7 +23642,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve aggregate quick stats for AI Configs in a project.
* @summary Get AI Config quick stats
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} env An environment key. Only metrics from this environment will be included.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -20974,8 +23653,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieves a specific AI Config\'s targeting by its key
* @summary Show an AI Config\'s targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20985,9 +23664,9 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get an AI Config variation by key. The response includes all variation versions for the given variation key.
* @summary Get AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -20997,7 +23676,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get a list of all AI Configs in the given project.
* @summary List AI Configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -21011,8 +23690,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve a specific AI tool by its key.
* @summary Get AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21023,8 +23702,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
* Retrieve a specific agent graph by its key, including its edges.
* @summary Get agent graph
* @param {GetAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21034,8 +23713,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve a specific agent optimization by its key.
* @summary Get an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21045,8 +23724,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve a specific agent skill by its key.
* @summary Get an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21056,8 +23735,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get an AI model config by key. Specify a version to retrieve a historical custom model config version. Global model configs accept version 0 or 1 and return their current representation.
* @summary Get AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [version] Specific model config version to return. Omit to return the latest version.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21068,19 +23747,32 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Retrieve a specific prompt snippet by its key.
* @summary Get a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
getPromptSnippet(projectKey: string, snippetKey: string, options?: RawAxiosRequestConfig): AxiosPromise {
return localVarFp.getPromptSnippet(projectKey, snippetKey, options).then((request) => request(axios, basePath));
},
+ /**
+ * Get all AgentControl config variations that currently reference this tool.
+ * @summary List AI tool references
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ listAIToolReferences(projectKey: string, toolKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.listAIToolReferences(projectKey, toolKey, limit, offset, options).then((request) => request(axios, basePath));
+ },
/**
* Get a list of all versions of an AI tool in the given project.
* @summary List AI tool versions
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -21093,7 +23785,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get a list of all AI tools in the given project.
* @summary List AI tools
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -21108,7 +23800,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
* Get a list of all agent graphs in the given project. Returns metadata only, without edge data.
* @summary List agent graphs
* @param {ListAgentGraphsLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -21120,9 +23812,9 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
},
/**
* Get the most recent result for each unique run of an agent optimization.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @summary List latest agent optimization result per run
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21134,19 +23826,32 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get all results for a specific run of an agent optimization, sorted by iteration descending.
* @summary List agent optimization results for a run
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
listAgentOptimizationResultsByRunId(projectKey: string, optimizationKey: string, runId: string, options?: RawAxiosRequestConfig): AxiosPromise {
return localVarFp.listAgentOptimizationResultsByRunId(projectKey, optimizationKey, runId, options).then((request) => request(axios, basePath));
},
+ /**
+ * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
+ * @summary List agent optimization runs
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ listAgentOptimizationRuns(projectKey: string, optimizationKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.listAgentOptimizationRuns(projectKey, optimizationKey, limit, offset, options).then((request) => request(axios, basePath));
+ },
/**
* Get a list of all agent optimizations in the given project.
* @summary List agent optimizations
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -21159,8 +23864,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get all config variations that currently reference this agent skill.
* @summary List agent skill references
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21172,8 +23877,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get all versions of an agent skill in the given project, ordered by version descending.
* @summary List agent skill versions
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21185,7 +23890,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get a list of all agent skills in the given project.
* @summary List agent skills
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -21198,8 +23903,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get all results across all versions of an agent optimization.
* @summary List all agent optimization results across versions
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21211,8 +23916,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get a paginated list of all available versions of an AI model config, ordered from newest to oldest. Global model configs return their single current representation.
* @summary List AI model config versions
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21224,19 +23929,21 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get all AI model configs for a project.
* @summary List AI model configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {boolean} [restricted] Whether to return only restricted models
+ * @param {string} [sort] A sort to apply to the list of AgentControl configs.
+ * @param {string} [filter] A filter to apply to the list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- listModelConfigs(projectKey: string, restricted?: boolean, options?: RawAxiosRequestConfig): AxiosPromise> {
- return localVarFp.listModelConfigs(projectKey, restricted, options).then((request) => request(axios, basePath));
+ listModelConfigs(projectKey: string, restricted?: boolean, sort?: string, filter?: string, options?: RawAxiosRequestConfig): AxiosPromise> {
+ return localVarFp.listModelConfigs(projectKey, restricted, sort, filter, options).then((request) => request(axios, basePath));
},
/**
* Get all config variations that currently reference this prompt snippet.
* @summary List prompt snippet references
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21248,8 +23955,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get all versions of a prompt snippet in the given project, ordered by version descending.
* @summary List prompt snippet versions
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21261,7 +23968,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Get a list of all prompt snippets in the given project.
* @summary List prompt snippets
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -21274,8 +23981,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Edit an existing AI Config. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"description\": \"Example updated description\", \"tags\": [\"new-tag\"] } ```
* @summary Update AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigPatch} [aIConfigPatch] AI Config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21286,8 +23993,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Perform a partial update to an AI Config\'s targeting. The request body must be a valid semantic patch. ### Using semantic patches on an AI Config To make a semantic patch request, you must append `domain-model=launchdarkly.semanticpatch` to your `Content-Type` header. To learn more, read [Updates using semantic patch](https://launchdarkly.com/docs/api#updates-using-semantic-patch). The body of a semantic patch request for updating an AI Config\'s targeting takes the following properties: * `comment` (string): (Optional) A description of the update. * `environmentKey` (string): The key of the LaunchDarkly environment. * `instructions` (array): (Required) A list of actions the update should perform. Each action in the list must be an object with a `kind` property that indicates the instruction. If the action requires parameters, you must include those parameters as additional fields in the object. The body of a single semantic patch can contain many different instructions. ### Instructions Semantic patch requests support the following `kind` instructions for updating AI Configs. Click to expand instructions for working with targeting and variations for AI Configs
#### addClauses Adds the given clauses to the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauses\": [{ \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"USA\", \"Canada\"] }] }] } ``` #### addRule Adds a new targeting rule to the AI Config. The rule may contain `clauses` and serve the variation that `variationId` indicates, or serve a percentage rollout that `rolloutWeights`, `rolloutBucketBy`, and `rolloutContextKind` indicate. If you set `beforeRuleId`, this adds the new rule before the indicated rule. Otherwise, adds the new rule to the end of the list. ##### Parameters - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. - `beforeRuleId`: (Optional) ID of a rule. - Either - `variationId`: ID of a variation. or - `rolloutWeights`: (Optional) Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }] }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }], \"rolloutContextKind\": \"organization\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### addTargets Adds context keys to the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Returns an error if this causes the AI Config to target the same context key in multiple variations. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### addValuesToClause Adds `values` to the values of the clause that `ruleId` and `clauseId` indicate. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addValuesToClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### clearTargets Removes all individual targets from the variation that `variationId` specifies. This includes both user and non-user targets. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"clearTargets\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### removeClauses Removes the clauses specified by `clauseIds` from the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule. - `clauseIds`: Array of IDs of clauses in the rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseIds\": [\"10a58772-3121-400f-846b-b8a04e8944ed\", \"36a461dc-235e-4b08-97b9-73ce9365873e\"] }] } ``` #### removeRule Removes the targeting rule specified by `ruleId`. Does nothing if the rule does not exist. ##### Parameters - `ruleId`: ID of a rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"removeRule\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" } ] } ``` #### removeTargets Removes context keys from the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Does nothing if the flag does not target the context keys. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### removeValuesFromClause Removes `values` from the values of the clause indicated by `ruleId` and `clauseId`. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeValuesFromClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### reorderRules Rearranges the rules to match the order given in `ruleIds`. Returns an error if `ruleIds` does not match the current set of rules on the AI Config. ##### Parameters - `ruleIds`: Array of IDs of all rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"reorderRules\", \"ruleIds\": [\"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"63c238d1-835d-435e-8f21-c8d5e40b2a3d\"] }] } ``` #### replaceRules Removes all targeting rules for the AI Config and replaces them with the list you provide. ##### Parameters - `rules`: A list of rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceRules\", \"rules\": [ { \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"description\": \"My new rule\", \"clauses\": [ { \"contextKind\": \"user\", \"attribute\": \"segmentMatch\", \"op\": \"segmentMatch\", \"values\": [\"test\"] } ] } ] } ] } ``` #### replaceTargets Removes all existing targeting and replaces it with the list of targets you provide. ##### Parameters - `targets`: A list of context targeting. Each item in the list includes an optional `contextKind` that defaults to `user`, a required `variationId`, and a required list of `values`. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceTargets\", \"targets\": [ { \"contextKind\": \"user\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"values\": [\"user-key-123abc\"] }, { \"contextKind\": \"device\", \"variationId\": \"e5830889-1ec5-4b0c-9cc9-c48790090c43\", \"values\": [\"device-key-456def\"] } ] } ] } ``` #### updateClause Replaces the clause indicated by `ruleId` and `clauseId` with `clause`. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `clause`: New `clause` object, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10c7462a-2062-45ba-a8bb-dfb3de0f8af5\", \"clause\": { \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"Mexico\", \"Canada\"] } }] } ``` #### updateDefaultVariation Updates the default on or off variation of the AI Config. ##### Parameters - `onVariationValue`: (Optional) The value of the variation of the new on variation. - `offVariationValue`: (Optional) The value of the variation of the new off variation Here\'s an example: ```json { \"instructions\": [ { \"kind\": \"updateDefaultVariation\", \"OnVariationValue\": true, \"OffVariationValue\": false } ] } ``` #### updateFallthroughVariationOrRollout Updates the default or \"fallthrough\" rule for the AI Config, which the AI Config serves when a context matches none of the targeting rules. The rule can serve either the variation that `variationId` indicates, or a percentage rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"rolloutContextKind\": \"user\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### updateOffVariation Updates the default off variation to `variationId`. The AI Config serves the default off variation when the AI Config\'s targeting is **Off**. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateOffVariation\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### updateRuleDescription Updates the description of the targeting rule. ##### Parameters - `description`: The new human-readable description for this rule. - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleDescription\", \"description\": \"New rule description\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" }] } ``` #### updateRuleTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config associated with this rule. ##### Parameters - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleTrackEvents\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"trackEvents\": true }] } ``` #### updateRuleVariationOrRollout Updates what `ruleId` serves when its clauses evaluate to true. The rule can serve either the variation that `variationId` indicates, or a percent rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `ruleId`: ID of a rule. - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleVariationOrRollout\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### updateTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config, for all rules. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEvents\", \"trackEvents\": true } ] } ``` #### updateTrackEventsFallthrough Updates whether or not LaunchDarkly tracks events for the AI Config, for the default rule. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEventsFallthrough\", \"trackEvents\": true } ] } ```
* @summary Update AI Config targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigTargetingPatch} [aIConfigTargetingPatch] AI Config targeting semantic patch instructions
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21296,11 +24003,11 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
return localVarFp.patchAIConfigTargeting(projectKey, configKey, aIConfigTargetingPatch, options).then((request) => request(axios, basePath));
},
/**
- * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
+ * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the variation is in use in a project environment where approval settings require review for this AI Config, this endpoint returns 403 and the change must be submitted through an approval request. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
* @summary Update AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {AIConfigVariationPatch} [aIConfigVariationPatch] AI Config variation object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21311,8 +24018,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Edit an existing AI tool.
* @summary Update AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {AIToolPatch} [aIToolPatch] AI tool object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21324,8 +24031,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
* Edit an existing agent graph. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the update includes `rootConfigKey` or `edges`, both must be present and will be treated as full replacements.
* @summary Update agent graph
* @param {PatchAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {AgentGraphPatch} [agentGraphPatch] Agent graph object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21336,8 +24043,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Update an existing agent optimization. Creates a new version of the optimization.
* @summary Update an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationPatch} agentOptimizationPatch Agent optimization fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21348,9 +24055,9 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Update status, activity, and AI request metadata fields on an agent optimization result.
* @summary Update an agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} resultId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} resultId The agent optimization result ID
* @param {AgentOptimizationResultPatch} agentOptimizationResultPatch Agent optimization result fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21361,8 +24068,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Update an existing agent skill. Creates a new version of the skill.
* @summary Update an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {AgentSkillPatch} agentSkillPatch Agent skill fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21373,8 +24080,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Update an AI model config.
* @summary Update an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {ModelConfigPatch} modelConfigPatch AI model config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21385,8 +24092,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Update an existing prompt snippet. Creates a new version of the snippet.
* @summary Update a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {PromptSnippetPatch} promptSnippetPatch Prompt snippet fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21397,7 +24104,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create a new AI Config within the given project.
* @summary Create new AI Config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIConfigPost} aIConfigPost AI Config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21408,8 +24115,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create a new variation for a given AI Config. The model in the request body requires a modelName and parameters, for example: ``` \"model\": { \"modelName\": \"claude-3-opus-20240229\", \"parameters\": { \"max_tokens\": 1024 } } ```
* @summary Create AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigVariationPost} aIConfigVariationPost AI Config variation object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21420,7 +24127,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create an AI tool
* @summary Create an AI tool
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIToolPost} aIToolPost AI tool object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21432,7 +24139,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
* Create a new agent graph within the given project.
* @summary Create new agent graph
* @param {PostAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentGraphPost} agentGraphPost Agent graph object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21443,7 +24150,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create a new agent optimization within the given project.
* @summary Create agent optimization
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentOptimizationPost} agentOptimizationPost Agent optimization object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21454,8 +24161,8 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create a new result for an agent optimization run.
* @summary Create agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationResultPost} agentOptimizationResultPost Agent optimization result to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21466,7 +24173,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create a new agent skill within the given project.
* @summary Create an agent skill
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentSkillPost} agentSkillPost Agent skill object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21477,7 +24184,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create an AI model config. You can use this in any variation for any config in your project.
* @summary Create an AI model config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {ModelConfigPost} modelConfigPost AI model config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21488,7 +24195,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Create a new prompt snippet within the given project.
* @summary Create a prompt snippet
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {PromptSnippetPost} promptSnippetPost Prompt snippet object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21499,7 +24206,7 @@ export const AgentControlApiFactory = function (configuration?: Configuration, b
/**
* Add AI models, by key, to the restricted list. Keys are included in the response from the [List AI model configs](https://launchdarkly.com/docs/api/agent-control/list-model-configs) endpoint.
* @summary Add AI models to the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to add to the restricted list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21517,8 +24224,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Delete an existing AI Config.
* @summary Delete AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21529,9 +24236,9 @@ export class AgentControlApi extends BaseAPI {
/**
* Delete a specific variation of an AI Config by config key and variation key.
* @summary Delete AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21542,8 +24249,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Delete an existing AI tool.
* @summary Delete AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21555,8 +24262,8 @@ export class AgentControlApi extends BaseAPI {
* Delete an existing agent graph and all of its edges.
* @summary Delete agent graph
* @param {DeleteAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21567,8 +24274,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Delete an existing agent optimization.
* @summary Delete an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21580,9 +24287,9 @@ export class AgentControlApi extends BaseAPI {
* Delete all results for a specific run of an agent optimization. Returns a 404 if the optimization does not exist or if the run has no results. A run whose results have already been deleted is indistinguishable from a run that never existed, so repeating this request also returns a 404.
* @summary Delete an agent optimization run
* @param {DeleteAgentOptimizationRunLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21593,8 +24300,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Delete an agent skill, including all of its versions.
* @summary Delete an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21605,8 +24312,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Delete an AI model config.
* @summary Delete an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21617,8 +24324,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Delete an existing prompt snippet.
* @summary Delete a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21629,7 +24336,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Remove AI models, by key, from the restricted list.
* @summary Remove AI models from the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to remove from the restricted list
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21641,8 +24348,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve a specific AI Config by its key.
* @summary Get AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21653,8 +24360,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve usage metrics for an AI Config by config key.
* @summary Get AI Config metrics
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -21670,8 +24377,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve usage metrics for an AI Config by config key, with results split by variation.
* @summary Get AI Config metrics by variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {number} from The starting time, as milliseconds since epoch (inclusive).
* @param {number} to The ending time, as milliseconds since epoch (exclusive). May not be more than 100 days after `from`.
* @param {string} env An environment key. Only metrics from this environment will be included.
@@ -21687,7 +24394,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve aggregate quick stats for AI Configs in a project.
* @summary Get AI Config quick stats
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} env An environment key. Only metrics from this environment will be included.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21699,8 +24406,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieves a specific AI Config\'s targeting by its key
* @summary Show an AI Config\'s targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21711,9 +24418,9 @@ export class AgentControlApi extends BaseAPI {
/**
* Get an AI Config variation by key. The response includes all variation versions for the given variation key.
* @summary Get AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21724,7 +24431,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Get a list of all AI Configs in the given project.
* @summary List AI Configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -21739,8 +24446,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve a specific AI tool by its key.
* @summary Get AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21752,8 +24459,8 @@ export class AgentControlApi extends BaseAPI {
* Retrieve a specific agent graph by its key, including its edges.
* @summary Get agent graph
* @param {GetAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21764,8 +24471,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve a specific agent optimization by its key.
* @summary Get an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21776,8 +24483,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve a specific agent skill by its key.
* @summary Get an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21788,8 +24495,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Get an AI model config by key. Specify a version to retrieve a historical custom model config version. Global model configs accept version 0 or 1 and return their current representation.
* @summary Get AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [version] Specific model config version to return. Omit to return the latest version.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -21801,8 +24508,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Retrieve a specific prompt snippet by its key.
* @summary Get a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21810,11 +24517,25 @@ export class AgentControlApi extends BaseAPI {
return AgentControlApiFp(this.configuration).getPromptSnippet(projectKey, snippetKey, options).then((request) => request(this.axios, this.basePath));
}
+ /**
+ * Get all AgentControl config variations that currently reference this tool.
+ * @summary List AI tool references
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public listAIToolReferences(projectKey: string, toolKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig) {
+ return AgentControlApiFp(this.configuration).listAIToolReferences(projectKey, toolKey, limit, offset, options).then((request) => request(this.axios, this.basePath));
+ }
+
/**
* Get a list of all versions of an AI tool in the given project.
* @summary List AI tool versions
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -21828,7 +24549,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Get a list of all AI tools in the given project.
* @summary List AI tools
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {string} [sort] A sort to apply to the list of AgentControl configs.
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
@@ -21844,7 +24565,7 @@ export class AgentControlApi extends BaseAPI {
* Get a list of all agent graphs in the given project. Returns metadata only, without edge data.
* @summary List agent graphs
* @param {ListAgentGraphsLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -21857,9 +24578,9 @@ export class AgentControlApi extends BaseAPI {
/**
* Get the most recent result for each unique run of an agent optimization.
- * @summary List agent optimization runs
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @summary List latest agent optimization result per run
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21872,9 +24593,9 @@ export class AgentControlApi extends BaseAPI {
/**
* Get all results for a specific run of an agent optimization, sorted by iteration descending.
* @summary List agent optimization results for a run
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} runId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} runId The agent optimization run ID
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
@@ -21882,10 +24603,24 @@ export class AgentControlApi extends BaseAPI {
return AgentControlApiFp(this.configuration).listAgentOptimizationResultsByRunId(projectKey, optimizationKey, runId, options).then((request) => request(this.axios, this.basePath));
}
+ /**
+ * Get one run summary per distinct run_id across all versions of an agent optimization config, ordered by created_at DESC.
+ * @summary List agent optimization runs
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {number} [limit] The number of resources to return.
+ * @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
+ * @param {*} [options] Override http request option.
+ * @throws {RequiredError}
+ */
+ public listAgentOptimizationRuns(projectKey: string, optimizationKey: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig) {
+ return AgentControlApiFp(this.configuration).listAgentOptimizationRuns(projectKey, optimizationKey, limit, offset, options).then((request) => request(this.axios, this.basePath));
+ }
+
/**
* Get a list of all agent optimizations in the given project.
* @summary List agent optimizations
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -21899,8 +24634,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Get all config variations that currently reference this agent skill.
* @summary List agent skill references
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21913,8 +24648,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Get all versions of an agent skill in the given project, ordered by version descending.
* @summary List agent skill versions
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21927,7 +24662,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Get a list of all agent skills in the given project.
* @summary List agent skills
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -21941,8 +24676,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Get all results across all versions of an agent optimization.
* @summary List all agent optimization results across versions
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21955,8 +24690,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Get a paginated list of all available versions of an AI model config, ordered from newest to oldest. Global model configs return their single current representation.
* @summary List AI model config versions
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21969,20 +24704,22 @@ export class AgentControlApi extends BaseAPI {
/**
* Get all AI model configs for a project.
* @summary List AI model configs
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {boolean} [restricted] Whether to return only restricted models
+ * @param {string} [sort] A sort to apply to the list of AgentControl configs.
+ * @param {string} [filter] A filter to apply to the list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public listModelConfigs(projectKey: string, restricted?: boolean, options?: RawAxiosRequestConfig) {
- return AgentControlApiFp(this.configuration).listModelConfigs(projectKey, restricted, options).then((request) => request(this.axios, this.basePath));
+ public listModelConfigs(projectKey: string, restricted?: boolean, sort?: string, filter?: string, options?: RawAxiosRequestConfig) {
+ return AgentControlApiFp(this.configuration).listModelConfigs(projectKey, restricted, sort, filter, options).then((request) => request(this.axios, this.basePath));
}
/**
* Get all config variations that currently reference this prompt snippet.
* @summary List prompt snippet references
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -21995,8 +24732,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Get all versions of a prompt snippet in the given project, ordered by version descending.
* @summary List prompt snippet versions
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {*} [options] Override http request option.
@@ -22009,7 +24746,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Get a list of all prompt snippets in the given project.
* @summary List prompt snippets
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {number} [limit] The number of resources to return.
* @param {number} [offset] Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query `limit`.
* @param {string} [filter] A filter to apply to the list.
@@ -22023,8 +24760,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Edit an existing AI Config. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"description\": \"Example updated description\", \"tags\": [\"new-tag\"] } ```
* @summary Update AI Config
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigPatch} [aIConfigPatch] AI Config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22036,8 +24773,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Perform a partial update to an AI Config\'s targeting. The request body must be a valid semantic patch. ### Using semantic patches on an AI Config To make a semantic patch request, you must append `domain-model=launchdarkly.semanticpatch` to your `Content-Type` header. To learn more, read [Updates using semantic patch](https://launchdarkly.com/docs/api#updates-using-semantic-patch). The body of a semantic patch request for updating an AI Config\'s targeting takes the following properties: * `comment` (string): (Optional) A description of the update. * `environmentKey` (string): The key of the LaunchDarkly environment. * `instructions` (array): (Required) A list of actions the update should perform. Each action in the list must be an object with a `kind` property that indicates the instruction. If the action requires parameters, you must include those parameters as additional fields in the object. The body of a single semantic patch can contain many different instructions. ### Instructions Semantic patch requests support the following `kind` instructions for updating AI Configs. Click to expand instructions for working with targeting and variations for AI Configs
#### addClauses Adds the given clauses to the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauses\": [{ \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"USA\", \"Canada\"] }] }] } ``` #### addRule Adds a new targeting rule to the AI Config. The rule may contain `clauses` and serve the variation that `variationId` indicates, or serve a percentage rollout that `rolloutWeights`, `rolloutBucketBy`, and `rolloutContextKind` indicate. If you set `beforeRuleId`, this adds the new rule before the indicated rule. Otherwise, adds the new rule to the end of the list. ##### Parameters - `clauses`: Array of clause objects, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. - `beforeRuleId`: (Optional) ID of a rule. - Either - `variationId`: ID of a variation. or - `rolloutWeights`: (Optional) Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }] }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addRule\", \"clauses\": [{ \"contextKind\": \"organization\", \"attribute\": \"located_in\", \"op\": \"in\", \"negate\": false, \"values\": [\"Sweden\", \"Norway\"] }], \"rolloutContextKind\": \"organization\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### addTargets Adds context keys to the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Returns an error if this causes the AI Config to target the same context key in multiple variations. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### addValuesToClause Adds `values` to the values of the clause that `ruleId` and `clauseId` indicate. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule in the AI Config. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"addValuesToClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### clearTargets Removes all individual targets from the variation that `variationId` specifies. This includes both user and non-user targets. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"clearTargets\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### removeClauses Removes the clauses specified by `clauseIds` from the rule indicated by `ruleId`. ##### Parameters - `ruleId`: ID of a rule. - `clauseIds`: Array of IDs of clauses in the rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeClauses\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseIds\": [\"10a58772-3121-400f-846b-b8a04e8944ed\", \"36a461dc-235e-4b08-97b9-73ce9365873e\"] }] } ``` #### removeRule Removes the targeting rule specified by `ruleId`. Does nothing if the rule does not exist. ##### Parameters - `ruleId`: ID of a rule. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"removeRule\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" } ] } ``` #### removeTargets Removes context keys from the individual context targets for the context kind that `contextKind` specifies and the variation that `variationId` specifies. Does nothing if the flag does not target the context keys. ##### Parameters - `values`: List of context keys. - `contextKind`: (Optional) Context kind to target, defaults to `user` - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeTargets\", \"values\": [\"context-key-123abc\", \"context-key-456def\"], \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### removeValuesFromClause Removes `values` from the values of the clause indicated by `ruleId` and `clauseId`. Does not update the context kind, attribute, or operator. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `values`: Array of strings, case sensitive. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"removeValuesFromClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10a58772-3121-400f-846b-b8a04e8944ed\", \"values\": [\"beta_testers\"] }] } ``` #### reorderRules Rearranges the rules to match the order given in `ruleIds`. Returns an error if `ruleIds` does not match the current set of rules on the AI Config. ##### Parameters - `ruleIds`: Array of IDs of all rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"reorderRules\", \"ruleIds\": [\"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"63c238d1-835d-435e-8f21-c8d5e40b2a3d\"] }] } ``` #### replaceRules Removes all targeting rules for the AI Config and replaces them with the list you provide. ##### Parameters - `rules`: A list of rules. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceRules\", \"rules\": [ { \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"description\": \"My new rule\", \"clauses\": [ { \"contextKind\": \"user\", \"attribute\": \"segmentMatch\", \"op\": \"segmentMatch\", \"values\": [\"test\"] } ] } ] } ] } ``` #### replaceTargets Removes all existing targeting and replaces it with the list of targets you provide. ##### Parameters - `targets`: A list of context targeting. Each item in the list includes an optional `contextKind` that defaults to `user`, a required `variationId`, and a required list of `values`. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"replaceTargets\", \"targets\": [ { \"contextKind\": \"user\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\", \"values\": [\"user-key-123abc\"] }, { \"contextKind\": \"device\", \"variationId\": \"e5830889-1ec5-4b0c-9cc9-c48790090c43\", \"values\": [\"device-key-456def\"] } ] } ] } ``` #### updateClause Replaces the clause indicated by `ruleId` and `clauseId` with `clause`. ##### Parameters - `ruleId`: ID of a rule. - `clauseId`: ID of a clause in that rule. - `clause`: New `clause` object, with `contextKind` (string), `attribute` (string), `op` (string), `negate` (boolean), and `values` (array of strings, numbers, or dates) properties. The `contextKind`, `attribute`, and `values` are case sensitive. The `op` must be lower-case. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateClause\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"clauseId\": \"10c7462a-2062-45ba-a8bb-dfb3de0f8af5\", \"clause\": { \"contextKind\": \"user\", \"attribute\": \"country\", \"op\": \"in\", \"negate\": false, \"values\": [\"Mexico\", \"Canada\"] } }] } ``` #### updateDefaultVariation Updates the default on or off variation of the AI Config. ##### Parameters - `onVariationValue`: (Optional) The value of the variation of the new on variation. - `offVariationValue`: (Optional) The value of the variation of the new off variation Here\'s an example: ```json { \"instructions\": [ { \"kind\": \"updateDefaultVariation\", \"OnVariationValue\": true, \"OffVariationValue\": false } ] } ``` #### updateFallthroughVariationOrRollout Updates the default or \"fallthrough\" rule for the AI Config, which the AI Config serves when a context matches none of the targeting rules. The rule can serve either the variation that `variationId` indicates, or a percentage rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example that uses a `variationId`: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` Here\'s an example that uses a percentage rollout: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateFallthroughVariationOrRollout\", \"rolloutContextKind\": \"user\", \"rolloutWeights\": { \"2f43f67c-3e4e-4945-a18a-26559378ca00\": 15000, // serve 15% this variation \"e5830889-1ec5-4b0c-9cc9-c48790090c43\": 85000 // serve 85% this variation } }] } ``` #### updateOffVariation Updates the default off variation to `variationId`. The AI Config serves the default off variation when the AI Config\'s targeting is **Off**. ##### Parameters - `variationId`: ID of a variation. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateOffVariation\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" } ] } ``` #### updateRuleDescription Updates the description of the targeting rule. ##### Parameters - `description`: The new human-readable description for this rule. - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleDescription\", \"description\": \"New rule description\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\" }] } ``` #### updateRuleTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config associated with this rule. ##### Parameters - `ruleId`: The ID of the rule. You can retrieve this by making a GET request for the AI Config. - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleTrackEvents\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"trackEvents\": true }] } ``` #### updateRuleVariationOrRollout Updates what `ruleId` serves when its clauses evaluate to true. The rule can serve either the variation that `variationId` indicates, or a percent rollout that `rolloutWeights` and `rolloutBucketBy` indicate. ##### Parameters - `ruleId`: ID of a rule. - `variationId`: ID of a variation. or - `rolloutWeights`: Map of `variationId` to weight, in thousandths of a percent (0-100000). - `rolloutBucketBy`: (Optional) Context attribute available in the specified `rolloutContextKind`. - `rolloutContextKind`: (Optional) Context kind, defaults to `user` Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [{ \"kind\": \"updateRuleVariationOrRollout\", \"ruleId\": \"a902ef4a-2faf-4eaf-88e1-ecc356708a29\", \"variationId\": \"2f43f67c-3e4e-4945-a18a-26559378ca00\" }] } ``` #### updateTrackEvents Updates whether or not LaunchDarkly tracks events for the AI Config, for all rules. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEvents\", \"trackEvents\": true } ] } ``` #### updateTrackEventsFallthrough Updates whether or not LaunchDarkly tracks events for the AI Config, for the default rule. ##### Parameters - `trackEvents`: Whether or not events are tracked. Here\'s an example: ```json { \"environmentKey\": \"environment-key-123abc\", \"instructions\": [ { \"kind\": \"updateTrackEventsFallthrough\", \"trackEvents\": true } ] } ```
* @summary Update AI Config targeting
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigTargetingPatch} [aIConfigTargetingPatch] AI Config targeting semantic patch instructions
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22047,11 +24784,11 @@ export class AgentControlApi extends BaseAPI {
}
/**
- * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
+ * Edit an existing variation of an AI Config. This creates a new version of the variation. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the variation is in use in a project environment where approval settings require review for this AI Config, this endpoint returns 403 and the change must be submitted through an approval request. Here\'s an example: ``` { \"messages\": [ { \"role\": \"system\", \"content\": \"The new message\" } ] } ```
* @summary Update AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
- * @param {string} variationKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
+ * @param {string} variationKey The AI Config variation key
* @param {AIConfigVariationPatch} [aIConfigVariationPatch] AI Config variation object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22063,8 +24800,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Edit an existing AI tool.
* @summary Update AI tool
- * @param {string} projectKey
- * @param {string} toolKey
+ * @param {string} projectKey The project key
+ * @param {string} toolKey The AI tool key
* @param {AIToolPatch} [aIToolPatch] AI tool object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22077,8 +24814,8 @@ export class AgentControlApi extends BaseAPI {
* Edit an existing agent graph. The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields. If the update includes `rootConfigKey` or `edges`, both must be present and will be treated as full replacements.
* @summary Update agent graph
* @param {PatchAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
- * @param {string} graphKey
+ * @param {string} projectKey The project key
+ * @param {string} graphKey The agent graph key
* @param {AgentGraphPatch} [agentGraphPatch] Agent graph object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22090,8 +24827,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Update an existing agent optimization. Creates a new version of the optimization.
* @summary Update an agent optimization
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationPatch} agentOptimizationPatch Agent optimization fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22103,9 +24840,9 @@ export class AgentControlApi extends BaseAPI {
/**
* Update status, activity, and AI request metadata fields on an agent optimization result.
* @summary Update an agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
- * @param {string} resultId
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
+ * @param {string} resultId The agent optimization result ID
* @param {AgentOptimizationResultPatch} agentOptimizationResultPatch Agent optimization result fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22117,8 +24854,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Update an existing agent skill. Creates a new version of the skill.
* @summary Update an agent skill
- * @param {string} projectKey
- * @param {string} skillKey
+ * @param {string} projectKey The project key
+ * @param {string} skillKey The agent skill key
* @param {AgentSkillPatch} agentSkillPatch Agent skill fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22130,8 +24867,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Update an AI model config.
* @summary Update an AI model config
- * @param {string} projectKey
- * @param {string} modelConfigKey
+ * @param {string} projectKey The project key
+ * @param {string} modelConfigKey The AI model config key
* @param {ModelConfigPatch} modelConfigPatch AI model config object to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22143,8 +24880,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Update an existing prompt snippet. Creates a new version of the snippet.
* @summary Update a prompt snippet
- * @param {string} projectKey
- * @param {string} snippetKey
+ * @param {string} projectKey The project key
+ * @param {string} snippetKey The prompt snippet key
* @param {PromptSnippetPatch} promptSnippetPatch Prompt snippet fields to update
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22156,7 +24893,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Create a new AI Config within the given project.
* @summary Create new AI Config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIConfigPost} aIConfigPost AI Config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22168,8 +24905,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Create a new variation for a given AI Config. The model in the request body requires a modelName and parameters, for example: ``` \"model\": { \"modelName\": \"claude-3-opus-20240229\", \"parameters\": { \"max_tokens\": 1024 } } ```
* @summary Create AI Config variation
- * @param {string} projectKey
- * @param {string} configKey
+ * @param {string} projectKey The project key
+ * @param {string} configKey The AI Config key
* @param {AIConfigVariationPost} aIConfigVariationPost AI Config variation object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22181,7 +24918,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Create an AI tool
* @summary Create an AI tool
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AIToolPost} aIToolPost AI tool object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22194,7 +24931,7 @@ export class AgentControlApi extends BaseAPI {
* Create a new agent graph within the given project.
* @summary Create new agent graph
* @param {PostAgentGraphLDAPIVersionEnum} lDAPIVersion Version of the endpoint.
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentGraphPost} agentGraphPost Agent graph object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22206,7 +24943,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Create a new agent optimization within the given project.
* @summary Create agent optimization
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentOptimizationPost} agentOptimizationPost Agent optimization object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22218,8 +24955,8 @@ export class AgentControlApi extends BaseAPI {
/**
* Create a new result for an agent optimization run.
* @summary Create agent optimization result
- * @param {string} projectKey
- * @param {string} optimizationKey
+ * @param {string} projectKey The project key
+ * @param {string} optimizationKey The agent optimization key
* @param {AgentOptimizationResultPost} agentOptimizationResultPost Agent optimization result to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22231,7 +24968,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Create a new agent skill within the given project.
* @summary Create an agent skill
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {AgentSkillPost} agentSkillPost Agent skill object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22243,7 +24980,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Create an AI model config. You can use this in any variation for any config in your project.
* @summary Create an AI model config
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {ModelConfigPost} modelConfigPost AI model config object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22255,7 +24992,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Create a new prompt snippet within the given project.
* @summary Create a prompt snippet
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {PromptSnippetPost} promptSnippetPost Prompt snippet object to create
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22267,7 +25004,7 @@ export class AgentControlApi extends BaseAPI {
/**
* Add AI models, by key, to the restricted list. Keys are included in the response from the [List AI model configs](https://launchdarkly.com/docs/api/agent-control/list-model-configs) endpoint.
* @summary Add AI models to the restricted list
- * @param {string} projectKey
+ * @param {string} projectKey The project key
* @param {RestrictedModelsRequest} restrictedModelsRequest List of AI model keys to add to the restricted list.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
@@ -22340,7 +25077,7 @@ export const AnnouncementsApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22385,7 +25122,7 @@ export const AnnouncementsApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22440,7 +25177,7 @@ export const AnnouncementsApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22488,7 +25225,7 @@ export const AnnouncementsApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22717,7 +25454,7 @@ export const ApplicationsBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22765,7 +25502,7 @@ export const ApplicationsBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22814,7 +25551,7 @@ export const ApplicationsBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22878,7 +25615,7 @@ export const ApplicationsBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22943,7 +25680,7 @@ export const ApplicationsBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -22991,7 +25728,7 @@ export const ApplicationsBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23044,7 +25781,7 @@ export const ApplicationsBetaApiAxiosParamCreator = function (configuration?: Co
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23399,7 +26136,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23455,7 +26192,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23511,7 +26248,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23560,7 +26297,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23620,7 +26357,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23672,7 +26409,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23716,7 +26453,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23765,7 +26502,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23826,7 +26563,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23883,7 +26620,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23932,7 +26669,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -23993,7 +26730,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -24050,7 +26787,7 @@ export const ApprovalsApiAxiosParamCreator = function (configuration?: Configura
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -24672,7 +27409,7 @@ export const ApprovalsBetaApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -24723,7 +27460,7 @@ export const ApprovalsBetaApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -24773,7 +27510,7 @@ export const ApprovalsBetaApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
if (lDAPIVersion != null) {
@@ -24833,7 +27570,7 @@ export const ApprovalsBetaApiAxiosParamCreator = function (configuration?: Confi
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -25053,17 +27790,19 @@ export type PatchApprovalRequestSettingsLDAPIVersionEnum = typeof PatchApprovalR
export const AuditLogApiAxiosParamCreator = function (configuration?: Configuration) {
return {
/**
- * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary List audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
* @param {string} [spec] A resource specifier that lets you filter audit log listings by resource
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- getAuditLogEntries: async (before?: number, after?: number, q?: string, limit?: number, spec?: string, options: RawAxiosRequestConfig = {}): Promise => {
+ getAuditLogEntries: async (before?: number, after?: number, q?: string, limit?: number, spec?: string, member?: string, token?: string, options: RawAxiosRequestConfig = {}): Promise => {
const localVarPath = `/api/v2/auditlog`;
// use dummy base URL string because the URL constructor only accepts absolute URLs.
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -25099,13 +27838,21 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
localVarQueryParameter['spec'] = spec;
}
+ if (member !== undefined) {
+ localVarQueryParameter['member'] = member;
+ }
+
+ if (token !== undefined) {
+ localVarQueryParameter['token'] = token;
+ }
+
localVarHeaderParameter['Accept'] = 'application/json';
// CUSTOM-START
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -25149,7 +27896,7 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -25162,17 +27909,19 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
};
},
/**
- * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary Search audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {Array} [statementPost]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- postAuditLogEntries: async (before?: number, after?: number, q?: string, limit?: number, statementPost?: Array, options: RawAxiosRequestConfig = {}): Promise => {
+ postAuditLogEntries: async (before?: number, after?: number, q?: string, limit?: number, member?: string, token?: string, statementPost?: Array, options: RawAxiosRequestConfig = {}): Promise => {
const localVarPath = `/api/v2/auditlog`;
// use dummy base URL string because the URL constructor only accepts absolute URLs.
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
@@ -25204,6 +27953,14 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
localVarQueryParameter['limit'] = limit;
}
+ if (member !== undefined) {
+ localVarQueryParameter['member'] = member;
+ }
+
+ if (token !== undefined) {
+ localVarQueryParameter['token'] = token;
+ }
+
localVarHeaderParameter['Content-Type'] = 'application/json';
localVarHeaderParameter['Accept'] = 'application/json';
@@ -25211,7 +27968,7 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -25231,10 +27988,12 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
* @param {Array} statementPost
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. Defaults to now.
* @param {number} [buckets] Number of time buckets to divide the range into. Default 50, max 500.
+ * @param {string} [member] A member ID that lets you filter counts to changes made by that member. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter counts to changes made by that token. Repeat the parameter to filter by multiple tokens.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- postAuditLogEntryCounts: async (after: number, statementPost: Array, before?: number, buckets?: number, options: RawAxiosRequestConfig = {}): Promise => {
+ postAuditLogEntryCounts: async (after: number, statementPost: Array, before?: number, buckets?: number, member?: string, token?: string, options: RawAxiosRequestConfig = {}): Promise => {
// verify required parameter 'after' is not null or undefined
assertParamExists('postAuditLogEntryCounts', 'after', after)
// verify required parameter 'statementPost' is not null or undefined
@@ -25266,6 +28025,14 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
localVarQueryParameter['buckets'] = buckets;
}
+ if (member !== undefined) {
+ localVarQueryParameter['member'] = member;
+ }
+
+ if (token !== undefined) {
+ localVarQueryParameter['token'] = token;
+ }
+
localVarHeaderParameter['Content-Type'] = 'application/json';
localVarHeaderParameter['Accept'] = 'application/json';
@@ -25273,7 +28040,7 @@ export const AuditLogApiAxiosParamCreator = function (configuration?: Configurat
// Set default API version.
localVarHeaderParameter['LD-API-Version'] = '20240415';
// Set a custom LaunchDarkly user agent header.
- localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/24.0.0/typescript';
+ localVarHeaderParameter['X-LaunchDarkly-User-Agent'] = 'OpenAPI-Generator/25.0.0/typescript';
// CUSTOM-END
setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -25296,18 +28063,20 @@ export const AuditLogApiFp = function(configuration?: Configuration) {
const localVarAxiosParamCreator = AuditLogApiAxiosParamCreator(configuration)
return {
/**
- * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary List audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
* @param {string} [spec] A resource specifier that lets you filter audit log listings by resource
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- async getAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, spec?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.getAuditLogEntries(before, after, q, limit, spec, options);
+ async getAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, spec?: string, member?: string, token?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.getAuditLogEntries(before, after, q, limit, spec, member, token, options);
const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
const localVarOperationServerBasePath = operationServerMap['AuditLogApi.getAuditLogEntries']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -25326,18 +28095,20 @@ export const AuditLogApiFp = function(configuration?: Configuration) {
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
},
/**
- * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary Search audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {Array} [statementPost]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- async postAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, statementPost?: Array, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.postAuditLogEntries(before, after, q, limit, statementPost, options);
+ async postAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, member?: string, token?: string, statementPost?: Array, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.postAuditLogEntries(before, after, q, limit, member, token, statementPost, options);
const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
const localVarOperationServerBasePath = operationServerMap['AuditLogApi.postAuditLogEntries']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -25349,11 +28120,13 @@ export const AuditLogApiFp = function(configuration?: Configuration) {
* @param {Array} statementPost
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. Defaults to now.
* @param {number} [buckets] Number of time buckets to divide the range into. Default 50, max 500.
+ * @param {string} [member] A member ID that lets you filter counts to changes made by that member. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter counts to changes made by that token. Repeat the parameter to filter by multiple tokens.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- async postAuditLogEntryCounts(after: number, statementPost: Array, before?: number, buckets?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
- const localVarAxiosArgs = await localVarAxiosParamCreator.postAuditLogEntryCounts(after, statementPost, before, buckets, options);
+ async postAuditLogEntryCounts(after: number, statementPost: Array, before?: number, buckets?: number, member?: string, token?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise> {
+ const localVarAxiosArgs = await localVarAxiosParamCreator.postAuditLogEntryCounts(after, statementPost, before, buckets, member, token, options);
const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
const localVarOperationServerBasePath = operationServerMap['AuditLogApi.postAuditLogEntryCounts']?.[localVarOperationServerIndex]?.url;
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -25368,18 +28141,20 @@ export const AuditLogApiFactory = function (configuration?: Configuration, baseP
const localVarFp = AuditLogApiFp(configuration)
return {
/**
- * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary List audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
* @param {string} [spec] A resource specifier that lets you filter audit log listings by resource
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- getAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, spec?: string, options?: RawAxiosRequestConfig): AxiosPromise {
- return localVarFp.getAuditLogEntries(before, after, q, limit, spec, options).then((request) => request(axios, basePath));
+ getAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, spec?: string, member?: string, token?: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.getAuditLogEntries(before, after, q, limit, spec, member, token, options).then((request) => request(axios, basePath));
},
/**
* Fetch a detailed audit log entry representation. The detailed representation includes several fields that are not present in the summary representation, including: - `previousVersion`: a JSON representation of the previous version of the entity. - `currentVersion`: a JSON representation of the current version of the entity. - `delta`: the JSON patch body that was used in the request to update the entity. This is only included if the update was made through a [JSON patch](https://launchdarkly.com/docs/api#updates-using-json-patch). It is null when the update was made using [semantic patch](https://launchdarkly.com/docs/api#updates-using-semantic-patch). Because most [flag updates](https://launchdarkly.com/docs/api/feature-flags/patch-feature-flag) are made using semantic patch, this field is rarely returned.
@@ -25392,18 +28167,20 @@ export const AuditLogApiFactory = function (configuration?: Configuration, baseP
return localVarFp.getAuditLogEntry(id, options).then((request) => request(axios, basePath));
},
/**
- * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary Search audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {Array} [statementPost]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- postAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, statementPost?: Array, options?: RawAxiosRequestConfig): AxiosPromise {
- return localVarFp.postAuditLogEntries(before, after, q, limit, statementPost, options).then((request) => request(axios, basePath));
+ postAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, member?: string, token?: string, statementPost?: Array, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.postAuditLogEntries(before, after, q, limit, member, token, statementPost, options).then((request) => request(axios, basePath));
},
/**
* Returns aggregate counts of audit log entries per time bucket. Used for dashboard overlays that show flag targeting changes.
@@ -25412,11 +28189,13 @@ export const AuditLogApiFactory = function (configuration?: Configuration, baseP
* @param {Array} statementPost
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. Defaults to now.
* @param {number} [buckets] Number of time buckets to divide the range into. Default 50, max 500.
+ * @param {string} [member] A member ID that lets you filter counts to changes made by that member. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter counts to changes made by that token. Repeat the parameter to filter by multiple tokens.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- postAuditLogEntryCounts(after: number, statementPost: Array, before?: number, buckets?: number, options?: RawAxiosRequestConfig): AxiosPromise {
- return localVarFp.postAuditLogEntryCounts(after, statementPost, before, buckets, options).then((request) => request(axios, basePath));
+ postAuditLogEntryCounts(after: number, statementPost: Array, before?: number, buckets?: number, member?: string, token?: string, options?: RawAxiosRequestConfig): AxiosPromise {
+ return localVarFp.postAuditLogEntryCounts(after, statementPost, before, buckets, member, token, options).then((request) => request(axios, basePath));
},
};
};
@@ -25426,18 +28205,20 @@ export const AuditLogApiFactory = function (configuration?: Configuration, baseP
*/
export class AuditLogApi extends BaseAPI {
/**
- * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary List audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
* @param {string} [spec] A resource specifier that lets you filter audit log listings by resource
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public getAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, spec?: string, options?: RawAxiosRequestConfig) {
- return AuditLogApiFp(this.configuration).getAuditLogEntries(before, after, q, limit, spec, options).then((request) => request(this.axios, this.basePath));
+ public getAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, spec?: string, member?: string, token?: string, options?: RawAxiosRequestConfig) {
+ return AuditLogApiFp(this.configuration).getAuditLogEntries(before, after, q, limit, spec, member, token, options).then((request) => request(this.axios, this.basePath));
}
/**
@@ -25452,18 +28233,20 @@ export class AuditLogApi extends BaseAPI {
}
/**
- * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+ * Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers. LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [Specifying resources in the advanced editor](https://launchdarkly.com/docs/home/account/roles/role-resources#specifying-resources-in-the-advanced-editor).
* @summary Search audit log entries
* @param {number} [before] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred before the timestamp.
* @param {number} [after] A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred after the timestamp.
* @param {string} [q] Text to search for. You can search for the full or partial name of the resource.
* @param {number} [limit] A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
+ * @param {string} [member] A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.
+ * @param {string} [token] An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.
* @param {Array} [statementPost]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
- public postAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, statementPost?: Array, options?: RawAxiosRequestConfig) {
- return AuditLogApiFp(this.configuration).postAuditLogEntries(before, after, q, limit, statementPost, options).then((request) => request(this.axios, this.basePath));
+ public postAuditLogEntries(before?: number, after?: number, q?: string, limit?: number, member?: string, token?: string, statementPost?: Array