Skip to content

Successors

Successors mark the article that replaces a discontinued one (source_article_number → successor_article_number). Pushing them lets Mercura retarget demand for a phased-out article onto its current replacement.

You can:

  • POST /articles/successors — bulk-upsert up to 100,000 successor links in a single call. Async — returns a JobAck; poll GET /jobs/{job_id} for status.
  • GET /articles/successors — cursor-paginated list of your successor links. Pass source_article_number to look up one article's successor, or modified_since on the first page to fetch only what changed.
Operations

One successor per article

A source article has exactly one active successor. Re-sending a source article with a different successor_article_number replaces the previous successor — this is the intended way to update a chain. order is accepted for parity with the other relations but has no effect on a 1:1 link.