launchdarkly_api 5.4.0 → 6.0.0

data/docs/ApprovalSettings.md

@@ -0,0 +1,32 @@
+# LaunchDarklyApi::ApprovalSettings
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **required** | **Boolean** | If approvals are required for this environment. |  |
+| **bypass_approvals_for_pending_changes** | **Boolean** |  |  |
+| **min_num_approvals** | **Integer** | Sets the amount of approvals required before a member can apply a change. The minimum is one and the maximum is five. |  |
+| **can_review_own_request** | **Boolean** | Allow someone who makes an approval request to apply their own change. |  |
+| **can_apply_declined_changes** | **Boolean** | Allow applying the change as long as at least one person has approved. |  |
+| **service_kind** | **String** | Which service to use for managing approvals. |  |
+| **service_config** | **Hash<String, Object>** |  |  |
+| **required_approval_tags** | **Array<String>** | Require approval only on flags with the provided tags. Otherwise all flags will require approval. |  |
+
+## Example
+
+```ruby
+require 'launchdarkly_api'
+
+instance = LaunchDarklyApi::ApprovalSettings.new(
+  required: true,
+  bypass_approvals_for_pending_changes: false,
+  min_num_approvals: 1,
+  can_review_own_request: false,
+  can_apply_declined_changes: false,
+  service_kind: launchdarkly,
+  service_config: {},
+  required_approval_tags: ["require-approval"]
+)
+```
+

data/docs/ApprovalsApi.md

