# Get entity version history

Returns the version history for a specific entity instance.

        Shows all historical states with timestamps, change authors, and
        field-level diffs between versions.

        If X-Workspace-Id header is provided, includes workspace draft
        changes merged with mainline history. Workspace drafts appear
        alongside mainline states (not replacing them).

Endpoint: GET /v1/{entity_type}/{entity_id}/history/
Version: 1.0.0
Security: tokenAuth

## Header parameters:

  - `X-Workspace-Id` (string)
    Optional workspace UUID to include draft changes

## Path parameters:

  - `entity_id` (string, required)
    UUID of the entity

  - `entity_type` (string, required)
    Entity type: operation, task, resource, location, rule, tag
    Enum: "location", "operation", "resource", "rule", "tag", "task"

## Query parameters:

  - `include_diffs` (boolean)
    Include field-level diffs (default true)

  - `limit` (integer)
    Maximum number of versions to return (default 50, max 200)

  - `offset` (integer)
    Pagination offset

## Response 200 fields (application/json):

  - `entityId` (string, required)

  - `entityType` (string, required)

  - `workspace` (string,null, required)

  - `total` (integer, required)

  - `versions` (array, required)

  - `versions.label` (string, required)

  - `versions.stateId` (string, required)

  - `versions.changeId` (string,null)

  - `versions.changeType` (string, required)

  - `versions.before` (any, required)

  - `versions.after` (any, required)

  - `versions.changes` (array, required)

  - `versions.changes.field` (string, required)

  - `versions.source` (any)

  - `versions.validFrom` (string,null)

  - `versions.validTo` (string,null)

  - `versions.closedByChangeId` (string,null)

  - `versions.createdBy` (any)

## Response 400 fields (application/json):

  - `detail` (string, required)

## Response 404 fields (application/json):

  - `detail` (string, required)

## Response 500 fields (application/json):

  - `detail` (string, required)


## Response 401 fields

## Response 403 fields