Update Search Term

Updates an existing search term — the Edit row action on the admin Marketing → Search & SEO → Search Terms screen.

TIP

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

Operation

Operation	Type	Purpose
updateAdminMarketingSearchTerm	Mutation	Update a search term

Details

• Requires an admin Bearer token and the marketing.search_seo.search_terms.edit permission.
• Pass the term's IRI as id. The update is a partial merge — send only the fields you want to change; omitted fields keep their existing values.
• Only term and redirectUrl are editable. results and uses are recorded automatically by storefront search and cannot be changed.
• The mutation returns the full updated search-term payload.

Input fields

Field	Type	Required	Notes
id	ID	Yes	The term's IRI
term	String	Yes	The search phrase
redirectUrl	String	No	A valid URL to redirect this search to, or null to clear