> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/feature-management-experimentation/split-api-reference/feature-flags.md).

# Feature Flags

## List feature flags

> Retrieves the feature flags for an account.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/":{"get":{"summary":"List feature flags","description":"Retrieves the feature flags for an account.","operationId":"list-feature-flags","parameters":[{"name":"offset","in":"query","description":"The offset to retrieve. Useful for pagination","schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","description":"The maximum feature flag metadatas to return per call. Default=20. Max=50.","schema":{"type":"integer","format":"int32","default":20}},{"name":"tag","in":"query","description":"repeatable tag parameter(s) to query by","schema":{"type":"string"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) to get a list of feature flags from. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Get feature flag

> Retrieves the feature flag.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}":{"get":{"summary":"Get feature flag","description":"Retrieves the feature flag.","operationId":"get-feature-flag","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) to get the feature flag from. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"trafficType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"creationTime":{"type":"integer","default":0},"id":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}},"rolloutStatus":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"owners":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"}}}},"rolloutStatusTimestamp":{"type":"integer","default":0}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Delete a feature flag

> Deletes a feature flag from your account. This automatically unconfigures the feature flag definition from all FME environments. An SDK calling this feature flag returns "control".

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}":{"delete":{"summary":"Delete a feature flag","description":"Deletes a feature flag from your account. This automatically unconfigures the feature flag definition from all FME environments. An SDK calling this feature flag returns \"control\".","operationId":"delete-feature-flag","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag you want to delete. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag you want to delete (or kill)"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"boolean","default":true}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Update feature flag

> Allows updating the feature flag description, tags, and rollout status.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}":{"patch":{"summary":"Update feature flag","description":"Allows updating the feature flag description, tags, and rollout status.","operationId":"update-feature-flag","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag you want to update. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag you want to update"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Archive a feature flag

> Archive an existing feature flag. Archived feature flags remain in your account but are no longer active for regular use.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/archive":{"put":{"summary":"Archive a feature flag","description":"Archive an existing feature flag. Archived feature flags remain in your account but are no longer active for regular use.","operationId":"archive-feature-flag","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) containing the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag to archive."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"The title of the change."},"comment":{"type":"string","description":"Description of the change."}}}}}},"responses":{"200":{"description":"Feature flag successfully archived."},"400":{"description":"400"},"401":{"description":"401"},"403":{"description":"403"},"404":{"description":"404"},"500":{"description":"Internal Server Error"}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Unarchive a feature flag

