MagicDoorAPI
SupportOpen MagicDoor
Runbooks

Delete a runbook

Deletes one of the company's own runbooks. A runbook MagicDoor supplies cannot be deleted and is reported as not found — switch it off instead with Disable a runbook. Requires the maintenance_runbooks:delete permission.

DELETE
https://services.magicdoor.com/maintenance/company-portal/run-books/{runBookId}

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

runBookIdstringrequired

The runbook to act on. A Snowflake id, sent as a decimal string.

example: 1827400938471029248

Response

200 · The runbook was deleted. The response has no body.

401 · The request carried no valid access token.

403 · The token is not a property manager token, or it lacks the `maintenance_runbooks:delete` permission.

404 · No such runbook, it belongs to another company, or it is one MagicDoor supplies rather than one of yours.