Overview

Admin v3 API will remain in Active Long Term Support until 2026-12-31, after which it will reach End of Life. For information on upgrading to Admin v4, see the upgrade guide.

New features

Multilingual support for markets
Long-running imports

Changes

This section lists changes from API 2 that must be considered when upgrading. The listed changes are limited to the resources found in the Admin API; changes related to Queries and unauthorized Notifications are found in the Storefront API.

Endpoints	New value	Previous value	Description
All	`/api/admin/v{major}/{resource}`	`/api/v{1-2}/{resource}`	Path pattern changed.
`import/pages` `export/pages`	`headings`	`heading`	Page schema updated, structure changed to map of locale to heading.
`import/pages` `export/pages`	`paths`	N/A	Page schema updated, added support for map of locale to page paths.
`import/pages` `export/pages`	`additional`	`additional`	Page schema updated, structure changed to map of locale to keywords.
`import/navigation` `export/navigation`	`locale`	N/A	Navigation schema updated, added required locale.
`import/data`	`202` after timeout	Error after timeout	Response updated, supporting long-running imports.
`import/data`	`blockingTimeout`	N/A	Optional query parameter added.
`import/status`	New endpoint	N/A	Supports status for long-running imports.

Admin

Storefront

Overview

New features

Changes

Resources

Endpoints

Event data

Export

Import

Notifications

Status

​New features

​Changes

​Resources

​Endpoints

​Event data

​Export

​Import

​Notifications

​Status

New features

Changes

Resources

Endpoints

Event data

Export

Import

Notifications

Status