List feature flag change history
Changed onReturns the organization's feature flag change events, newest first. Each event includes a readable description of the change. All filters are optional, and events must match every filter you set. Without a date range, the whole history is listed. Results are paginated with page[limit] and page[offset]; follow links.next to read further back.
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/tokenScopesfeature_flag_config_read
Query parameters
Only include changes made after this time, for example 2026-01-01T00:00:00Z. The bound is exclusive, so a change made exactly at this time is not included. Omit for no lower bound.
Only include changes made before this time, for example 2026-02-01T00:00:00Z. The bound is exclusive, so a change made exactly at this time is not included. Omit for no upper bound. Must be after start_date when both are set.
Only include changes to flags that belong to at least one of these teams. Use team handles without the team: prefix, as repeated parameters, such as teams=checkout&teams=payments. Handles from teams and team:<handle> values from tags are treated as one set. Handles that are empty, have surrounding white space, or include the team: prefix return a 400 Bad Request error.
Only include changes to flags that have all of these exact tags, as repeated parameters, such as tags=env:prod&tags=tier:1. Values of the form team:<handle> match any selected team and are combined with teams. Empty values are ignored.
Only include changes to this feature flag.
Only include changes to this environment. Changes to the flag itself, which have no environment, are always included.
Also include review events for change requests that needed approval: rejected requests and requests still pending review. Applies only to organizations with flag approvals enabled.
Maximum number of events to return. Defaults to 25. Values above 50 return 50 events. Non-positive or empty values use the default. A non-integer value returns a 400 Bad Request error.
Number of matching events to skip before returning results. Defaults to 0. Negative or empty values are set to 0. A non-integer value returns a 400 Bad Request error.
Response
OK
Example response
{
"data": [
{
"attributes": {
"action": "updated",
"change_metadata": "{\"variant_key\": \"control\"}",
"creation_source": "UI",
"description": "Changed flag name from \"Mobile Feature Rollout\" to \"Mobile Feature Toggle\".",
"environment": {
"id": "550e8400-e29b-41d4-a716-446655440001",
"is_production": true,
"name": "Production"
},
"feature_flag": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"key": "mobile-feature-toggle",
"name": "Mobile Feature Toggle"
},
"new_value": "Mobile Feature Toggle",
"previous_value": "Mobile Feature Rollout",
"property": "FLAG_NAME",
"suggestion_review": {
"lifecycle_status": "rejected",
"requester_comment": "Ready for production.",
"reviewer_comment": "Roll out to staging first.",
"status": "rejected",
"suggestion_created_by": "00000000-0000-0000-0000-000000000001"
},
"timestamp": "2023-10-02T14:30:00Z",
"user_id": "00000000-0000-0000-0000-000000000001",
"version_number": 3
},
"id": "550e8400-e29b-41d4-a716-446655440005",
"type": "change-events"
}
],
"links": {
"first": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25&page%5Boffset%5D=0",
"last": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25&page%5Boffset%5D=75",
"next": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25&page%5Boffset%5D=25",
"prev": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25&page%5Boffset%5D=0",
"self": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25&page%5Boffset%5D=0"
},
"meta": {
"page": {
"last_offset": 75,
"limit": 25,
"next_offset": 25,
"total": 100,
"type": "offset_limit"
}
}
}Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info