All URIs are relative to https://app.launchdarkly.com
| Method | HTTP request | Description |
|---|---|---|
| create_release_for_flag | PUT /api/v2/projects/{projectKey}/flags/{flagKey}/release | Create a new release for flag |
| delete_release_by_flag_key | DELETE /api/v2/flags/{projectKey}/{flagKey}/release | Delete a release for flag |
| get_release_by_flag_key | GET /api/v2/flags/{projectKey}/{flagKey}/release | Get release for flag |
| patch_release_by_flag_key | PATCH /api/v2/flags/{projectKey}/{flagKey}/release | Patch release for flag |
| update_phase_status | PUT /api/v2/projects/{projectKey}/flags/{flagKey}/release/phases/{phaseId} | Update phase status for release |
Release create_release_for_flag(project_key, flag_key, create_release_input)
Create a new release for flag
Creates a release by adding a flag to a release pipeline
- Api Key Authentication (ApiKey):
import launchdarkly_api
from launchdarkly_api.models.create_release_input import CreateReleaseInput
from launchdarkly_api.models.release import Release
from launchdarkly_api.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://app.launchdarkly.com
# See configuration.py for a list of all supported configuration parameters.
configuration = launchdarkly_api.Configuration(
host = "https://app.launchdarkly.com"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure API key authorization: ApiKey
configuration.api_key['ApiKey'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKey'] = 'Bearer'
# Enter a context with an instance of the API client
with launchdarkly_api.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = launchdarkly_api.ReleasesBetaApi(api_client)
project_key = 'project_key_example' # str | The project key
flag_key = 'flag_key_example' # str | The flag key
create_release_input = launchdarkly_api.CreateReleaseInput() # CreateReleaseInput |
try:
# Create a new release for flag
api_response = api_instance.create_release_for_flag(project_key, flag_key, create_release_input)
print("The response of ReleasesBetaApi->create_release_for_flag:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling ReleasesBetaApi->create_release_for_flag: %s\n" % e)| Name | Type | Description | Notes |
|---|---|---|---|
| project_key | str | The project key | |
| flag_key | str | The flag key | |
| create_release_input | CreateReleaseInput |
- Content-Type: application/json
- Accept: application/json
| Status code | Description | Response headers |
|---|---|---|
| 200 | Release response | - |
| 400 | Invalid request | - |
| 401 | Invalid access token | - |
| 404 | Invalid resource identifier | - |
| 429 | Rate limit exceeded | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
delete_release_by_flag_key(project_key, flag_key)
Delete a release for flag
Deletes a release from a flag
- Api Key Authentication (ApiKey):
import launchdarkly_api
from launchdarkly_api.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://app.launchdarkly.com
# See configuration.py for a list of all supported configuration parameters.
configuration = launchdarkly_api.Configuration(
host = "https://app.launchdarkly.com"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure API key authorization: ApiKey
configuration.api_key['ApiKey'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKey'] = 'Bearer'
# Enter a context with an instance of the API client
with launchdarkly_api.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = launchdarkly_api.ReleasesBetaApi(api_client)
project_key = 'project_key_example' # str | The project key
flag_key = 'flag_key_example' # str | The flag key
try:
# Delete a release for flag
api_instance.delete_release_by_flag_key(project_key, flag_key)
except Exception as e:
print("Exception when calling ReleasesBetaApi->delete_release_by_flag_key: %s\n" % e)| Name | Type | Description | Notes |
|---|---|---|---|
| project_key | str | The project key | |
| flag_key | str | The flag key |
void (empty response body)
- Content-Type: Not defined
- Accept: application/json
| Status code | Description | Response headers |
|---|---|---|
| 204 | Action succeeded | - |
| 403 | Forbidden | - |
| 404 | Invalid resource identifier | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Release get_release_by_flag_key(project_key, flag_key)
Get release for flag
Get currently active release for a flag
- Api Key Authentication (ApiKey):
import launchdarkly_api
from launchdarkly_api.models.release import Release
from launchdarkly_api.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://app.launchdarkly.com
# See configuration.py for a list of all supported configuration parameters.
configuration = launchdarkly_api.Configuration(
host = "https://app.launchdarkly.com"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure API key authorization: ApiKey
configuration.api_key['ApiKey'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKey'] = 'Bearer'
# Enter a context with an instance of the API client
with launchdarkly_api.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = launchdarkly_api.ReleasesBetaApi(api_client)
project_key = 'project_key_example' # str | The project key
flag_key = 'flag_key_example' # str | The flag key
try:
# Get release for flag
api_response = api_instance.get_release_by_flag_key(project_key, flag_key)
print("The response of ReleasesBetaApi->get_release_by_flag_key:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling ReleasesBetaApi->get_release_by_flag_key: %s\n" % e)| Name | Type | Description | Notes |
|---|---|---|---|
| project_key | str | The project key | |
| flag_key | str | The flag key |
- Content-Type: Not defined
- Accept: application/json
| Status code | Description | Response headers |
|---|---|---|
| 200 | Release response | - |
| 404 | Invalid resource identifier | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Release patch_release_by_flag_key(project_key, flag_key, patch_operation)
Patch release for flag
This endpoint is only available for releases that are part of a legacy release pipeline. Releases for new release pipelines should use the Update phase status for release endpoint.
Update currently active release for a flag. Updating releases requires the JSON patch format. To learn more, read Updates.
You can only use this endpoint to mark a release phase complete or incomplete. To indicate which phase to update, use the array index in the path. For example, to mark the first phase of a release as complete, use the following request body:
[
{
"op": "replace",
"path": "/phase/0/complete",
"value": true
}
]
- Api Key Authentication (ApiKey):
import launchdarkly_api
from launchdarkly_api.models.patch_operation import PatchOperation
from launchdarkly_api.models.release import Release
from launchdarkly_api.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://app.launchdarkly.com
# See configuration.py for a list of all supported configuration parameters.
configuration = launchdarkly_api.Configuration(
host = "https://app.launchdarkly.com"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure API key authorization: ApiKey
configuration.api_key['ApiKey'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKey'] = 'Bearer'
# Enter a context with an instance of the API client
with launchdarkly_api.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = launchdarkly_api.ReleasesBetaApi(api_client)
project_key = 'project_key_example' # str | The project key
flag_key = 'flag_key_example' # str | The flag key
patch_operation = [{"op":"replace","path":"/phases/0/complete","value":true}] # List[PatchOperation] |
try:
# Patch release for flag
api_response = api_instance.patch_release_by_flag_key(project_key, flag_key, patch_operation)
print("The response of ReleasesBetaApi->patch_release_by_flag_key:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling ReleasesBetaApi->patch_release_by_flag_key: %s\n" % e)| Name | Type | Description | Notes |
|---|---|---|---|
| project_key | str | The project key | |
| flag_key | str | The flag key | |
| patch_operation | List[PatchOperation] |
- Content-Type: application/json
- Accept: application/json
| Status code | Description | Response headers |
|---|---|---|
| 200 | Release response | - |
| 400 | Invalid request | - |
| 401 | Invalid access token | - |
| 403 | Forbidden | - |
| 404 | Invalid resource identifier | - |
| 429 | Rate limited | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Release update_phase_status(project_key, flag_key, phase_id, update_phase_status_input)
Update phase status for release
Updates the execution status of a phase of a release
- Api Key Authentication (ApiKey):
import launchdarkly_api
from launchdarkly_api.models.release import Release
from launchdarkly_api.models.update_phase_status_input import UpdatePhaseStatusInput
from launchdarkly_api.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://app.launchdarkly.com
# See configuration.py for a list of all supported configuration parameters.
configuration = launchdarkly_api.Configuration(
host = "https://app.launchdarkly.com"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure API key authorization: ApiKey
configuration.api_key['ApiKey'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKey'] = 'Bearer'
# Enter a context with an instance of the API client
with launchdarkly_api.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = launchdarkly_api.ReleasesBetaApi(api_client)
project_key = 'project_key_example' # str | The project key
flag_key = 'flag_key_example' # str | The flag key
phase_id = 'phase_id_example' # str | The phase ID
update_phase_status_input = launchdarkly_api.UpdatePhaseStatusInput() # UpdatePhaseStatusInput |
try:
# Update phase status for release
api_response = api_instance.update_phase_status(project_key, flag_key, phase_id, update_phase_status_input)
print("The response of ReleasesBetaApi->update_phase_status:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling ReleasesBetaApi->update_phase_status: %s\n" % e)| Name | Type | Description | Notes |
|---|---|---|---|
| project_key | str | The project key | |
| flag_key | str | The flag key | |
| phase_id | str | The phase ID | |
| update_phase_status_input | UpdatePhaseStatusInput |
- Content-Type: application/json
- Accept: application/json
| Status code | Description | Response headers |
|---|---|---|
| 200 | Action succeeded | - |
| 400 | Invalid request | - |
| 401 | Invalid access token | - |
| 404 | release or phase not found | - |
| 429 | Rate limit exceeded | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]