List runbooks
Returns a page of runbooks — the written instructions MagicDoor follows when it handles a maintenance request on its own. The page mixes the company's own runbooks with the ones MagicDoor supplies to everybody; publicRunBook tells them apart. Requires the maintenance_runbooks:read permission.
Authorization
AuthorizationstringrequiredBearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.
Query parameters
pageintegerWhich page to return. Counting starts at 1.
default: 1
pageSizeintegerHow many runbooks to return per page. Between 1 and 100.
default: 50
titlestringOnly runbooks whose title matches.
Response
200 · One page of runbooks. This is the short row shape — call [Get a runbook](api-reference/runbooks/get-runbook) for the script and the overrides.
itemsobject[]requiredThe runbooks on this page.
totalCountintegerrequiredHow many runbooks match in total, across all pages.
totalPagesintegerrequiredHow many pages there are at this page size.
pageintegerrequiredThe page that was returned. Counting starts at 1.
pageSizeintegerrequiredHow many runbooks were asked for per page.