---
title: "Retrieve a Revision"
method: GET
path: "/revisions/{id}"
tags: ["Revisions"]
---

# Retrieve a Revision

`GET /revisions/{id}`

Retrieve a single revision by unique identifier.

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string[]
- `meta` string

## Response `200`

Successful request

- object
  - `data` Revisions
    - `id` integer — Unique identifier for the revision.
    - `activity` union — Unique identifier for the activity record.
      - integer
      - Activity
        - `id` integer — Unique identifier for the object.
        - `action` 'create' | 'update' | 'delete' | 'login' — Action that was performed.
        - `user` union — The user who performed this action.
          - string
          - Users
            - `id` string — Unique identifier for the user.
            - `first_name` string — First name of the user.
            - `last_name` string — Last name of the user.
            - `email` string, email — Unique email address for the user.
            - `password` string — Password of the user.
            - `location` string, nullable — The user's location.
            - `title` string, nullable — The user's title.
            - `description` string, nullable — The user's description.
            - `tags` string[], nullable — The user's tags.
            - `avatar` union — The user's avatar.
              - …
            - `language` string — The user's language used in Directus.
            - `tfa_secret` string, nullable — The 2FA secret string that's used to generate one time passwords.
            - `status` 'active' | 'invited' | 'draft' | 'suspended' | 'deleted' — Status of the user.
            - `role` union — Unique identifier of the role of this user.
              - …
            - `token` string, nullable — Static token for the user.
            - `last_access` string, date-time, nullable — When this user used the API last.
            - `last_page` string, nullable — Last page that the user was on.
            - `provider` string
            - `external_identifier` string, nullable
            - `auth_data` unknown
            - `email_notifications` boolean, nullable
            - `appearance` string, nullable
            - `theme_dark` string, nullable
            - `theme_light` string, nullable
            - `theme_light_overrides` unknown
            - `theme_dark_overrides` unknown
            - `text_direction` string
            - `policies` unknown
        - `timestamp` string, date-time — When the action happened.
        - `ip` string, ipv4 — The IP address of the user at the time the action took place.
        - `user_agent` string — User agent string of the browser the user used when the action took place.
        - `collection` union — Collection identifier in which the item resides.
          - string
          - Collections
            - `collection` string — The collection key.
            - `icon` string, nullable
            - `note` string, nullable
            - `display_template` string, nullable
            - `hidden` boolean
            - `singleton` boolean
            - `translations` unknown
            - `archive_field` string, nullable
            - `archive_app_filter` boolean
            - `archive_value` string, nullable
            - `unarchive_value` string, nullable
            - `sort_field` string, nullable
            - `accountability` string, nullable
            - `color` string, nullable
            - `item_duplication_fields` unknown
            - `sort` integer, nullable
            - `group` union
              - …
            - `collapse` string
            - `preview_url` string, nullable
            - `versioning` boolean
        - `item` string — Unique identifier for the item the action applied to. This is always a string, even for integer primary keys.
        - `origin` string — Origin of the request when the action took place.
        - `revisions` union[], nullable
          - union
            - integer
            - Revisions — recursive
    - `collection` union — Collection of the updated item.
      - string
      - Collections
        - `collection` string — The collection key.
        - `icon` string, nullable
        - `note` string, nullable
        - `display_template` string, nullable
        - `hidden` boolean
        - `singleton` boolean
        - `translations` unknown
        - `archive_field` string, nullable
        - `archive_app_filter` boolean
        - `archive_value` string, nullable
        - `unarchive_value` string, nullable
        - `sort_field` string, nullable
        - `accountability` string, nullable
        - `color` string, nullable
        - `item_duplication_fields` unknown
        - `sort` integer, nullable
        - `group` union
          - string
          - Collections — recursive
        - `collapse` string
        - `preview_url` string, nullable
        - `versioning` boolean
    - `item` string — Primary key of updated item.
    - `data` object, nullable — Copy of item state at time of update.
    - `delta` object — Changes between the previous and the current revision.
    - `parent` integer, nullable — If the current item was updated relationally, this is the id of the parent revision record
    - `version` union — Associated version of this revision.
      - string
      - Versions
        - `id` string — Primary key of the Content Version.
        - `key` string — Key of the Content Version, used as the value for the "version" query parameter.
        - `name` string — Descriptive name of the Content Version.
        - `collection` union — Name of the collection the Content Version is created on.
          - string
          - Collections
            - `collection` string — The collection key.
            - `icon` string, nullable
            - `note` string, nullable
            - `display_template` string, nullable
            - `hidden` boolean
            - `singleton` boolean
            - `translations` unknown
            - `archive_field` string, nullable
            - `archive_app_filter` boolean
            - `archive_value` string, nullable
            - `unarchive_value` string, nullable
            - `sort_field` string, nullable
            - `accountability` string, nullable
            - `color` string, nullable
            - `item_duplication_fields` unknown
            - `sort` integer, nullable
            - `group` union
              - …
            - `collapse` string
            - `preview_url` string, nullable
            - `versioning` boolean
        - `item` string — The item the Content Version is created on.
        - `hash` string, nullable
        - `date_created` string, date-time, nullable — When the Content Version was created.
        - `date_updated` string, date-time, nullable — When the Content Version was last updated.
        - `user_created` union — User that created the Content Version.
          - string
          - Users
            - `id` string — Unique identifier for the user.
            - `first_name` string — First name of the user.
            - `last_name` string — Last name of the user.
            - `email` string, email — Unique email address for the user.
            - `password` string — Password of the user.
            - `location` string, nullable — The user's location.
            - `title` string, nullable — The user's title.
            - `description` string, nullable — The user's description.
            - `tags` string[], nullable — The user's tags.
            - `avatar` union — The user's avatar.
              - …
            - `language` string — The user's language used in Directus.
            - `tfa_secret` string, nullable — The 2FA secret string that's used to generate one time passwords.
            - `status` 'active' | 'invited' | 'draft' | 'suspended' | 'deleted' — Status of the user.
            - `role` union — Unique identifier of the role of this user.
              - …
            - `token` string, nullable — Static token for the user.
            - `last_access` string, date-time, nullable — When this user used the API last.
            - `last_page` string, nullable — Last page that the user was on.
            - `provider` string
            - `external_identifier` string, nullable
            - `auth_data` unknown
            - `email_notifications` boolean, nullable
            - `appearance` string, nullable
            - `theme_dark` string, nullable
            - `theme_light` string, nullable
            - `theme_light_overrides` unknown
            - `theme_dark_overrides` unknown
            - `text_direction` string
            - `policies` unknown
        - `user_updated` union — User that last updated the Content Version.
          - string
          - Users
            - `id` string — Unique identifier for the user.
            - `first_name` string — First name of the user.
            - `last_name` string — Last name of the user.
            - `email` string, email — Unique email address for the user.
            - `password` string — Password of the user.
            - `location` string, nullable — The user's location.
            - `title` string, nullable — The user's title.
            - `description` string, nullable — The user's description.
            - `tags` string[], nullable — The user's tags.
            - `avatar` union — The user's avatar.
              - …
            - `language` string — The user's language used in Directus.
            - `tfa_secret` string, nullable — The 2FA secret string that's used to generate one time passwords.
            - `status` 'active' | 'invited' | 'draft' | 'suspended' | 'deleted' — Status of the user.
            - `role` union — Unique identifier of the role of this user.
              - …
            - `token` string, nullable — Static token for the user.
            - `last_access` string, date-time, nullable — When this user used the API last.
            - `last_page` string, nullable — Last page that the user was on.
            - `provider` string
            - `external_identifier` string, nullable
            - `auth_data` unknown
            - `email_notifications` boolean, nullable
            - `appearance` string, nullable
            - `theme_dark` string, nullable
            - `theme_light` string, nullable
            - `theme_light_overrides` unknown
            - `theme_dark_overrides` unknown
            - `text_direction` string
            - `policies` unknown
        - `delta` object — The current changes compared to the main version of the item.

## Other responses

- `401` — Error: Unauthorized request
- `404` — Error: Not found.

---

[API](https://skmtc.dev/utomic-media/apis/dynamic-api-specification.md) · [All operations](https://skmtc.dev/utomic-media/apis/dynamic-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utomic-media/dynamic-api-specification/revisions/4a0ccd34700e/schema)