> Restore an archived feature flag. Unarchived feature flags become active again and are available for regular use.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/unarchive":{"put":{"description":"Restore an archived feature flag. Unarchived feature flags become active again and are available for regular use.","responses":{"200":{"description":"Feature flag successfully unarchived.","content":{"application/json":{}}}},"parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true}],"summary":"Unarchive a feature flag","operationId":"put_splits-ws-workspace-id-feature-flag-name-unarchive","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"The title of the change."},"comment":{"type":"string","description":"Description of the change."}}}}}},"tags":["Feature Flags"]}}}}
```

## Create feature flag

> Create a feature flag in your account, given a traffic type. This API does not configure the flag in any environment. Provide the feature flag details in the JSON body; path parameters specify the project and traffic type.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/trafficTypes/{traffic-type-id-or-name}":{"post":{"summary":"Create feature flag","description":"Create a feature flag in your account, given a traffic type. This API does not configure the flag in any environment. Provide the feature flag details in the JSON body; path parameters specify the project and traffic type.","operationId":"create-feature-flag","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) where you want to create the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"traffic-type-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the traffic type used to create the feature flag."}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"feature_flag":{"type":"string","description":"JSON object that contains the name and (optionally) the description and owners of the feature flag.","format":"json"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"trafficType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"creationTime":{"type":"integer","default":0},"rolloutStatus":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"rolloutStatusTimestamp":{"type":"integer","default":0},"owners":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"}}}},"tags":{}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"409":{"description":"409","content":{"text/plain":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## List feature flag definitions in environment

> Retrieves the feature flag definitions given an environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/environments/{environment-id-or-name}":{"get":{"summary":"List feature flag definitions in environment","description":"Retrieves the feature flag definitions given an environment.","operationId":"list-feature-flag-definitions-in-environment","parameters":[{"name":"offset","in":"query","description":"The offset to retrieve. Useful for pagination.","schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","description":"The maximum feature flags to return per call. Default=20. Max=50.","schema":{"type":"integer","format":"int32","default":20}},{"name":"flag_sets","in":"query","description":"(Optional) An array of IDs of the flag sets you want to filter by. This will allow you to retrieve all feature flags that belong to specific flag sets.","schema":{"type":"string"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) you want to get feature flag definitions from. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment you want to get feature flag definitions from"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"RAW_BODY":{"type":"string"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Get feature flag definition in environment

> Retrieves a feature flag definition given the name and the environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}":{"get":{"summary":"Get feature flag definition in environment","description":"Retrieves a feature flag definition given the name and the environment.","operationId":"get-feature-flag-definition-in-environment","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment you want to get feature flag definition from"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"environment":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"trafficType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"killed":{"type":"boolean","default":true},"lastTrafficReceivedAt":{"type":"integer","default":0},"treatments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"configurations":{"type":"string"}}}},"defaultTreatment":{"type":"string"},"baselineTreatment":{"type":"string"},"trafficAllocation":{"type":"integer","default":0},"rules":{"type":"array","items":{"type":"object","properties":{"buckets":{"type":"array","items":{"type":"object","properties":{"treatment":{"type":"string"},"size":{"type":"integer","default":0}}}},"condition":{"type":"object","properties":{"combiner":{"type":"string"},"matchers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"string":{"type":"string"}}}}}}}}},"defaultRule":{"type":"array","items":{"type":"object","properties":{"treatment":{"type":"string"},"size":{"type":"integer","default":0}}}},"creationTime":{"type":"integer","default":0},"lastUpdateTime":{"type":"integer","default":0}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Create feature flag definition in environment

> Configures a feature flag definition for a specific environment. Provide the feature flag configuration in the JSON body; path parameters specify the project, feature flag, and environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}":{"post":{"summary":"Create feature flag definition in environment","description":"Configures a feature flag definition for a specific environment. Provide the feature flag configuration in the JSON body; path parameters specify the project, feature flag, and environment.","operationId":"create-feature-flag-definition-in-environment","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment where you want to create the feature flag definition"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"feature_flag":{"type":"string","description":"JSON object that contains the feature flag.","format":"json"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"environment":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}}},"trafficType":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}}},"killed":{"type":"boolean","default":true},"treatments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"configurations":{"type":"string"}}}},"defaultTreatment":{"type":"string"},"baselineTreatment":{"type":"string"},"trafficAllocation":{"type":"integer","default":0},"rules":{"type":"array","items":{"type":"object","properties":{"buckets":{"type":"array","items":{"type":"object","properties":{"treatment":{"type":"string"},"size":{"type":"integer","default":0}}}},"condition":{"type":"object","properties":{"combiner":{"type":"string"},"matchers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"string":{"type":"string"}}}}}}}}},"defaultRule":{"type":"array","items":{"type":"object","properties":{"treatment":{"type":"string"},"size":{"type":"integer","default":0}}}},"creationTime":{"type":"integer","default":0},"lastUpdateTime":{"type":"integer","default":0}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}},"text/plain":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"409":{"description":"409","content":{"text/plain":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Full update feature flag definition in environment

> Performs a full update of a feature flag definition for a specific environment. Provide the complete feature flag definition in the JSON body; path parameters specify the project, feature flag, and environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}":{"put":{"summary":"Full update feature flag definition in environment","description":"Performs a full update of a feature flag definition for a specific environment. Provide the complete feature flag definition in the JSON body; path parameters specify the project, feature flag, and environment.","operationId":"full-update-feature-flag-definition-in-environment","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment where you want to update the feature flag definition"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"feature_flag_definition":{"type":"string","description":"JSON object that contains the full feature flag definition to be updated.","format":"json"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"text/plain":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Remove feature flag definition from environment

> Unconfigures a feature flag definition for a specific environment. Any SDK calling this feature flag returns "control" for the selected environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}":{"delete":{"summary":"Remove feature flag definition from environment","description":"Unconfigures a feature flag definition for a specific environment. Any SDK calling this feature flag returns \"control\" for the selected environment.","operationId":"remove-feature-flag-definition-from-environment","parameters":[{"name":"title","in":"query","description":"Change request title","schema":{"type":"string"}},{"name":"comment","in":"query","description":"Change request comment","schema":{"type":"string"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment where you want to remove the feature flag definition"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"boolean","default":true}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Partial update feature flag definition in environment

> Updates a feature flag definition for a specific environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}":{"patch":{"summary":"Partial update feature flag definition in environment","description":"Updates a feature flag definition for a specific environment.","operationId":"partial-update-feature-flag-definition-in-environment","parameters":[{"name":"title","in":"query","description":"Change request title","schema":{"type":"string"}},{"name":"comment","in":"query","description":"Change request comment","schema":{"type":"string"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment where you want to update the feature flag definition"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"updated_feature_flag":{"type":"string","description":"JSON object that contains the attributes of a feature flag to be updated in JsonPatch format.","format":"json"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"text/plain":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Update feature flag description

> Changes the description of a particular feature flag. Provide the updated feature flag description in the JSON body; path parameters specify the project and feature flag name.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/updateDescription":{"put":{"summary":"Update feature flag description","description":"Changes the description of a particular feature flag. Provide the updated feature flag description in the JSON body; path parameters specify the project and feature flag name.","operationId":"update-feature-flag-description","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag you want to update. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"description":{"type":"string","description":"JSON Object with the description.","format":"json"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"trafficType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"creationTime":{"type":"integer","default":0},"id":{"type":"string"},"rolloutStatus":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"rolloutStatusTimestamp":{"type":"integer","default":0},"tags":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Kill feature flag in environment (alternate)

> Kills a feature in a specific environment using POST. Only use this API if PUT does not work. Include the feature flag kill details in the JSON body; path parameters specify the project, feature flag, and environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}/kill":{"post":{"summary":"Kill feature flag in environment (alternate)","description":"Kills a feature in a specific environment using POST. Only use this API if PUT does not work. Include the feature flag kill details in the JSON body; path parameters specify the project, feature flag, and environment.","operationId":"kill-feature-flag-in-environment-alternate","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment where you want to kill the feature flag"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Kill feature flag in environment

> Kills a feature in a specific environment. Include the feature flag kill details in the JSON body; path parameters specify the project, feature flag, and environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}/kill":{"put":{"summary":"Kill feature flag in environment","description":"Kills a feature in a specific environment. Include the feature flag kill details in the JSON body; path parameters specify the project, feature flag, and environment.","operationId":"kill-feature-flag-in-environment","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment where you want to kill the feature flag"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## Restore feature flag in environment

> Restore a feature in a specific environment. Include the feature flag restore details in the JSON body; path parameters specify the project, feature flag, and environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{workspace-id}/{feature-flag-name}/environments/{environment-id-or-name}/restore":{"put":{"summary":"Restore feature flag in environment","description":"Restore a feature in a specific environment. Include the feature flag restore details in the JSON body; path parameters specify the project, feature flag, and environment.","operationId":"restore-feature-flag-in-environment","parameters":[{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) of the feature flag. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"feature-flag-name","schema":{"type":"string"},"required":true,"description":"The case-sensitive name of the feature flag"},{"in":"path","name":"environment-id-or-name","schema":{"type":"string"},"required":true,"description":"The ID or case-sensitive name of the FME environment where you want to restore the feature flag"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"}}}}}}},"deprecated":false,"tags":["Feature Flags"]}}}}
```

