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/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 fo 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. |
Resources¶
Downloadable utility resources.