Feature Flags

List feature flag change history

Changed on

Returns 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.

get/api/v2/feature-flags/history

Request

  • Base URL
    https://api.datadoghq.com
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesfeature_flag_config_read

Query parameters

start_datestring date-time
Example:2026-01-01T00:00:00Z

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.

end_datestring date-time
Example:2026-02-01T00:00:00Z

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.

teamsstring[]

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.

tagsstring[]

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.

feature_flag_idstring uuid
Example:550e8400-e29b-41d4-a716-446655440000

Only include changes to this feature flag.

environment_idstring uuid
Example:550e8400-e29b-41d4-a716-446655440001

Only include changes to this environment. Changes to the flag itself, which have no environment, are always included.

include_suggestion_eventsboolean

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.

page[limit]integer

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.

page[offset]integer

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