Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getcitable.com/llms.txt

Use this file to discover all available pages before exploring further.

Records that a content draft has been posted by stamping the live URL and marking status='published'. This is a RECORDING — Citable does not call platform APIs to post for you. Workflow: the agent drafts → the user reviews and edits → the user posts manually on the platform → the user (or the agent on the user’s instruction) calls this with the live URL. Once stamped, the nightly attribution job picks up the post and starts tracking citation rate. Use get_attribution_report afterward to see lifetime, recent, and trajectory metrics.

When to use

  • The user has posted the content somewhere and is sharing the live URL.
  • The user wants to retroactively log a post that’s already live.

When not to use

  • The user has not yet posted the content (use schedule_content to keep it on the calendar).
  • The URL is not http or https — other schemes are rejected.

Idempotency

Re-calling with the same content_id preserves the original posted_at via COALESCE; posted_url is overwritten so typos can be corrected.

See also