---
title: "Sync citation epochs"
method: POST
path: "/v1/commands/sync_citation_epochs"
tags: ["Link monitoring and evidence"]
---

# Sync citation epochs

`POST /v1/commands/sync_citation_epochs`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/sync_citation_epochs`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

## Headers

- `X-Workspace-ID` string

## Request body

- SyncCitationEpochsInput
  - `projectId` string, required: project ID from create/list.
  - `epochs` object[], required: epochs; see schema.
    - `workspace_id` string, required
    - `project_id` string, required
    - `epoch_id` string, required
    - `cell_id` string, required
    - `k` integer, required
    - `n` integer, required
    - `unknowns` integer
    - `mentioned` integer
    - `rate` number, nullable, required
    - `ci_low` number, nullable, required
    - `ci_high` number, nullable, required
    - `classification` string, required
    - `baseline_epoch_id` string, nullable
    - `baseline_rate` number, nullable
    - `baseline_ci_low` number, nullable
    - `baseline_ci_high` number, nullable
    - `spent_estimate_usd` number
    - `at` string, required

## Response `200`

Command result, including queued admission.

- SyncCitationEpochsOutput
  - `synced` integer, required: New epoch rows stored.
  - `total` integer, required: Rows submitted, including unchanged retries.

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/2a712a1dcfa7?raw)