Runbooks REST endpoints
Generated5 endpoints under `/v1`.
Auto-generated from the MarBoba OpenAPI spec, published at
api.marboba.com/v1/openapi.json.
GET /runbooks
List runbooks
Responses
- 200 — All non-deleted runbooks in the calling token’s org. Body: object
- 401 — . Body: (no body)
Auth: BearerPAT
Operation ID: get_runbooks
POST /runbooks
Create a runbook
Request body
Request body (application/json): RunbookInput
Responses
- 201 — Created. Body: object
- 400 — . Body: (no body)
- 401 — . Body: (no body)
Auth: BearerPAT
Operation ID: post_runbooks
DELETE /runbooks/{runbookId}
Soft-delete a runbook
Sets isDeleted=true rather than hard-deleting so historical references in incidents and the Activity feed survive. Requires admin scope (PAT only).
Responses
- 204 — Soft-deleted. Body: (no body)
- 403 — . Body: (no body)
- 404 — . Body: (no body)
Auth: BearerPAT
Operation ID: delete_runbooks-runbookid
GET /runbooks/{runbookId}
Get a runbook by id
Responses
- 200 — The requested runbook. Body: object
- 404 — . Body: (no body)
Auth: BearerPAT
Operation ID: get_runbooks-runbookid
PATCH /runbooks/{runbookId}
Update a runbook
Request body
Request body (application/json): RunbookInput
Responses
- 200 — Updated. Body: object
- 403 — . Body: (no body)
- 404 — . Body: (no body)
Auth: BearerPAT
Operation ID: patch_runbooks-runbookid