MarBoba

Runbooks REST endpoints

Generated

5 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