mirror of
https://github.com/Unleash/unleash.git
synced 2025-10-27 11:02:16 +01:00
docs: Add deprecation notices to features v1
todo: still need to add a couple links
This commit is contained in:
Thomas Heartman
parent
6c65075904
commit
d7029d89b4
@ -3,11 +3,23 @@ id: features
|
||||
title: /api/admin/features
|
||||
---
|
||||
|
||||
> In order to access the admin API endpoints you need to identify yourself. Unless you're using the `none` authentication method, you'll need to [create an ADMIN token](/user_guide/api-token) and add an Authorization header using the token.
|
||||
:::caution Deprecation notice
|
||||
This API was deprecated as part of the v4.3 release and will be removed in v5.0. See [the project-based API (/api/admin/projects/:projectId)](./feature-toggles-api-v2.md) instead.
|
||||
:::
|
||||
|
||||
**This API was deprecated as part of the v4.3 release and will be removed in v5.0. See [/api/admin/projects/:projectId](/api/admin/feature-toggles-v2) instead.**
|
||||
<DeprecationNotice resourceType="endpoint" linkText="blah" linkTarget="#buh" />
|
||||
|
||||
### Fetching Feature Toggles {#fetching-feature-toggles}
|
||||
|
||||
:::info
|
||||
In order to access the admin API endpoints you need to identify yourself. Unless you're using the `none` authentication method, you'll need to [create an **admin** token](/user_guide/api-token) and add an Authorization header using the token.
|
||||
:::
|
||||
|
||||
|
||||
## Fetching Feature Toggles {#fetching-feature-toggles}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to fetch all toggles](./feature-toggles-api-v2.md#fetching-toggles) instead.
|
||||
:::
|
||||
|
||||
`GET: http://unleash.host.com/api/admin/features`
|
||||
|
||||
@ -75,7 +87,7 @@ This endpoint is the one all admin ui should use to fetch all available feature
|
||||
}
|
||||
```
|
||||
|
||||
#### Filter feature toggles {#filter-feature-toggles}
|
||||
### Filter feature toggles {#filter-feature-toggles}
|
||||
|
||||
Supports three params for now
|
||||
|
||||
@ -95,7 +107,11 @@ To filter for any feature belonging to project `myproject` use
|
||||
|
||||
Response format is the same as `api/admin/features`
|
||||
|
||||
### Fetch specific feature toggle {#fetch-specific-feature-toggle}
|
||||
## Fetch specific feature toggle {#fetch-specific-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to fetch specific toggles](./feature-toggles-api-v2.md#get-toggle) instead.
|
||||
:::
|
||||
|
||||
`GET: http://unleash.host.com/api/admin/features/:featureName`
|
||||
|
||||
@ -119,7 +135,12 @@ Used to fetch details about a specific featureToggle. This is mostly provded to
|
||||
}
|
||||
```
|
||||
|
||||
### Create a new Feature Toggle {#create-a-new-feature-toggle}
|
||||
## Create a new Feature Toggle {#create-a-new-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to create feature toggles](./feature-toggles-api-v2.md#create-toggle) instead.
|
||||
:::
|
||||
|
||||
|
||||
`POST: http://unleash.host.com/api/admin/features/`
|
||||
|
||||
@ -150,7 +171,12 @@ Used by the admin-dashboard to create a new feature toggles.
|
||||
|
||||
Returns 200-response if the feature toggle was created successfully.
|
||||
|
||||
### Update a Feature Toggle {#update-a-feature-toggle}
|
||||
## Update a Feature Toggle {#update-a-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to update a feature toggle](./feature-toggles-api-v2.md#update-toggle) instead.
|
||||
:::
|
||||
|
||||
|
||||
`PUT: http://unleash.host.com/api/admin/features/:toggleName`
|
||||
|
||||
@ -177,7 +203,13 @@ Used by the admin dashboard to update a feature toggles. The name has to match a
|
||||
|
||||
Returns 200-response if the feature toggle was updated successfully.
|
||||
|
||||
### Tag a Feature Toggle {#tag-a-feature-toggle}
|
||||
## Tag a Feature Toggle {#tag-a-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
<!-- What is the new version for this endpoint? -->
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to tag a feature toggle](./feature-toggles-api-v2.md#fetching-toggles) instead.
|
||||
:::
|
||||
|
||||
|
||||
`POST https://unleash.host.com/api/admin/features/:featureName/tags`
|
||||
|
||||
@ -203,7 +235,13 @@ If the tuple (type, value) does not already exist, it will be added to the list
|
||||
|
||||
- Returns _404-NOT-FOUND_ if the `type` was not found
|
||||
|
||||
### Remove a tag from a Feature Toggle {#remove-a-tag-from-a-feature-toggle}
|
||||
## Remove a tag from a Feature Toggle {#remove-a-tag-from-a-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
<!-- Same as the above: how do we work with tags today? -->
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to remove tags from a toggle](./feature-toggles-api-v2.md#fetching-toggles) instead.
|
||||
:::
|
||||
|
||||
|
||||
`DELETE https://unleash.host.com/api/admin/features/:featureName/tags/:type/:value`
|
||||
|
||||
@ -218,13 +256,23 @@ Removes the specified tag from the `(type, value)` tuple from the Feature Toggle
|
||||
- Returns 404 if the tag does not exist
|
||||
- Returns 500 if the database could not be reached
|
||||
|
||||
### Archive a Feature Toggle {#archive-a-feature-toggle}
|
||||
## Archive a Feature Toggle {#archive-a-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to archive toggles](./feature-toggles-api-v2.md#archive-toggle) instead.
|
||||
:::
|
||||
|
||||
|
||||
`DELETE: http://unleash.host.com/api/admin/features/:toggleName`
|
||||
|
||||
Used to archive a feature toggle. A feature toggle can never be totally be deleted, but can be archived. This is a design decision to make sure that a old feature toggle does not suddenly reappear because someone else is re-using the same name.
|
||||
|
||||
### Enable a Feature Toggle {#enable-a-feature-toggle}
|
||||
## Enable a Feature Toggle {#enable-a-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to enable feature toggles](./feature-toggles-api-v2.md#where?) instead.
|
||||
:::
|
||||
|
||||
|
||||
`POST: http://unleash.host.com/api/admin/features/:featureName/toggle/on`
|
||||
|
||||
@ -253,7 +301,11 @@ None
|
||||
}
|
||||
```
|
||||
|
||||
### Disable a Feature Toggle {#disable-a-feature-toggle}
|
||||
## Disable a Feature Toggle {#disable-a-feature-toggle}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to disable feature toggles](./feature-toggles-api-v2.md#where?) instead.
|
||||
:::
|
||||
|
||||
`POST: http://unleash.host.com/api/admin/features/:featureName/toggle/off`
|
||||
|
||||
@ -283,7 +335,12 @@ None
|
||||
}
|
||||
```
|
||||
|
||||
### Mark a Feature Toggle as "stale" {#mark-a-feature-toggle-as-stale}
|
||||
## Mark a Feature Toggle as "stale" {#mark-a-feature-toggle-as-stale}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to patch a feature toggle and mark it as stale](./feature-toggles-api-v2.md#patch-toggle) instead.
|
||||
:::
|
||||
|
||||
|
||||
`POST: http://unleash.host.com/api/admin/features/:featureName/stale/on`
|
||||
|
||||
@ -313,7 +370,11 @@ None
|
||||
}
|
||||
```
|
||||
|
||||
### Mark a Feature Toggle as "active" {#mark-a-feature-toggle-as-active}
|
||||
## Mark a Feature Toggle as "active" {#mark-a-feature-toggle-as-active}
|
||||
|
||||
:::caution Deprecation notice
|
||||
This endpoint is deprecated. Please use the [project-based endpoint to patch a feature toggle and mark it as not stale](./feature-toggles-api-v2.md#patch-toggle) instead.
|
||||
:::
|
||||
|
||||
`POST: http://unleash.host.com/api/admin/features/:featureName/stale/off`
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user