REST endpoints for Admin UI SDK

Adobe Commerce provides several REST endpoints that interact with the Admin UI SDK processes. These endpoints require an admin token on PaaS systems or a token using Adobe's Identity Management System (IMS) on SaaS systems.

Mass actions without iFrames

When a mass action displayIframe parameter is set to false, you must account for additional factors.

Application failures:

Commerce expects application responses to contain the error status and message.
Commerce logs the error and displays an error banner notification to the user.

Connection interruption failures:

By default, Commerce waits 10 seconds for a response, though the extension point can customize this value. When the timeout is reached, Commerce:

Logs a 408 timeout status and error message.
Displays an error banner notification.
Sends the admin_ui_sdk_mass_action_request_failed event. The application can subscribe to this event to take action, such as rolling back updates in Commerce.

Additional details through REST API:

The GET V1/adminuisdk/massaction/<requestId> endpoint returns details of the failed request when a mass action without an iFrame fails to execute.

Headers:

Header	Value
`Authorization`	Bearer `<Token>`
`Content-Type`	application/json

Responses:

200: Successful response with the following response payload:

{
    "id": Unique internal ID,
    "request_id": Request ID,
    "action_id": Mass Action ID that failed,
    "grid_type": Grid type: product, order or customer,
    "error_status": Error Status,
    "error_message": Error Message,
    "request_timestamp": Timestamp,
    "selected_ids": Array of selected IDs in the grid
}
Copied to your clipboard
{
    "id": Unique internal ID,
    "request_id": Request ID,
    "action_id": Mass Action ID that failed,
    "grid_type": Grid type: product, order or customer,
    "error_status": Error Status,
    "error_message": Error Message,
    "request_timestamp": Timestamp,
    "selected_ids": Array of selected IDs in the grid
}

Example usage:

curl -X GET \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <TOKEN>" \
    '<ADOBE_COMMERCE_URL>/rest/V1/adminuisdk/massaction/<REQUEST_ID>'
Copied to your clipboard
curl -X GET \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <TOKEN>" \
    '<ADOBE_COMMERCE_URL>/rest/V1/adminuisdk/massaction/<REQUEST_ID>'

Recommendations:

Use bulk update in Commerce to avoid inconsistency issues in case of failures.
Event and REST API responses contain the list of selected IDs for a request. It is the application's responsibility to monitor updates or failures in Commerce.

Order view button without iFrames

When an order view button displayIframe parameter is set to false, you must account for additional factors.

Application failures:

Commerce expects application responses to contain the error status and message.
Commerce logs the error and displays an error banner notification to the user.

Connection interruption failures:

By default, Commerce waits 10 seconds for a response, though the extension point can customize this value. When the timeout is reached, Commerce:

Logs a 408 timeout status and error message.
Displays an error banner notification.
Sends the admin_ui_sdk_order_view_button_request_failed event. The application can subscribe to this event to take action, such as rolling back updates in Commerce.

Additional details through REST API:

The GET V1/adminuisdk/orderviewbutton/<requestId> endpoint returns details of the failed request when an order view button without iFrame fails to execute.

Headers:

Header	Value
`Authorization`	Bearer `<Token>`
`Content-Type`	application/json

Responses:

200: Successful response with the following response payload:

{
    "id": Unique internal ID,
    "request_id": Request ID,
    "button_id": Button ID that failed,
    "order_id": Order ID that failed,
    "error_status": Error Status,
    "error_message": Error Message,
    "request_timestamp": Timestamp
}
Copied to your clipboard
{
    "id": Unique internal ID,
    "request_id": Request ID,
    "button_id": Button ID that failed,
    "order_id": Order ID that failed,
    "error_status": Error Status,
    "error_message": Error Message,
    "request_timestamp": Timestamp
}

Example usage:

curl -X GET \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <TOKEN>" \
    '<ADOBE_COMMERCE_URL>/rest/V1/adminuisdk/orderviewbutton/<REQUEST_ID>'
Copied to your clipboard
curl -X GET \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <TOKEN>" \
    '<ADOBE_COMMERCE_URL>/rest/V1/adminuisdk/orderviewbutton/<REQUEST_ID>'