---
title: "Search Change Logs"
method: GET
path: "/v2/integrations/api-keys/change-logs"
tags: ["integrations-v2"]
---

# Search Change Logs

`GET /v2/integrations/api-keys/change-logs`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/v2/integrations/api-keys/change-logs`
- Auth: none declared

Search the integration change log (audit trail).

**Query parameters** (all optional):

| Parameter | Description |
|-----------|-------------|
| ``integration_id`` | Filter by the integration instance UUID that was changed. |
| ``organization_id`` | Scope to this org. Defaults to the caller's org. Cross-org queries require platform-admin. |
| ``user_id`` | Filter by the user who made the change. Cross-org user filters require platform-admin. |
| ``last_id`` | Cursor for pagination — only return records with id less than this. |
| ``limit`` | Maximum records to return (default 100, max 100). |

Results are ordered by ``id`` descending (newest first).

## Query parameters

- `integration_id` string, nullable
- `organization_id` string, nullable
- `user_id` string, nullable
- `last_id` integer, nullable
- `limit` integer

## Response `200`

Successful Response

- SearchChangesResponse: Paginated audit log results for the authenticated organization.
  - `changes` ChangeResponse[], required: List of change records ordered by id descending (newest first).
    - `id` integer, required: Auto-incrementing ID. Use as the cursor value for last_id on the next page.
    - `change_type` 'integrations' | 'unknown' | 'api_keys' | 'users' | 'service_accounts' | 'auth' | 'slack_channel_enrollments' | 'sessions' | 'user_agent_instructions' | 'resident_agent_templates' | 'webhook_connections' | 'usage_policies' | 'organization_logos' | 'groups' | 'chat_platform_channel_enrollments', required
    - `change_action` 'create' | 'update' | 'delete' | 'unknown' | 'login' | 'logout' | 'invite_sent' | 'invite_accepted' | 'role_granted' | 'role_revoked' | 'archive', required
    - `organization_id` string, nullable, required: UUID of the organization the changed object belongs to.
    - `user_id` string, nullable, required: UUID of the user who triggered the change, if known.
    - `object_id` string, nullable, required: UUID of the specific object that was changed.
    - `change` object, required: Structured payload describing what changed. For creates and deletes this is a full snapshot of the object. For updates this is a map of field names to {old, new} diffs.
    - `time` string, date-time, required: Timestamp of when the change was recorded (timezone-aware).
    - `user_name` string, required: Email of the user who made the change, or 'DELETED OR UNKNOWN USER' if the user no longer exists or was not set.
    - `organization_name` string, required: Display name of the organization, or 'DELETED OR UNKNOWN ORGANIZATION' if it no longer exists or was not set.

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-10-02** `53b6ebae31bc`: 1 warning
  - added the new `chat_platform_channel_enrollments` enum value to the `changes/items/change_type` response property for the response status `200`
- **2026-10-01** `0fb124422604`: 1 warning
  - added the new `groups` enum value to the `changes/items/change_type` response property for the response status `200`
- **2026-09-10** `47dcc19b4add`: 2 warning
  - added the new `service_accounts` enum value to the `changes/items/change_type` response property for the response status `200`
  - added the new `usage_policies` enum value to the `changes/items/change_type` response property for the response status `200`

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/v2/integrations/api-keys/change-logs/get.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)