Publish content

Send, test, withdraw or split articles

Send up to 100 articles per request; sending the same url again updates it. Required per article: title, url, html_body (up to 200,000 characters). Every article gets a result: created, updated, unchanged or failed. Add ?validate=true to test without saving. Other actions in the same endpoint: {"action": "revoke", "reason": "voluntary" | "rights", "urls": […]} withdraws articles: voluntary stops selling them (buyers who already paid keep access until their licence ends); rights is for a rights problem (every licensed buyer fetching them gets 410 CONTENT_REVOKED and must delete copies within 30 days). reason is required and {"action": "chunk", "urls": […]} splits them into sections. Send an Idempotency-Key header to retry safely. 60 writes and 300 test runs per hour per key. See the publisher guide.

post/publishers-content

Request

  • Base URL: https://api.opedd.com
  • URL: https://api.opedd.com/publishers-content
  • Auth: HTTP bearer

Query parameters

validateboolean

true → dry run: validate + extraction preview, no write. Same as dry_run: true in the body.

Headers

Idempotency-Keystring
X-Request-Idstring

Request body

dry_runboolean

Validate and preview without writing (same as ?validate=true).

action'upsert' | 'revoke' | 'chunk'

Leave out to send articles. revoke withdraws the articles in urls (with reason); chunk splits them into sections.

urlsstring[]

For revoke and chunk: the article URLs to act on (yours only).

reason'voluntary' | 'rights'

Required with revoke. voluntary: stop selling; paid buyers keep access until their licence ends. rights: withdraw because of a rights problem; every buyer gets 410 and a 30-day deletion deadline.

Response

Articles sent: each has its own result; failures are listed in data.errors without failing the rest. For revoke, see the examples.

successtrue required
request_idstring

Echoed from request X-Request-Id header or server-generated.

Changes

No recorded changes to this operation across all 1 revision of this API.