Skip to content

Mass Delete Search Terms

Deletes several search terms in one call — the Mass Delete action on the admin Marketing → Search & SEO → Search Terms datagrid.

TIP

New here? Read the Search Terms overview for what a search term is and how its fields behave.

Endpoint

EndpointMethod
/api/admin/marketing/search-terms/mass-deletePOST

Details

  • Requires an admin Bearer token and the marketing.search_seo.search_terms.delete permission.
  • Non-existent ids are silently skipped (returned in skipped); the ids actually removed are returned in deleted.
  • An empty or missing indices list returns a 422 error.

Request body

FieldTypeRequiredNotes
indicesint[]yesNon-empty list of numeric search-term ids to delete

Released under the MIT License.