Redirects API reference

Reference map for Redirects API operations.

Updated
Apr 26, 2026

Redirects

Use the section that matches your caller: storefront clients use Shopper REST or Search, trusted services use Management, and signed-in customer flows use Auth. Prefer Search API for new discovery-heavy storefront work.

Use Redirects when the job is resolving old slugs or administering redirect records for catalog items.

Shopper API redirect reads resolve redirects by old slug or item ID for storefront/runtime lookup. Management API redirect operations own app-wide listing, item-scoped listing, reads by ID, creation, updates, deletion, and deleting all redirects for an item.

Use Products, Categories, Collections, or Brands when the underlying catalog record is changing. Use Redirects when preserving navigation from an old route to an existing item.

For workflow guidance across storefront redirect reads, trusted redirect administration, product relations, smart listings, static listings, Search, and events, see Redirects, relations, and listings.

Shopper API · read

Read and inspect

Management API · read, create, update, and remove

Read and inspect

OperationAPI
Get redirect by IDManagement API
List all app redirectsManagement API
List redirects for an itemManagement API

Create or attach

OperationAPI
Create a new redirectManagement API

Update or repair

OperationAPI
Update a redirectManagement API

Remove or deactivate

OperationAPI
Delete a redirectManagement API
Delete all redirects for an itemManagement API

Redirects API reference

# Redirects Use the section that matches your caller: storefront clients use Shopper REST or Search, trusted services use Management, and signed-in customer flows use Auth. Prefer Search API for new discovery-heavy storefront work. Use Redirects when the job is resolving old slugs or administering redirect records for catalog items. Shopper API redirect reads resolve redirects by old slug or item ID for storefront/runtime lookup. Management API redirect operations own app-wide listing, item-scoped listing, reads by ID, creation, updates, deletion, and deleting all redirects for an item. Use Products, Categories, Collections, or Brands when the underlying catalog record is changing. Use Redirects when preserving navigation from an old route to an existing item. For workflow guidance across storefront redirect reads, trusted redirect administration, product relations, smart listings, static listings, Search, and events, see [Redirects, relations, and listings](/start/concepts/redirects-relations-and-listings).

10 operations grouped by API, then by the job they support.

## Shopper API · read ### Read and inspect | Operation | API | | --- | --- | | [Fetch redirects](/reference/redirects/fetch-redirects) | Shopper API | | [Fetch redirects by item ID](/reference/redirects/fetch-redirects-by-item-id) | Shopper API | | [Fetch redirects by old slug](/reference/redirects/fetch-redirects-by-old-slug) | Shopper API | ## Management API · read, create, update, and remove ### Read and inspect | Operation | API | | --- | --- | | [Get redirect by ID](/reference/redirects/get-redirect-by-id) | Management API | | [List all app redirects](/reference/redirects/list-all-app-redirects) | Management API | | [List redirects for an item](/reference/redirects/list-redirects-for-an-item) | Management API | ### Create or attach | Operation | API | | --- | --- | | [Create a new redirect](/reference/redirects/create-a-new-redirect) | Management API | ### Update or repair | Operation | API | | --- | --- | | [Update a redirect](/reference/redirects/update-a-redirect) | Management API | ### Remove or deactivate | Operation | API | | --- | --- | | [Delete a redirect](/reference/redirects/delete-a-redirect) | Management API | | [Delete all redirects for an item](/reference/redirects/delete-all-redirects-for-an-item) | Management API |