---
title: "List recent production changes"
method: GET
path: "/api/projects/{project_id}/change_feed/"
tags: ["change_feed"]
---

# List recent production changes

`GET /api/projects/{project_id}/change_feed/`

## Request

- Base URL: `https://us.posthog.com`
- URL: `https://us.posthog.com/api/projects/{project_id}/change_feed/`
- Auth: HTTP bearer

Lists the changes that can affect production in a time window, newest first: feature flag and experiment edits, error tracking releases, and annotations. Use it to find what changed just before an error spike or a metric drop. Changes the user has no access to are left out.

## Path parameters

- `project_id` string, required

## Query parameters

- `date_from` string, date-time
- `date_to` string, date-time
- `kinds` string[]
- `limit` integer

## Response `200`

- ChangeFeed
  - `results` ChangeFeedItem[], required: Changes in the time window, newest first.
    - `kind` 'feature_flag' | 'experiment' | 'release' | 'annotation', required: * `feature_flag` - Feature flag * `experiment` - Experiment * `release` - Release * `annotation` - Annotation
    - `timestamp` string, date-time, required: When the change happened. For annotations, this is the time the annotation marks.
    - `item_id` string, required: ID of the changed object: the feature flag, experiment, release, or annotation ID.
    - `name` string, nullable, required: Display name: the flag key, experiment name, release version, or annotation text.
    - `activity` string, required: What happened, for example `created`, `updated`, `deleted`, `released`, or `annotated`.
    - `changed_fields` string[], required: For flag and experiment updates, the names of the fields that changed. Empty for other kinds.
    - `service` string, nullable, required: For releases, the project or service the release belongs to. Null for other kinds.
    - `actor_name` string, nullable, required: Name or email of the person who made the change. Null for automated changes.
  - `has_more` boolean, required: True when the window holds more changes than `limit`. Narrow the window to see the rest.

## Changes

> 52 revisions in range; 1 not diffed.

- **2026-10-20** `67a72c322d81`: 1 info
  - added the new optional `query` request parameter `kinds`
- **2026-10-14** `43c0d2b00ce0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/posthog/apis/posthog-api/changes/api/projects/:project_id/change_feed/get.md)

---

[API](https://skmtc.dev/posthog/apis/posthog-api.md) · [All operations](https://skmtc.dev/posthog/apis/posthog-api/llms.txt) · [OpenAPI document](https://skmtc.dev/posthog/apis/posthog-api/revisions/71e64193672d?raw)