Releases: launchdarkly/ld-openapi
Releases · launchdarkly/ld-openapi
16.1.1
[16.1.1] - 2024-05-16
Fixed:
Typescript
- Updated Axios dependency to resolve CVE-2023-45857. launchdarkly/api-client-typescript#9
16.1.0
[16.1.0] - 2024-05-16
Added
- Added optional
notInExperimentVariationIdfield toflagsinsideiterationin the request body ofPOST /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments(Create Experiment) - Added optional
notInExperimentVariationIdfield inflagsin the request body ofPOST /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey}/iterations(Create Iteration) - Added
notInExperimentVariationIdfield to theflagsobject in the response bodies of:POST /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments(Create Experiment)POST /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey}/iterations(Create Iteration)PATCH /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey}(Patch Experiment)GET /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey}(Get Experiment)
- Added HTTP 409 as a possible response status code for
PATCH /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey}(Patch Experiment)
Typescript
- Updated Axios dependency to resolve CVE-2023-45857. launchdarkly/api-client-typescript#9
Go
- Generate interfaces to make mocking easier in tests. #116
15.1.0
[15.1.0] - 2024-04-03
Added
- Added ReleaseAudience type
- Added Usage endpoints
GET /api/v2/usage/service-connectionsGET /api/v2/usage/data-export-events
Changed
-
Added
maintainerIdandmaintainerTeamKeyoptions to flags create endpoint -
Updated
ReleasePhaseto have type[]ReleaseAudienceinstead of[]AudienceforAudiencesfield
14.0.0
[14.0.0] - 2023-11-16
Added
- Added Application and Application version endpoints, in beta
- Added
unitOfAnalysisfield to the metric listing rep returned by get all metrics endpoint - Added
lastSeenfield to the metric listing rep returned by get all metrics endpoint - Added
_accessobject to the release pipeline rep returned by several endpoints - Added
_linksfield to the team summary object returned by several endpoints - Added beta endpoint for getting experimentation units usage
- Added
iterationIdquery string parameter to/api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey}/metrics/{metricKey}/results - Added pagination parameters
limitandoffsetto/api/v2/segments/{projKey}/{envKey} - Added
lastModifiedDatefield to response ofGET /api/v2/segments/{projectKey}/{environmentKey} - Added
sortto/api/v2/segments/{projKey}/{envKey} - Added
filterto/api/v2/segments/{projKey}/{envKey} - Added
_idfield to the expandedprojectinformation inTeamsendpoints - Added
purposefield to theFlagPostinput object - Added
migrationSettingsfield to theFlagPostinput object - Added
archivedfield toGET /api/v2/projects/{projectKey}/context-kindsandPUT /api/v2/projects/{projectKey}/context-kinds/{key} - Marked
itemsrequired inFlagFollowersGetRepto match API behavior - Added
_flagCountfield toGET /api/v2/segments/{projectKey}/{environmentKey} - Added
totalEvaluationsfield toGET /api/v2/usage/evaluations/{projKey}/{envKey}/{flagKey} - Added Release pipelines and Releases endpoints, in beta
- Added links in environment representations
- Update
codeandmessageon error reps to be required to match API behavior - Added
namefield toPhaseInfoforGET /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}/releases - Added
unitAggregationType,analysisType, andeventDefaultfields toGET /api/v2/metrics/{projectKey},GET /api/v2/metrics/{projectKey}/{metricKey},POST /api/v2/metrics/{projectKey}, andPATCH /api/v2/metrics/{projectKey}/{metricKey} - Marked
itemsas required inEnvironmentCollectionRepto match API behavior - Marked
colorandnameas required inEnvironmentSummaryRepto match API behavior - Added
@Failure 404with a value ofMember not foundtoPOST /api/v2/members/{id}/teams - Added beta endpoint to retrieve migration safety issues when updating a migration flag
- Added
migrationSettingsexpand parameter toGET /api/v2/flags/{projectKey} - Added
migrationSettingsexpand parameter toGET /api/v2/flags/{projectKey}/{featureFlagKey} - Added
limitandoffsetquery params toGET /projects/{projKey}/release-pipelines/{pipelineKey}/releases - Added beta endpoints to create, delete, and list metric groups
- Marked
itemsas required onExperimentCollectionRepto match API behavior - Added
isGroupandmetricsfields toDependentMetricOrMetricGroupRep - Added
isGroupfield toMetricInput - Added
randomizationUnitsfield toMetricInGroupRep
Removed
Changed
- Moved
PATCH /projects/{projKey}/release-pipelines/{pipelineKey}out of hidden docs - Set
deprecatedproperty on legacy experimentation operation which has already been deprecated- GET
/api/v2/flags/{projectKey}/{featureFlagKey}/experiments/{environmentKey}/{metricKey}
- GET
- Set
deprecatedonoffsetparameter which has already been deprecated- GET
/api/v2/user-search/{projectKey}
- GET
- Set
deprecatedon flag-related schema properties that have already been deprecated - Moved OAuth Client APIs out of beta
- Updated the response body of
ReviewOutputto optionally returnserviceTokenId, omitted when approval reviewer was a member - Updated the response body of
ReviewResponseto optionally returnserviceTokenId, omitted when approval reviewer was a member - Updated the response body of
FlagConfigApprovalRequestResponseto optionally returnappliedByServiceTokenId, omitted when a member applies an approval - Set
deprecatedproperty on legacy users endpoints, which are replaced by contexts endpoints- DELETE
/api/v2/users/{projectKey}/{environmentKey}/{userKey} - GET
/api/v2/users/{projectKey}/{userKey}/expiring-user-targets/{environmentKey} - GET
/api/v2/users/{projectKey}/{environmentKey}/{userKey}/flags - GET
/api/v2/users/{projectKey}/{environmentKey}/{userKey}/flags/{featureFlagKey} - GET
/api/v2/users/{projectKey}/{environmentKey} - GET
/api/v2/users/{projectKey}/{environmentKey}/{userKey} - GET
/api/v2/user-attributes/{projectKey}/{environmentKey} - GET
/api/v2/user-search/{projectKey}/{environmentKey} - PATCH
/api/v2/users/{projectKey}/{userKey}/expiring-user-targets/{environmentKey} - PUT
/api/v2/users/{projectKey}/{environmentKey}/{userKey}/flags/{featureFlagKey}
- DELETE
- Moved Approvals APIs out of beta
- Moved Workflow APIs out of beta
- Moved Workflow template APIs out of beta
- Updated the response body of the
Memberstruct to clarify that in thepermissionGrants, only one ofactionsoractionSetis required - Updated type of
PrimaryMetricinIterationRep - Updated
maintainerIdto be an optional parameter when creating a new experiment - Updated
contextTargetsfield for flags endpoints to be required - Renamed
metricWrappertoMetricWrapper - Updated type of
Effectin custom roles tostring - Added the
expandquery parameter for thegetExperimentendpoint- GET
/api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey}
- GET
- Updated description and unhid
archivedfield onGET /api/v2/projects/{projectKey}/context-kindsandPUT /api/v2/projects/{projectKey}/context-kinds/{key} - Updated description for
hideInTargetingfield onGET /api/v2/projects/{projectKey}/context-kindsandPUT /api/v2/projects/{projectKey}/context-kinds/{key} - Moved Context Kind APIs out of beta
- Updated response body of GET
/api/v2/flags/{projectKey}/{flagKey}/releaseand PATCH/api/v2/flags/{projectKey}/{flagKey}/releaseto includeMemberSummaryandTokenSummaryin each phase'scompletedByfield instead of having flat values. - Renamed
activeReleasesandcompletedReleasestoactiveCountandtotalCountforGET /api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}/releases - Updated the response body of
FeatureFlagandFeatureFlagConfigto returnmigrationSettingswhen callingPATCH /api/v2/flags/{projectKey}/{featureFlagKey} - Set
deprecatedproperty onarchivedquery param forGET /api/v2/flags/{projectKey} - Renamed
DependentMetricReptoDependentMetricOrMetricGroupRep - Updated the
kindfield inDependentMetricOrMetricGroupRepto allow enum valuefunnel, used for metric groups - Renamed
MetricWrappertoMetricInGroupRep
Bug Fixes
RootResponseschema was incorrect
13.0.0
[13.0.0] - 2023-04-19
Added
Removed
Changed
- Moved Contexts APIs out of beta
12.1.0
[12.1.0] - 2023-04-12
Added
- Added beta endpoint for server connection minutes usage
- Added
customRolesexpand parameter toGET /api/v2/members - Added 409 return code information for reset environment keys endpoints
- Added new beta endpoints for approvals
- Updated response bodies for beta approval endpoints
- Added
contextKindTargetedfilter parameter toGET /api/v2/flags/{projectKey} - Added
contextKindsEvaluatedfilter parameter toGET /api/v2/flags/{projectKey} - Added
evaluationexpand parameter toGET /api/v2/flags/{projectKey} - Added
evaluationexpand parameter toGET /api/v2/flag-links/projects/{projectKey}/flags/{featureFlagKey}
Removed
Changed
- Updated note for param
memberIdin follow flag endpointsputFlagFollowersanddeleteFlagFollowersto reflect the limitation of Reader roles. - Updated the response body of
ExpandableApprovalRequestResponseto optionally returnenvironmentsinstead ofenvironmentwhich is only used in beta APIs
12.0.0
[12.0.0] - 2023-02-27
Added
- Added "Contexts (beta)" and "Context settings (beta)" categories
- Added
StopDatetoExecutionOutputobject - Added support for sorting via query parameter in the
GET /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows - Added beta endpoint for updating flag settings for a context
- Added endpoints for retrieving segment membership of a non-
usercontext and of a context instance - Added beta endpoint for updating individual targets on Big Segments with non-
usercontext kind - Added beta endpoint for getting a list of approval requests
- Added beta endpoint for getting a single approval request
- Added
resultsfield to the experiment metric results response for contexts that have data slicing enabled - Added
resourceIdandapprovalSettingsfields to the responses forgetApprovalRequestandgetApprovalRequests - Added
statusquery parameters to thegetWorkflowsbeta endpoint - Added beta endpoint for fetching client-side monthly context instance usage
- Added beta endpoint for fetching client-side connection minutes usage
- Added beta endpoint for fetching experimentation units usage
- Added beta endpoint for fetching experimentation keys usage
- Added
experimentalPropertiesfield to experiment create post body - Added
randomizationUnitto- the
IterationInputobject - the responses for
getExperiment,getExperiments, andcreateIteration
- the
- Added
randomizationUnitsto- the
MetricPostobject - the responses for
getMetricandgetMetrics
- the
- Added beta endpoint for retrieving experimentation settings for a given project
- Added beta endpoint for updating experimentation settings for a given project
- Added beta endpoints getting experimentation keys usage
Removed
Changed
- Updated title of
getAuditLogEntriesto reflect that audit logs aren't specific to feature flags - Updated operation ID
postApprovalRequesttopostApprovalRequestForFlagto reflect that it's flag specific. The title has also been updated to reflect this. - Updated operation ID
postApprovalRequestReviewtopostApprovalRequestReviewForFlagto reflect that it's flag specific. The title has also been updated to reflect this. - Updated operation ID
postApprovalRequestApplyRequesttopostApprovalRequestApplyForFlagto reflect that it's flag specific. The title has also been updated to reflect this. - Updated operation ID
deleteApprovalRequesttodeleteApprovalRequestForFlagto reflect that it's flag specific. The title has also been updated to reflect this. - Updated to new syntax for filter query param in beta endpoint
getApprovalRequests. Support for the old syntax is being dropped. See documentation for new syntax. - Updated type of
LinksinFlagConfigApprovalRequestResponse
Bug Fixes
- Fixing
postWorkflowbeta endpointnameisrequired(previously incorrectly marked as optional)descriptionisoptional(previously incorrectly marked as required)
11.0.0
[11.0.0] - 2022-11-21
Added
- Added beta Workflow templates endpoints
- added structs for Flag Reuse to be expanded upon later
- Added
targetingRuleDescriptionto experiment iteration flag response - Added
targetingRuleClausesto experiment iteration flag response - Added
probabilityOfMismatchto experiment result response - Added
archivedDatefield to experiment response, omitted when experiment is not archived - Added
archivedDatefield to expanded experiment for the Get metric endpoint, omitted when experiment is not archived - Added
lifecycleStateparameter to Get experiments to query by archived and/or active experiments - Added
_idpSyncedparameter toTeamobject - Added beta endpoints for flag defaults
- Added beta endpoint for bulk editing members
- Added beta endpoint for bulk editing teams
- Added
MaintainerTeamin preparation for teams as flag maintainers (not yet released) - Add beta endpoints for Approval Requests
Removed
Changed
- Updated beta create workflow endpoint to allow for creating a workflow from a template
- In the Experiments endpoints, updated the existing
kindfield in the metric types to only include the allowed enum values (pageview,click,custom) - Get metric
experimentsfield is expandable, omitted by default - Get metric
experimentCountfield is expandable, omitted by default - Get metric list
experimentCountfield is expandable, omitted by default - Renamed
ExpiringUserTargetErrortoExpiringTargetErrorto prepare for expiring context targets - New code reference repositories will set the
defaultBranchtomainif you do not specify a value during creation - In repository endpoints,
gitlabis now a supportedrepoType - In the flag creation endpoint, updated endpoint to replace applicable
nullvalues with project-level flag defaults - Renamed
getApprovalsandgetApprovalendpoints togetApprovalsForFlagandgetApprovalForFlagrespectively
Bug Fixes
- Updated OpenAPI specification to include the missing
sortquery param onGET /projects - Updated
ResourceIdentifierfrom an empty Object to a string type - Updated
UUIDto be a string with formatuuid
10.0.0
[10.0.0] - 2022-07-12
Added
- Support for federal server
https://app.launchdarkly.us - Teams API out of beta
- New beta OAuth2 Clients API
- New follow flags API
- Added optional
ruleClausetoParameterDefaultobject - Added optional
oauthProviderstoMemberobject - Added optional
templateKeytoCustomWorkflowInputRepobject - Added optional
notifyTeamKeysparameter to- create approval
- create approval request to copy flag configurations across environments
- create workflow
Changed
- Changed
StatementReptoStatement - Using version 6.0.0 of OpenAPI generator
- Changes to beta experimentation API
- Renamed
StatementReptoStatement - List projects has a default limit of 20, added support for filter and sort
- List projects
environmentfield is expandable, omitted by default - Get project
environmentfield is expandable, omitted by default - Changed
notifyMemberIdsfrom required to optional for create approval and flag config copy approval requests - In the Approvals endpoints, updated existing fields in response types to only include the allowed enum values:
reviewStatusandstatusinFlagConfigApprovalRequestResponsekindinReviewResponse
Bug Fixes
- Removed unintentionally exposed optional
variationJsonSchemafromFeatureFlagBody - Added missing
variationstoFlagSummaryobject - Removed required attribute from fields on the
GET /api/v2/flags/{projectKey}response that are only shown when the request contains?summary=false
9.0.1
[9.0.1] - 2022-04-29
Changed:
- Changes to Experiments (beta) endpoints