Squadcast is now SolarWinds Incident Response
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Runbooks

Get All Runbooks By Team

get
/v3/runbooks

Returns all the runbooks of the team. Requires access_token as a Bearer {{token}} in the Authorization header with read scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

The request has succeeded.

application/json
get/v3/runbooks
GET /v3/runbooks HTTP/1.1
Host: api.squadcast.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "data": [
    {
      "id": "text",
      "name": "text",
      "created": {
        "user_name": "text",
        "username_for_display": "text",
        "user_id": "text",
        "at": "2026-01-01T00:00:00.000Z",
        "entity_owner": {
          "id": "text",
          "type": "text"
        }
      },
      "updated": {
        "user_name": "text",
        "username_for_display": "text",
        "user_id": "text",
        "at": "2026-01-01T00:00:00.000Z",
        "entity_owner": {
          "id": "text",
          "type": "text"
        }
      },
      "used_count": 1,
      "steps": [
        {
          "content": "text"
        }
      ],
      "entity_owner": {
        "id": "text",
        "type": "text"
      },
      "organization_id": "text",
      "owner": {
        "id": "text",
        "type": "team"
      }
    }
  ]
}

Create Runbook

post
/v3/runbooks

Add runbook to the team. Returns the runbook object in response. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

Represents the request body for creating a new runbook.

namestringRequired

The name of the runbook.

owner_idstringRequired

The ID of the team that owns this runbook.

Responses
201

The request has succeeded and a new resource has been created as a result.

application/json
post/v3/runbooks
POST /v3/runbooks HTTP/1.1
Host: api.squadcast.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "name": "text",
  "steps": [
    {
      "content": "text"
    }
  ],
  "owner_id": "text",
  "entity_owner": {
    "id": "text",
    "type": "text"
  }
}
{
  "data": {
    "id": "text",
    "name": "text",
    "created": {
      "user_name": "text",
      "username_for_display": "text",
      "user_id": "text",
      "at": "2026-01-01T00:00:00.000Z",
      "entity_owner": {
        "id": "text",
        "type": "text"
      }
    },
    "updated": {
      "user_name": "text",
      "username_for_display": "text",
      "user_id": "text",
      "at": "2026-01-01T00:00:00.000Z",
      "entity_owner": {
        "id": "text",
        "type": "text"
      }
    },
    "used_count": 1,
    "steps": [
      {
        "content": "text"
      }
    ],
    "entity_owner": {
      "id": "text",
      "type": "text"
    },
    "organization_id": "text",
    "owner": {
      "id": "text",
      "type": "team"
    }
  }
}

Get Runbook By ID

get
/v3/runbooks/{runbookID}

Returns a runbook details of the given runbookID in the request param. Requires access_token as a Bearer {{token}} in the Authorization header with read scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
runbookIDstringRequired
Responses
200

The request has succeeded.

application/json
get/v3/runbooks/{runbookID}
GET /v3/runbooks/{runbookID} HTTP/1.1
Host: api.squadcast.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "data": {
    "id": "text",
    "name": "text",
    "created": {
      "user_name": "text",
      "username_for_display": "text",
      "user_id": "text",
      "at": "2026-01-01T00:00:00.000Z",
      "entity_owner": {
        "id": "text",
        "type": "text"
      }
    },
    "updated": {
      "user_name": "text",
      "username_for_display": "text",
      "user_id": "text",
      "at": "2026-01-01T00:00:00.000Z",
      "entity_owner": {
        "id": "text",
        "type": "text"
      }
    },
    "used_count": 1,
    "steps": [
      {
        "content": "text"
      }
    ],
    "entity_owner": {
      "id": "text",
      "type": "text"
    },
    "organization_id": "text",
    "owner": {
      "id": "text",
      "type": "team"
    }
  }
}

Update Runbook

put
/v3/runbooks/{runbookID}

Update runbook details. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
runbookIDstringRequired
Body

Represents the request body for updating a runbook.

namestringRequired

The name of the runbook.

Responses
200

The request has succeeded.

application/json
put/v3/runbooks/{runbookID}
PUT /v3/runbooks/{runbookID} HTTP/1.1
Host: api.squadcast.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "name": "text",
  "steps": [
    {
      "content": "text"
    }
  ],
  "entity_owner": {
    "id": "text",
    "type": "text"
  }
}
{
  "data": {
    "id": "text",
    "name": "text",
    "created": {
      "user_name": "text",
      "username_for_display": "text",
      "user_id": "text",
      "at": "2026-01-01T00:00:00.000Z",
      "entity_owner": {
        "id": "text",
        "type": "text"
      }
    },
    "updated": {
      "user_name": "text",
      "username_for_display": "text",
      "user_id": "text",
      "at": "2026-01-01T00:00:00.000Z",
      "entity_owner": {
        "id": "text",
        "type": "text"
      }
    },
    "used_count": 1,
    "steps": [
      {
        "content": "text"
      }
    ],
    "entity_owner": {
      "id": "text",
      "type": "text"
    },
    "organization_id": "text",
    "owner": {
      "id": "text",
      "type": "team"
    }
  }
}

Remove Runbook

delete
/v3/runbooks/{runbookID}

Remove runbook from team. Requires access_token as a Bearer {{token}} in the Authorization header with user-write scope.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
runbookIDstringRequired
Responses
204

There is no content to send for this request, but the headers may be useful.

*/*
objectOptional
delete/v3/runbooks/{runbookID}
DELETE /v3/runbooks/{runbookID} HTTP/1.1
Host: api.squadcast.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{}

Last updated