> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# agentlinkops chronology pull

> Read a monitored placement's retained chronology.

Read a monitored placement's retained chronology.

This makes an authenticated read of retained history, not a new check. If using `--out`, choose a new file; an existing output is refused.

## Example

```bash theme={null}
agentlinkops chronology pull --watch-id YOUR_WATCH_ID --limit 20
```

Reads one page of retained chronology for the connected watch. It performs no new check and preserves denied streams and retention gaps.

## Options

* `--watch-id` ID required
* `--limit` 1..100 defaults to 50
* `--cursor` TOKEN
* `--all`
* `--out` FILE.

## Exit status

0 on success; 2 on usage, configuration, identity, file or request failure.

## What happens

Requires a connected cloud workspace and project. Calls the hosted read for one watch; performs no new checks.

Validates returned workspace, project and watch identity. Without `--all` returns one page; `--all` follows at most 100 pages and freezes the qualified loaded dataset.

Denied streams, retention gaps, observation time, recording time and raw evidence availability remain explicit. `--out` creates private JSON at a new path; an existing file is refused.

> **Full command syntax**
>
> ```bash theme={null}
> agentlinkops chronology pull --watch-id ID [--limit 50] [--cursor TOKEN] [--all] [--out FILE]
> ```

> **Configuration and file contracts**
>
> Read [configuration and file ownership](https://docs.agentlinkops.com/reference/local/configuration.md) for environment variables, compatibility aliases and writer locks. Read [local file contracts](https://docs.agentlinkops.com/reference/local/artifacts.md) for artifact fields. Browse the [CLI index](https://docs.agentlinkops.com/reference/local/index.md) for related commands.
>
> > [!NOTE]
> >
> > Check the selected environment and workspace access before calling hosted operations. See [capability status](https://docs.agentlinkops.com/capability-status.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.