Layouts
Delete Layouts
Delete layout API provides flexible options for deleting layouts, supporting both single and bulk deletion operations. You can delete layouts using multiple request formats.
Deleting a layout will automatically delete all of its nested children. This cascading deletion cannot be undone, so please review the layout's hierarchy before proceeding with deletion.
Layout deletion requires appropriate permissions. Ensure layouts are not locked at either the dashboard or organization level (organization.settings.locations.layouts.locked)
.
Delete Multiple Layouts
You can delete multiple layouts by providing their IDs through various methods:
- Request Body Array Format
The request body must contain a layouts
array and must not be empty. Otherwise it will result in a 400 error with the message "You did not provide an array of layouts".
- Query Parameter Format
When using query parameters, provide the layouts as a comma-separated list in the layouts
parameter:
Delete Single Layout
For deleting a single layout, you can use the dedicated endpoint:
Important Notes
The deletion process includes several safeguards and behaviors:
- Hierarchical Deletion: The system automatically identifies and deletes all nested layouts
- Default Layout Protection: The system prevents deletion of the location's default layout
The system automatically handles the deletion order. You do not need to delete child layouts separately.