> ## Documentation Index
> Fetch the complete documentation index at: https://product-discovery.developer.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Admin API specification for version 4.

Welcome to version 4 of the Admin API.

This update brings significant changes aimed at enhancing the product feed experience with our platform. The main focus of this update is a comprehensive redesign of the data feed format, resulting in significant changes to import and export endpoints. Additionally, new endpoints have been introduced to support explicit market configuration of the Elevate server.

Two significant data feed format changes have occurred: firstly, the syntax has transitioned from XML to JSON lines. Secondly, the focus of entity modeling has shifted from markets and locales to product groups and content as the primary import entities. This shift ensures cross-market product selection stability and enables future cross-market behavioral data sharing. Previously, each market required importing individual products. Now, product groups and content are imported once and support overrides as needed.

An introductory overview of the new catalog format can be found in the [Catalog imports](/elevate/docs/integration/catalog-imports/catalog-imports) section and its subsections. For detailed guidance on upgrading to Admin v4 from Admin v3, see the [upgrade guide](/elevate/docs/api/admin/v4/v4-upgrade).

## New features

### Data format features

* Modernized data feed format using JSON lines instead of XML.
* Greatly reduced import size for imports with overlapping localization and market data.
* Updated data modeling to ensure cross-market product selection stability and enable future cross-market behavioral data sharing.
* Introduced support for shared default values for products, variants, and content.
* Introduced support for shared locale-specific overrides for products, variants, and content.
* Introduced support for shared market-specific overrides for products, variants, and content.
* Introduced a new entity `translation`, supporting separated, consistent, and stable ID to name relations for facet and filter attributes.
* Added support for adding a product to product groups without having to replace the entire product group.
* Added support for adding a variant to a product without having to replace the entire product group.
* Introduced support for image IDs, supporting standalone updates and additions.
* Added new predefined attribute `gender`, supporting faceting and filtering, and utilized by classification.
* Added new predefined attribute `age`, supporting faceting and filtering, and utilized by classification.
* Added new predefined attribute `ontology`, enabling a broader set of values for the predefined attribute `category` to be used for filters and selections.
* Added support for `customJson` fields, supporting custom JSON data with format preservation in query responses.

### Elevate configuration features

* Added an API endpoint `configuration`, allowing stronger market control and enabling market and locale definition modifications independent of the data feed.
* Introduced support for defining market and locale support without requiring a data feed import.
* Introduced support for deleting all Elevate server market data, including merchandising settings such as promotions and benchmarks.

### Other features

* Introduced structured error messages with error details in JSON format, enabling further automated error handling.
* Introduced an OpenAPI Specification for the data format.
* Introduced a new endpoint, [Product Information](/elevate/docs/api/storefront/v3/utilities/product-information), in Storefront v3 for fetching product information, replacing the previous `admin/v3/export/product-groups` endpoint.

## Changes

This section lists changes that must be considered when upgrading from Admin v3 to Admin v4.

The listed changes are limited to the resources found in the Admin API and are unrelated to changes and versions of the [Storefront API](/elevate/docs/api/storefront/overview).

| Endpoints                | New value                  | Previous value             | Description                                                                                       |
| ------------------------ | -------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------- |
| **All**                  | `/api/admin/v4/{resource}` | `/api/admin/v3/{resource}` | New version in path for all admin endpoints.                                                      |
| `import/data`            | Endpoint removed           | Supported endpoint         | Functionality replaced by catalog imports.                                                        |
| `export/data`            | Endpoint removed           | Supported endpoint         | Functionality replaced by catalog exports.                                                        |
| `export/product-groups`  | Endpoint removed           | Supported endpoint         | Functionality replaced by product-information in Storefront v3. Catalog exports can also be used. |
| `import/catalog`         | New endpoint               | N/A                        | New endpoint for catalog data imports, with new data feed format.                                 |
| `export/catalog`         | New endpoint               | N/A                        | New endpoint for catalog data exports, with new data feed format.                                 |
| `export/upgrade-catalog` | New endpoint               | N/A                        | New endpoint for producing a catalog import draft according to the new data feed format.          |
| `import/configuration`   | New endpoint               | N/A                        | New endpoint for modifying the Elevate configuration.                                             |
| `export/configuration`   | New endpoint               | N/A                        | New endpoint for exporting the Elevate configuration.                                             |

## Resources

Downloadable [utility resources](/elevate/docs/api/getting-started#utility-resources).

* [Postman Collection](https://cdn.esales.apptus.com/open-api/postman/admin-v4-collection.json) <Icon icon="download" size={14} />
* [OpenAPI Specification](https://cdn.esales.apptus.com/open-api/specifications/admin-v4.json) <Icon icon="download" size={14} />

## Endpoints

### Event data

* [Create export customer job](/elevate/docs/api/admin/v4/event-data/create-export-customer-job)
* [Create remove customer job](/elevate/docs/api/admin/v4/event-data/create-remove-customer-job)
* [Export customer job result](/elevate/docs/api/admin/v4/event-data/export-customer-job-result)
* [Job status](/elevate/docs/api/admin/v4/event-data/job-status)

### Export

* [Catalog](/elevate/docs/api/admin/v4/export/catalog)
* [Configuration](/elevate/docs/api/admin/v4/export/configuration)
* [Navigation](/elevate/docs/api/admin/v4/export/navigation)
* [Pages](/elevate/docs/api/admin/v4/export/pages)
* [Product sets](/elevate/docs/api/admin/v4/export/product-sets)
* [Templates](/elevate/docs/api/admin/v4/export/templates)
* [Upgrade catalog](/elevate/docs/api/admin/v4/export/upgrade-catalog)

### Import

* [Catalog](/elevate/docs/api/admin/v4/import/catalog)
* [Configuration](/elevate/docs/api/admin/v4/import/configuration)
* [Navigation](/elevate/docs/api/admin/v4/import/navigation)
* [Pages](/elevate/docs/api/admin/v4/import/pages)
* [Product sets](/elevate/docs/api/admin/v4/import/product-sets)
* [Status](/elevate/docs/api/admin/v4/import/status)
* [Templates](/elevate/docs/api/admin/v4/import/templates)

### Notifications

* [Latest](/elevate/docs/api/admin/v4/notifications/latest)
* [Payment](/elevate/docs/api/admin/v4/notifications/payment)

### Status

* [Status](/elevate/docs/api/admin/v4/status)