Mark Content as Published
Mark a content item as published at its live URL so Athena starts attributing citations and mentions to it. Call this only after the piece is actually live on the site: the URL becomes the item’s citation/metric join key, the publish time is stamped, and the pipeline stage moves to done. A first publish requires a finished article (stage generated): briefs, still-generating or failed pieces, and items with a scheduled CMS publish are rejected with 409 and the reason. Pass the exact public URL of the live page (a bare domain path like acme.com/blog/post is fine; the protocol is stripped on store). Calling it again on an already-published item (including external and imported pages, which are live by definition) updates the tracked URL only, keeping the original publish time. This is the only way to set a content URL over the API: the rename endpoint is deliberately title-only.