---
title: "List configuration changelog"
method: GET
path: "/api/v1/configuration_changelog"
tags: ["Configuration Changelog"]
---

# List configuration changelog

`GET /api/v1/configuration_changelog`

List configuration change history for the authenticated user's organization.

Returns paginated changelog entries sorted by `version_id` descending (most recent first). By default, the `snapshot` field is excluded for performance — use `include_snapshot=true` to include full object snapshots.

Only available to admin and organization group admin users — returns 403 otherwise.

## Query parameters

- `version_id` string
- `version_id_range_min` integer
- `version_id_range_max` integer
- `q` string
- `object_type` string
- `object_id` string
- `version_event` 'create' | 'update' | 'delete'
- `modifier_id` string
- `changed_fields` string
- `version_created_at_after` string, date-time
- `version_created_at_before` string, date-time
- `include_snapshot` boolean
- `page` integer
- `page_size` integer

## Response `200`

OK

- ConfigurationChangelogResponse
  - `results` ConfigurationChangelogEntry[], required — List of configuration changelog entries.
    - `version_id` integer, required — Unique, monotonically increasing version identifier.
    - `tenant` string, required — Tenant schema name for multi-tenant disambiguation.
    - `organization_id` integer, required — ID of the organization this change belongs to.
    - `object_type` 'hook' | 'schema' | 'queue' | 'rule' | 'email_template' | 'trigger' | 'workspace', required — Type of the configuration object that changed.
    - `object_id` integer, required — ID of the configuration object that changed.
    - `version_event` 'create' | 'update' | 'delete', required — Type of change event.
    - `version_created_at` string, date-time, required — Timestamp when the change occurred.
    - `modifier_id` integer, nullable, required — ID of the user who made the change. Null for system-initiated changes.
    - `changed_fields` string[], required — List of field names that changed in this version. Empty for `create` and `delete` events.
    - `name` string, nullable — Name of the object at the time of the change. Not present for triggers.
    - `created_at` string, date-time — Original creation timestamp of the object. Only present for hooks, rules, and workspaces.
    - `modified_at` string, date-time — Last modification timestamp of the object. Not present for triggers and workspaces.
    - `creator_id` integer, nullable — ID of the user who originally created the object. Only present for hooks, rules, and workspaces.
    - `description` string, nullable — Description of the object. Only present for hooks and rules.
    - `snapshot` object — Full snapshot of the object at this version. Only included when `include_snapshot=true` is passed. Secret fields (`secrets`, `client_ssl_key`, and `secret` inside hook `config`) are redacted with `**REDACTED**`. For private extensions, additional `config` fields hidden by the API (e.g. `code`, `url`, `runtime`) are redacted as well.
  - `pagination` Pagination, required
    - `next` string, uri, nullable — URL for the next page of results. Contains an opaque signed `cursor` query parameter. Use this URL directly to fetch the next page — do not attempt to construct or modify the cursor value.
    - `previous` string, uri, nullable — URL for the previous page of results. Contains an opaque signed `cursor` query parameter. Use this URL directly to fetch the previous page — do not attempt to construct or modify the cursor value.

## Other responses

- `400` — Invalid input data.
- `401` — The username/password is invalid or token is invalid (e.g. expired).
- `403` — The user is not an admin or organization group admin.
- `429` — Request rate is too high, wait before sending more requests. See [Rate Limiting](/guides/overview#rate-limiting) for more details.
- `500` — Server failure while processing the request.
- `502` — Invalid response from the upstream server.
- `503` — We're temporarily offline for maintenance. Please try again later.
- `504` — Upstream server could not complete the request in time.

---

[API](https://skmtc.dev/rossum/apis/rossum-api.md) · [All operations](https://skmtc.dev/rossum/apis/rossum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rossum/rossum-api/revisions/f1b5a910991d/schema)