---
title: "get changes related to the indicated route"
method: GET
path: "/changelog/route-graph/{routeKey}"
tags: ["Audit Log"]
---

# get changes related to the indicated route

`GET /changelog/route-graph/{routeKey}`

## Request

- Base URL: `https://api.turbinelabs.io/v1.0`
- URL: `https://api.turbinelabs.io/v1.0/changelog/route-graph/{routeKey}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/turbinelabs/apis/turbine-labs-api/docs/changelog/route-graph/:routeKey/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets all changes to a route, the domains associated with it, the shared
rules it references, and the clusters connected to it.

## Path parameters

- `routeKey` string, required

## Query parameters

- `start` number
- `end` number
- `max_results` number
- `ref_id` string
- `direction` 'before' | 'after'

## Response `200`

A list of changes occurring during the requested window.

- PaginatedChangeDescriptions
  - `result` ChangeDescription[]
    - `at` number: When the change took place in milliseconds since the Unix epoch.
    - `txn` string: A unique identifier for all this transaction. It is shared by all attribute updates within a change.
    - `actor_key` string: The user who made the change.
    - `comment` string: A description of the change.
    - `diffs` ChangeEntry[]: A collection of attribute updates that compose this change.
      - `object_type` 'org' | 'user' | 'zone' | 'proxy' | 'domain' | 'route' | 'shared_rules' | 'cluster': The name of the object being being altered.
      - `change_type` 'addition' | 'removal': Whether the value was added or removed to the object.
      - `object_key` string: An ID uniquely identifying the object being changed.
      - `zone_key` string: The zone this object is located in.
      - `path` string: A dot-separated / bracket-indexed path to the field changed on the object.
      - `value` string: The value that has been added or removed to the object at the attribute path indicated in path.
  - `details` PaginationDetails
    - `pagination` PageDetails
      - `total_entries` integer: How many total entries would have been returned in the time window if it had not been paginated.
      - `has_more` boolean: Whether or not there are more entries to be requested after this page.
      - `direction` 'before' | 'after': The direction walked from the ref_id when building this page.
      - `ref_id` string: The ID used as a reference when building this page.

## Other responses

- `default`: Unexpected error

## Changes

- **2018-05-15** `2c1dca4b36f0`: 3 info
  - added the new optional `query` request parameter `direction`
  - added the new optional `query` request parameter `max_results`
  - added the new optional `query` request parameter `ref_id`
- **2017-02-06** `f370f7dbbd05`: 3 warning
  - deleted the `query` request parameter `direction`
  - deleted the `query` request parameter `max_results`
  - deleted the `query` request parameter `ref_id`

[Operation history](https://skmtc.dev/turbinelabs/apis/turbine-labs-api/changes/changelog/route-graph/:routeKey/get.md)

---

[API](https://skmtc.dev/turbinelabs/apis/turbine-labs-api.md) - [All operations](https://skmtc.dev/turbinelabs/apis/turbine-labs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/turbinelabs/apis/turbine-labs-api/revisions/47fce18aa12f?raw)