Skip to content
/
Public Successors Bulk Up...

Public Successors Bulk Upsert

Request

Bulk-upsert successor relationships (async).

Accepts up to 100,000 rows per call. Successors are 1:1 per source article: re-sending a source with a new successor replaces the previous one. Rows whose articles don't exist are skipped (see the job's skipped_count).

Response. 202 Accepted with JobAck on the first call; 200 OK with the same JobAck on an idempotent replay. Poll GET /jobs/{job_id} for terminal status.

Idempotency. Pass an Idempotency-Key header (≤ 255 chars); the same key with a different body returns 422.

Headers
authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

Idempotency-Keystring or null(Idempotency-Key)

Optional client-supplied key for safe retries; <= 255 chars

Bodyapplication/jsonrequired
successorsArray of objects, [ 1 .. 100000 ] items(Successors)required
curl -i -X POST \
  https://docs.mercura.ai/_mock/openapi/articles/successors \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -H 'authorization: string' \
  -d '{
    "successors": [
      {
        "source_article_number": "string",
        "successor_article_number": "string",
        "order": 0
      }
    ]
  }'

Responses

Idempotent replay — same job returned

Bodyapplication/json
job_idstring(Job Id)required
Example:"4242"
status_urlstring(Status Url)required

Relative URL to poll for this job's status

Example:"/api/public/v1/jobs/4242"
Response
{
  "job_id": "4242",
  "status_url": "/api/public/v1/jobs/4242"
}