> ## Documentation Index > Fetch the complete documentation index at: https://www.towbar.dev/llms.txt > Use this file to discover all available pages before exploring further. # List workspace Scout incidents > List workspace Scout incidents through the Towbar REST API. Required permissions: alert.read. Personal keys are capped by their owner’s current team role. See [request conventions](/docs/api/overview) and [automation workflows](/docs/api/workflows). MCP clients use the task-oriented [tool catalogue](/docs/api/mcp-tools). ## OpenAPI ````yaml api-reference/openapi.json GET /monitoring/incidents openapi: 3.1.0 info: title: Towbar API version: 2.0.0 description: >- Manage your Towbar control plane with a bearer API key. Keys inherit current workspace permissions. servers: - url: https://api.example.com/v1/api security: [] paths: /monitoring/incidents: get: tags: - Workspace / Monitoring summary: List workspace Scout incidents description: >- Required permissions: alert.read. Personal keys are capped by the current member role; team keys use explicit grants. operationId: get_monitoring_incidents parameters: - name: state in: query required: false schema: default: active type: string enum: - active - resolved - name: severity in: query required: false schema: default: all type: string enum: - all - critical - warning - name: before in: query required: false schema: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - name: beforeId in: query required: false schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - name: limit in: query required: false schema: default: 20 type: integer minimum: 1 maximum: 50 responses: '200': description: >- Paginated active and resolved incidents across the current workspace. Inspect details through the server incident route. content: application/json: schema: allOf: - $ref: '#/components/schemas/Response_49' - type: object properties: localization: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: dateFormat: type: string enum: - day-short-month-year - short-month-day-year - year-month-day - day-month-year - month-day-year timeFormat: type: string enum: - 24-hour - 12-hour - 24-hour-seconds - 12-hour-seconds timeZone: type: string timestamps: type: object propertyNames: type: string additionalProperties: type: object properties: date: type: string time: type: - string - 'null' dateTime: type: - string - 'null' timeZone: type: string zoneLabel: type: string epochMilliseconds: type: number inputDateTime: type: - string - 'null' required: - date - time - dateTime - timeZone - zoneLabel - epochMilliseconds - inputDateTime additionalProperties: false required: - dateFormat - timeFormat - timeZone - timestamps additionalProperties: false required: - localization '400': $ref: '#/components/responses/ApiError' '401': $ref: '#/components/responses/ApiError' '403': $ref: '#/components/responses/ApiError' '404': $ref: '#/components/responses/ApiError' '409': $ref: '#/components/responses/ApiError' '413': $ref: '#/components/responses/ApiError' '422': $ref: '#/components/responses/ApiError' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/ApiError' security: - bearerAuth: [] components: schemas: Response_49: type: object properties: items: type: array items: $ref: '#/components/schemas/Response_50' nextBefore: anyOf: - type: 'null' - type: string nextBeforeId: anyOf: - type: 'null' - type: string required: - items - nextBefore - nextBeforeId Response_50: type: object properties: incident: $ref: '#/components/schemas/Response_51' workload: $ref: '#/components/schemas/Response_54' serverName: type: string required: - incident - workload - serverName Response_51: type: object properties: id: type: string ruleId: type: string workspaceId: type: string serverId: type: string deployableId: anyOf: - type: 'null' - type: string environment: anyOf: - type: 'null' - type: string ruleRevision: anyOf: - type: 'null' - type: string format: date-time ruleName: type: string severity: type: string condition: $ref: '#/components/schemas/Response_52' openedAt: type: string format: date-time conditionStartedAt: type: string format: date-time resolvedAt: anyOf: - type: 'null' - type: string format: date-time resolutionReason: anyOf: - type: 'null' - type: string lastValue: anyOf: - type: 'null' - type: number lastNotifiedAt: anyOf: - type: 'null' - type: string format: date-time notificationSequence: type: number required: - id - ruleId - workspaceId - serverId - deployableId - environment - ruleRevision - ruleName - severity - condition - openedAt - conditionStartedAt - resolvedAt - resolutionReason - lastValue - lastNotifiedAt - notificationSequence Response_54: type: object properties: name: anyOf: - type: 'null' - type: string environmentName: anyOf: - type: 'null' - type: string kind: anyOf: - type: 'null' - type: string const: app - type: string const: compose - type: string const: image - type: string const: postgres - type: string const: mysql - type: string const: mariadb - type: string const: mongodb - type: string const: redis - type: string const: dragonfly - type: string const: keydb - type: string const: clickhouse sourceId: anyOf: - type: 'null' - type: string archivedAt: anyOf: - type: 'null' - type: string format: date-time required: - name - environmentName - kind - sourceId - archivedAt Response_52: type: object properties: metric: anyOf: - type: string const: cpuPercent - type: string const: cpuCores - type: string const: cpuLimitCores - type: string const: memoryUsedBytes - type: string const: memoryTotalBytes - type: string const: memoryLimitBytes - type: string const: memoryPercent - type: string const: swapUsedBytes - type: string const: swapTotalBytes - type: string const: diskTotalBytes - type: string const: diskUsedBytes - type: string const: diskPercent - type: string const: dockerDiskTotalBytes - type: string const: dockerDiskUsedBytes - type: string const: dockerDiskPercent - type: string const: diskReadBytesPerSecond - type: string const: diskWriteBytesPerSecond - type: string const: networkRxBytesPerSecond - type: string const: networkTxBytesPerSecond - type: string const: uptimeSeconds - type: string const: load1 - type: string const: load5 - type: string const: load15 - type: string const: restarts - type: string const: missingReports - type: string const: httpAvailability operator: anyOf: - type: string const: above - type: string const: below threshold: type: number windowSeconds: type: number aggregation: anyOf: - type: string const: average - type: string const: peak http: $ref: '#/components/schemas/Response_53' required: - metric - operator - threshold - windowSeconds - aggregation Response_53: type: object properties: url: type: string method: anyOf: - type: string const: GET - type: string const: HEAD intervalSeconds: type: number timeoutSeconds: type: number expectedStatusMin: type: number expectedStatusMax: type: number maxRedirects: type: number required: - url - method - intervalSeconds - timeoutSeconds - expectedStatusMin - expectedStatusMax - maxRedirects responses: ApiError: description: Request failed. The error object contains code, message, and requestId. content: application/json: schema: type: object properties: error: type: object required: - code - message - requestId properties: code: type: string message: type: string requestId: type: string RateLimited: description: Request failed. The error object contains code, message, and requestId. content: application/json: schema: type: object properties: error: type: object required: - code - message - requestId properties: code: type: string message: type: string requestId: type: string headers: Retry-After: description: Seconds before retrying schema: type: integer securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Towbar API key ````