@@ -0,0 +1,554 @@
+# LaunchDarklyApi::ApprovalsApi
+
+All URIs are relative to *https://app.launchdarkly.com*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**delete_approval_request**](ApprovalsApi.md#delete_approval_request) | **DELETE** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id} | Delete approval request |
+| [**get_approval**](ApprovalsApi.md#get_approval) | **GET** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id} | Get approval request |
+| [**get_approvals**](ApprovalsApi.md#get_approvals) | **GET** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests | List all approval requests |
+| [**post_approval_request**](ApprovalsApi.md#post_approval_request) | **POST** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests | Create approval request |
+| [**post_approval_request_apply_request**](ApprovalsApi.md#post_approval_request_apply_request) | **POST** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id}/apply | Apply approval request |
+| [**post_approval_request_review**](ApprovalsApi.md#post_approval_request_review) | **POST** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id}/reviews | Review approval request |
+| [**post_flag_copy_config_approval_request**](ApprovalsApi.md#post_flag_copy_config_approval_request) | **POST** /api/v2/projects/{projectKey}/flags/{featureFlagKey}/copy/environments/{environmentKey}/approval-requests-flag-copy | Create approval request to copy flag configurations across environments |
+
+
+## delete_approval_request
+
+> delete_approval_request(project_key, feature_flag_key, environment_key, id)
+
+Delete approval request
+
+Delete an approval request for a feature flag
+
+### Examples
+
+```ruby
+require 'time'
+require 'launchdarkly_api'
+# setup authorization
+LaunchDarklyApi.configure do |config|
+  # Configure API key authorization: ApiKey
+  config.api_key['ApiKey'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKey'] = 'Bearer'
+end
+
+api_instance = LaunchDarklyApi::ApprovalsApi.new
+project_key = 'project_key_example' # String | The project key
+feature_flag_key = 'feature_flag_key_example' # String | The feature flag's key
+environment_key = 'environment_key_example' # String | The environment key
+id = 'id_example' # String | The feature flag approval request ID
+
+begin
+  # Delete approval request
+  api_instance.delete_approval_request(project_key, feature_flag_key, environment_key, id)
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->delete_approval_request: #{e}"
+end
+```
+
+#### Using the delete_approval_request_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> delete_approval_request_with_http_info(project_key, feature_flag_key, environment_key, id)
+
+```ruby
+begin
+  # Delete approval request
+  data, status_code, headers = api_instance.delete_approval_request_with_http_info(project_key, feature_flag_key, environment_key, id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->delete_approval_request_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_key** | **String** | The project key |  |
+| **feature_flag_key** | **String** | The feature flag&#39;s key |  |
+| **environment_key** | **String** | The environment key |  |
+| **id** | **String** | The feature flag approval request ID |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: Not defined
+
+
+## get_approval
+
+> <FlagConfigApprovalRequestResponse> get_approval(project_key, feature_flag_key, environment_key, id)
+
+Get approval request
+
+Get a single approval request for a feature flag
+
+### Examples
+
+```ruby
+require 'time'
+require 'launchdarkly_api'
+# setup authorization
+LaunchDarklyApi.configure do |config|
+  # Configure API key authorization: ApiKey
+  config.api_key['ApiKey'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKey'] = 'Bearer'
+end
+
+api_instance = LaunchDarklyApi::ApprovalsApi.new
+project_key = 'project_key_example' # String | The project key
+feature_flag_key = 'feature_flag_key_example' # String | The feature flag's key
+environment_key = 'environment_key_example' # String | The environment key
+id = 'id_example' # String | The feature flag approval request ID
+
+begin
+  # Get approval request
+  result = api_instance.get_approval(project_key, feature_flag_key, environment_key, id)
+  p result
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->get_approval: #{e}"
+end
+```
+
+#### Using the get_approval_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FlagConfigApprovalRequestResponse>, Integer, Hash)> get_approval_with_http_info(project_key, feature_flag_key, environment_key, id)
+
+```ruby
+begin
+  # Get approval request
+  data, status_code, headers = api_instance.get_approval_with_http_info(project_key, feature_flag_key, environment_key, id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FlagConfigApprovalRequestResponse>
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->get_approval_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_key** | **String** | The project key |  |
+| **feature_flag_key** | **String** | The feature flag&#39;s key |  |
+| **environment_key** | **String** | The environment key |  |
+| **id** | **String** | The feature flag approval request ID |  |
+
+### Return type
+
+[**FlagConfigApprovalRequestResponse**](FlagConfigApprovalRequestResponse.md)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_approvals
+
+> <FlagConfigApprovalRequestsResponse> get_approvals(project_key, feature_flag_key, environment_key)
+
+List all approval requests
+
+Get all approval requests for a feature flag
+
+### Examples
+
+```ruby
+require 'time'
+require 'launchdarkly_api'
+# setup authorization
+LaunchDarklyApi.configure do |config|
+  # Configure API key authorization: ApiKey
+  config.api_key['ApiKey'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKey'] = 'Bearer'
+end
+
+api_instance = LaunchDarklyApi::ApprovalsApi.new
+project_key = 'project_key_example' # String | The project key
+feature_flag_key = 'feature_flag_key_example' # String | The feature flag's key
+environment_key = 'environment_key_example' # String | The environment key
+
+begin
+  # List all approval requests
+  result = api_instance.get_approvals(project_key, feature_flag_key, environment_key)
+  p result
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->get_approvals: #{e}"
+end
+```
+
+#### Using the get_approvals_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FlagConfigApprovalRequestsResponse>, Integer, Hash)> get_approvals_with_http_info(project_key, feature_flag_key, environment_key)
+
+```ruby
+begin
+  # List all approval requests
+  data, status_code, headers = api_instance.get_approvals_with_http_info(project_key, feature_flag_key, environment_key)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FlagConfigApprovalRequestsResponse>
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->get_approvals_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_key** | **String** | The project key |  |
+| **feature_flag_key** | **String** | The feature flag&#39;s key |  |
+| **environment_key** | **String** | The environment key |  |
+
+### Return type
+
+[**FlagConfigApprovalRequestsResponse**](FlagConfigApprovalRequestsResponse.md)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## post_approval_request
+
+> <FlagConfigApprovalRequestResponse> post_approval_request(project_key, feature_flag_key, environment_key, create_flag_config_approval_request_request)
+
+Create approval request
+
+Create an approval request for a feature flag
+
+### Examples
+
+```ruby
+require 'time'
+require 'launchdarkly_api'
+# setup authorization
+LaunchDarklyApi.configure do |config|
+  # Configure API key authorization: ApiKey
+  config.api_key['ApiKey'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKey'] = 'Bearer'
+end
+
+api_instance = LaunchDarklyApi::ApprovalsApi.new
+project_key = 'project_key_example' # String | The project key
+feature_flag_key = 'feature_flag_key_example' # String | The feature flag's key
+environment_key = 'environment_key_example' # String | The environment key
+create_flag_config_approval_request_request = LaunchDarklyApi::CreateFlagConfigApprovalRequestRequest.new({description: 'description_example', instructions: [{ key: 3.56}], notify_member_ids: ['notify_member_ids_example']}) # CreateFlagConfigApprovalRequestRequest | 
+
+begin
+  # Create approval request
+  result = api_instance.post_approval_request(project_key, feature_flag_key, environment_key, create_flag_config_approval_request_request)
+  p result
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_approval_request: #{e}"
+end
+```
+
+#### Using the post_approval_request_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FlagConfigApprovalRequestResponse>, Integer, Hash)> post_approval_request_with_http_info(project_key, feature_flag_key, environment_key, create_flag_config_approval_request_request)
+
+```ruby
+begin
+  # Create approval request
+  data, status_code, headers = api_instance.post_approval_request_with_http_info(project_key, feature_flag_key, environment_key, create_flag_config_approval_request_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FlagConfigApprovalRequestResponse>
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_approval_request_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_key** | **String** | The project key |  |
+| **feature_flag_key** | **String** | The feature flag&#39;s key |  |
+| **environment_key** | **String** | The environment key |  |
+| **create_flag_config_approval_request_request** | [**CreateFlagConfigApprovalRequestRequest**](CreateFlagConfigApprovalRequestRequest.md) |  |  |
+
+### Return type
+
+[**FlagConfigApprovalRequestResponse**](FlagConfigApprovalRequestResponse.md)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## post_approval_request_apply_request
+
+> <FlagConfigApprovalRequestResponse> post_approval_request_apply_request(project_key, feature_flag_key, environment_key, id, post_approval_request_apply_request)
+
+Apply approval request
+
+Apply approval request by either approving or declining changes.
+
+### Examples
+
+```ruby
+require 'time'
+require 'launchdarkly_api'
+# setup authorization
+LaunchDarklyApi.configure do |config|
+  # Configure API key authorization: ApiKey
+  config.api_key['ApiKey'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKey'] = 'Bearer'
+end
+
+api_instance = LaunchDarklyApi::ApprovalsApi.new
+project_key = 'project_key_example' # String | The project key
+feature_flag_key = 'feature_flag_key_example' # String | The feature flag's key
+environment_key = 'environment_key_example' # String | The environment key
+id = 'id_example' # String | The feature flag approval request ID
+post_approval_request_apply_request = LaunchDarklyApi::PostApprovalRequestApplyRequest.new # PostApprovalRequestApplyRequest | 
+
+begin
+  # Apply approval request
+  result = api_instance.post_approval_request_apply_request(project_key, feature_flag_key, environment_key, id, post_approval_request_apply_request)
+  p result
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_approval_request_apply_request: #{e}"
+end
+```
+
+#### Using the post_approval_request_apply_request_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FlagConfigApprovalRequestResponse>, Integer, Hash)> post_approval_request_apply_request_with_http_info(project_key, feature_flag_key, environment_key, id, post_approval_request_apply_request)
+
+```ruby
+begin
+  # Apply approval request
+  data, status_code, headers = api_instance.post_approval_request_apply_request_with_http_info(project_key, feature_flag_key, environment_key, id, post_approval_request_apply_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FlagConfigApprovalRequestResponse>
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_approval_request_apply_request_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_key** | **String** | The project key |  |
+| **feature_flag_key** | **String** | The feature flag&#39;s key |  |
+| **environment_key** | **String** | The environment key |  |
+| **id** | **String** | The feature flag approval request ID |  |
+| **post_approval_request_apply_request** | [**PostApprovalRequestApplyRequest**](PostApprovalRequestApplyRequest.md) |  |  |
+
+### Return type
+
+[**FlagConfigApprovalRequestResponse**](FlagConfigApprovalRequestResponse.md)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## post_approval_request_review
+
+> <FlagConfigApprovalRequestResponse> post_approval_request_review(project_key, feature_flag_key, environment_key, id, post_approval_request_review_request)
+
+Review approval request
+
+Review approval request by either approving or declining changes.
+
+### Examples
+
+```ruby
+require 'time'
+require 'launchdarkly_api'
+# setup authorization
+LaunchDarklyApi.configure do |config|
+  # Configure API key authorization: ApiKey
+  config.api_key['ApiKey'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKey'] = 'Bearer'
+end
+
+api_instance = LaunchDarklyApi::ApprovalsApi.new
+project_key = 'project_key_example' # String | The project key
+feature_flag_key = 'feature_flag_key_example' # String | The feature flag's key
+environment_key = 'environment_key_example' # String | The environment key
+id = 'id_example' # String | The feature flag approval request ID
+post_approval_request_review_request = LaunchDarklyApi::PostApprovalRequestReviewRequest.new # PostApprovalRequestReviewRequest | 
+
+begin
+  # Review approval request
+  result = api_instance.post_approval_request_review(project_key, feature_flag_key, environment_key, id, post_approval_request_review_request)
+  p result
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_approval_request_review: #{e}"
+end
+```
+
+#### Using the post_approval_request_review_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FlagConfigApprovalRequestResponse>, Integer, Hash)> post_approval_request_review_with_http_info(project_key, feature_flag_key, environment_key, id, post_approval_request_review_request)
+
+```ruby
+begin
+  # Review approval request
+  data, status_code, headers = api_instance.post_approval_request_review_with_http_info(project_key, feature_flag_key, environment_key, id, post_approval_request_review_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FlagConfigApprovalRequestResponse>
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_approval_request_review_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_key** | **String** | The project key |  |
+| **feature_flag_key** | **String** | The feature flag&#39;s key |  |
+| **environment_key** | **String** | The environment key |  |
+| **id** | **String** | The feature flag approval request ID |  |
+| **post_approval_request_review_request** | [**PostApprovalRequestReviewRequest**](PostApprovalRequestReviewRequest.md) |  |  |
+
+### Return type
+
+[**FlagConfigApprovalRequestResponse**](FlagConfigApprovalRequestResponse.md)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## post_flag_copy_config_approval_request
+
+> <FlagConfigApprovalRequestResponse> post_flag_copy_config_approval_request(project_key, feature_flag_key, environment_key, create_copy_flag_config_approval_request_request)
+
+Create approval request to copy flag configurations across environments
+
+Create an approval request to copy a feature flag's configuration across environments.
+
+### Examples
+
+```ruby
+require 'time'
+require 'launchdarkly_api'
+# setup authorization
+LaunchDarklyApi.configure do |config|
+  # Configure API key authorization: ApiKey
+  config.api_key['ApiKey'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['ApiKey'] = 'Bearer'
+end
+
+api_instance = LaunchDarklyApi::ApprovalsApi.new
+project_key = 'project_key_example' # String | The project key
+feature_flag_key = 'feature_flag_key_example' # String | The feature flag's key
+environment_key = 'environment_key_example' # String | The environment key
+create_copy_flag_config_approval_request_request = LaunchDarklyApi::CreateCopyFlagConfigApprovalRequestRequest.new({notify_member_ids: ['notify_member_ids_example'], source: LaunchDarklyApi::SourceFlag.new({key: 'key_example'})}) # CreateCopyFlagConfigApprovalRequestRequest | 
+
+begin
+  # Create approval request to copy flag configurations across environments
+  result = api_instance.post_flag_copy_config_approval_request(project_key, feature_flag_key, environment_key, create_copy_flag_config_approval_request_request)
+  p result
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_flag_copy_config_approval_request: #{e}"
+end
+```
+
+#### Using the post_flag_copy_config_approval_request_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FlagConfigApprovalRequestResponse>, Integer, Hash)> post_flag_copy_config_approval_request_with_http_info(project_key, feature_flag_key, environment_key, create_copy_flag_config_approval_request_request)
+
+```ruby
+begin
+  # Create approval request to copy flag configurations across environments
+  data, status_code, headers = api_instance.post_flag_copy_config_approval_request_with_http_info(project_key, feature_flag_key, environment_key, create_copy_flag_config_approval_request_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FlagConfigApprovalRequestResponse>
+rescue LaunchDarklyApi::ApiError => e
+  puts "Error when calling ApprovalsApi->post_flag_copy_config_approval_request_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_key** | **String** | The project key |  |
+| **feature_flag_key** | **String** | The feature flag&#39;s key |  |
+| **environment_key** | **String** | The environment key |  |
+| **create_copy_flag_config_approval_request_request** | [**CreateCopyFlagConfigApprovalRequestRequest**](CreateCopyFlagConfigApprovalRequestRequest.md) |  |  |
+
+### Return type
+
+[**FlagConfigApprovalRequestResponse**](FlagConfigApprovalRequestResponse.md)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+