Skip to content

Soft-deleting articles

Set is_deleted: true on an article in a POST /articles payload to hide it everywhere in Mercura — it stops appearing in catalogue search, AI matching suggestions, and selection candidates. The row is kept (not destroyed), so any offer position that already selected the article in the past still shows it. Set is_deleted: false to restore the article. Omitting the field leaves the current value unchanged.

Soft-deleted articles are excluded from GET /articles by default; pass include_deleted=true to list them (for example, to confirm a delete or find one to restore). GET /articles/{article_number} always returns the article, including its is_deleted state.