---
title: "Document: Automation history"
method: GET
path: "/documents/automation-timeline/{pofid}"
tags: ["Document AI — DMS"]
---

# Document: Automation history

`GET /documents/automation-timeline/{pofid}`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/documents/automation-timeline/{pofid}`
- Auth: HTTP bearer

Returns the append-only automation timeline JSON for a document (pipelines ai_dms, idp_agent, workflow). POFID in URL path must preserve case. Requires workspace view permission. Optional share_context query for shared documents.

## Path parameters

- `pofid` string, required

## Query parameters

- `share_context` string

## Response `200`

Success

- object: Automation timeline of a document
  - `status` 'ok' | 'success' | 'error': API-Status (Handler: ok; Response-Wrapper: success)
  - `pofid` string: Resolved POFID
  - `event_count` integer: Number of events in timeline.events
  - `timeline` object
    - `v` integer: Schema version (1)
    - `events` object[]: Chronological automation events
      - `at` string, date-time
      - `pipeline` 'ai_dms' | 'idp_agent' | 'workflow'
      - `status` string
      - `label` string
      - `summary` string
      - `ref` object
      - `triggered_by` string
  - `message` string: Error message when status=error

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)