## POST /splits/ws/{wsId}/{splitMetadataName}/environments/{environmentNameOrId}/reallocate

>

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Feature Flags"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/splits/ws/{wsId}/{splitMetadataName}/environments/{environmentNameOrId}/reallocate":{"post":{"description":"","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"environment":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"trafficType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"killed":{"type":"boolean","default":true},"treatments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"keys":{"type":"array","items":{"type":"object","properties":{}}},"segments":{"type":"array","items":{"type":"object","properties":{}}}}}},"defaultTreatment":{"type":"string"},"baselineTreatment":{"type":"string"},"trafficAllocation":{"type":"integer","default":0},"rules":{"type":"array","items":{"type":"object","properties":{"buckets":{"type":"array","items":{"type":"object","properties":{"treatment":{"type":"string"},"size":{"type":"integer","default":0}}}},"condition":{"type":"object","properties":{"combiner":{"type":"string"},"matchers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"negate":{"type":"boolean","default":true},"string":{"type":"string"}}}}}}}}},"defaultRule":{"type":"object","properties":{"treatment":{"type":"string"},"size":{"type":"integer","default":0}}},"creationTime":{"type":"integer","default":0},"lastUpdateTime":{"type":"integer","default":0},"changeNumber":{"type":"integer","default":0},"comment":{"type":"string"},"title":{"type":"string"},"openChangeRequestId":{"type":"string"},"lastTrafficReceivedAt":{"type":"integer","default":0},"flagSets":{"type":"array","items":{"type":"object","properties":{}}},"impressionsDisabled":{"type":"boolean","default":true}}}}}},"400":{"description":"Missing required path parameters","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"403":{"description":"Approvals required or blocked by policy","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"404":{"description":"Feature flag, environment, or traffic type not found.","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"409":{"description":"A pending change request already exists.","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}}},"parameters":[{"in":"header","name":"Accept","schema":{"type":"string","default":"application/json"},"description":"Response content type."},{"in":"path","name":"wsId","schema":{"type":"string"},"required":true,"description":"Project (or workspace) ID."},{"in":"path","name":"splitMetadataName","schema":{"type":"string"},"required":true,"description":"The feature flag name."},{"in":"path","name":"environmentNameOrId","schema":{"type":"string"},"required":true,"description":"The FME environment name or ID."},{"in":"header","name":"Authorization","schema":{"type":"string","default":"Bearer <API_TOKEN>"}},{"in":"header","name":"Content-Type","schema":{"type":"string","default":"application/json"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"A short description for the reallocation request."},"comment":{"type":"string","description":"Additional notes regarding the reallocation."}},"required":["title"]}}}},"operationId":"post_splits-ws-wsid-splitmetadataname-environments-environmentnameorid-reallocate","tags":["Feature Flags"]}}}}
```
