Read citation epochs

list_citation_epochs Read saved citation epochs with sample counts, uncertainty intervals and comparison classifications. Unknown outcomes stay outside measured denominators. This reads retained rows and starts no measurement.

Available in the deployed MCP and HTTP bundle. Confirm access and inputs with your connected catalog. Workspace scopes and enabled providers still apply.

Access	Behavior
`watches:read`	Reads saved data

This read does not start a verification job.

Example request

Connect through MCP, CLI, or HTTP. Replace example identifiers with records from your workspace.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_citation_epochs",
    "arguments": {
      "projectId": "project_example"
    }
  }
}

agentlinkops call list_citation_epochs --args '{"projectId":"project_example"}'

curl "$AGENTLINKOPS_API_URL/v1/commands/list_citation_epochs" \
  -H "Authorization: Bearer $AGENTLINKOPS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"projectId":"project_example"}'

Returned result

Illustrative data validated against the documented response schema. IDs and dates are examples, not a live account capture. MCP returns this data in structuredContent and in a text content block; generic HTTP and CLI return the JSON result directly.

{
  "epochs": [],
  "cursor": null
}

Input fields

Omit optional fields when you do not want to supply them. Null is accepted only where listed. Unknown input properties are rejected.

Field	Type	Presence	Meaning and constraints
`cursor`	string	Optional	Opaque continuation returned by this same listing; omit for the first page.
`limit`	integer	Optional	Maximum rows in this page or bounded report; subject to the schema maximum. minimum: 1; maximum: 100; default: 50
`projectId`	string	Optional	Identifier of the project returned by its create or list operation. minLength: 1; maxLength: 200
`engine`	string	Optional	The engine value; allowed values and bounds are specified in this schema. maxLength: 60
`classification`	string	Optional	The classification value; allowed values and bounds are specified in this schema. maxLength: 30

Validation and omitted values

Returns retained epoch rows for accessible projects. Unknown samples do not contribute to the measured citation rate. Continue with the returned cursor and the same filters. Reading epochs starts no measurement.

Defaults when omitted

Field	Default
`limit`	`50`

Output fields

Fields inside optional or nullable parents apply only when that parent exists. Common schema conventions explain evidence states, empty lists and extensions.

epochs (array, required).
cursor (string / null, required).

All fields and nested objects

Field	Type	Presence	Meaning and constraints
`epochs`	array	Required
`epochs[].id`	string	Required	Stored epoch row identifier.
`epochs[].workspace_id`	string	Required	Workspace that owns this row.
`epochs[].project_id`	string	Required	Project that owns this row.
`epochs[].watch_id`	string	Required	Citation watch associated with this cell.
`epochs[].epoch_id`	string	Required	Source epoch identifier.
`epochs[].cell_id`	string	Required	Engine, prompt and target cell identity.
`epochs[].k`	integer	Required	Successful samples citing the target. minimum: 0; maximum: 9007199254740991
`epochs[].n`	integer	Required	Samples with a known outcome. minimum: 0; maximum: 9007199254740991
`epochs[].unknowns`	integer	Required	Samples excluded because their outcome is unknown. minimum: 0; maximum: 9007199254740991
`epochs[].rate`	number / null	Required
`epochs[].ci_low`	number / null	Required
`epochs[].ci_high`	number / null	Required
`epochs[].classification`	string	Required	Recorded epoch comparison classification.
`epochs[].at`	string	Required	Source observation time.
`cursor`	string / null	Required

Download input schema · Download output schema

Errors and retries

The command is annotated idempotent. Reuse an accepted idempotency key when the input provides one; changing the payload under a reused key can conflict. See error recovery for status, scope, cooldown, cursor and retry handling. Unknown observations are result data and do not establish loss.

HTTP resource routes

These existing resource routes share the operation’s domain behavior. Their parameter placement, status and response envelope can differ from generic invocation. See HTTP route details.

Method and route	Success	Details
`GET /v1/citation-epochs`	200	Reads current citation epoch summaries; does not start measurement.

Continue

list_citation_watches Follow the related workflow, inspect capability status, or return to the command index.

Overview

MCP, CLI and API commands

CLI client

HTTP and events

Optional local workflows

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue

​Example request

​Returned result

​Input fields

​Validation and omitted values

​Defaults when omitted

​Output fields

​Errors and retries

​HTTP resource routes

​Continue

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue