Deleted Resources
Deleted resources are usually still accessible after deletion in redacted mode:
- The deleted resource will not be returned in any list request.
- If the resource is requested specifically, it will be returned but will only contain the
id,object, and an additionaldeletedfield with the value oftrue.
For example, a call to
GET /booking-calendars/BKC-X0LCRU5LESWill return the object in redacted mode:
{ "id": "BKC-X0LCRU5LES", "object": "booking_calendar", "deleted": true}However, BKC-X0LCRU5LES booking calendar will not be returned when listing all booking calendars via
GET /booking-calendarsDeleted Resources in Expansions
Section titled “Deleted Resources in Expansions”The same is true for expanded responses. When expanded, deleted objects will return in redacted mode as well.
This behavior ensures that your application can gracefully handle references to deleted resources without breaking, while still providing feedback that the resource has been deleted.