Admin API v3¶
Active LTS
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, please refer to the upgrade guide.
New features¶
- Multi-lingual 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/pagesexport/pages | headings | heading | Page schema updated, structure changed to map of locale to heading. |
import/pagesexport/pages | paths | N/A | Page schema updated, added support fo map of locale to page paths. |
import/pagesexport/pages | additional | additional | Page schema updated, structure changed to map of locale to keywords. |
import/navigationexport/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. |
Resources¶
Downloadable utility resources.