{
  "openapi": "3.1.1",
  "info": {
    "title": "ContraForce API",
    "description": "ContraForce platform API for security operations management.",
    "version": "2.0"
  },
  "paths": {
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/{incidentId}": {
      "get": {
        "tags": [
          "Incidents"
        ],
        "summary": "Get incident by id",
        "operationId": "v2-get-incident-by-id",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfContraForceIncident"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/{incidentId}/evidence": {
      "get": {
        "tags": [
          "Incidents"
        ],
        "summary": "Get incident evidence",
        "operationId": "v2-get-incident-evidence",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfGeneralTableDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/{incidentId}/last-gamebook": {
      "get": {
        "tags": [
          "Incidents"
        ],
        "summary": "Get incident last gamebook",
        "operationId": "v2-get-incident-last-gamebook",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfGamebookDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/by-entity": {
      "get": {
        "tags": [
          "Incidents"
        ],
        "summary": "Get incidents by entity",
        "operationId": "v2-get-incidents-by-entity",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "IncidentId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityKind",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityFilter",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "TimeFilteringType",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/TimeFilteringType"
            }
          },
          {
            "name": "StartDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EndDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EntityName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityType",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/EntityType"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIncidentsByEntityResultDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/{incidentId}/status": {
      "put": {
        "tags": [
          "Incidents"
        ],
        "summary": "Update incident status",
        "operationId": "v2-update-incident-status",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateIncidentStatusRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/{incidentId}/assignee": {
      "put": {
        "tags": [
          "Incidents"
        ],
        "summary": "Assign incident",
        "operationId": "v2-assign-incident",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssignIncidentRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/{incidentId}/comments": {
      "get": {
        "tags": [
          "Incidents"
        ],
        "summary": "Get incident comments",
        "operationId": "v2-get-incident-comments",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfIncidentCommentDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Incidents"
        ],
        "summary": "Create incident comment",
        "operationId": "v2-create-incident-comment",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateIncidentCommentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIncidentCommentDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/{source}/{incidentId}/comments/{commentId}": {
      "put": {
        "tags": [
          "Incidents"
        ],
        "summary": "Update incident comment",
        "operationId": "v2-update-incident-comment",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "commentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateIncidentCommentRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Incidents"
        ],
        "summary": "Delete incident comment",
        "operationId": "v2-delete-incident-comment",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "commentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "extensionId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/incidents/ingest": {
      "post": {
        "tags": [
          "Incidents"
        ],
        "summary": "Ingest incident",
        "operationId": "v2-ingest-incident",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IngestIncidentRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted"
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "413": {
            "description": "Payload Too Large",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/gamebooks/rules/{incidentTitle}": {
      "get": {
        "tags": [
          "Gamebooks"
        ],
        "summary": "Get playbooks by incident title",
        "operationId": "v2-get-playbooks-by-incident-title",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "incidentTitle",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfPlaybookMetadataDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/gamebooks/history": {
      "get": {
        "tags": [
          "Gamebooks"
        ],
        "summary": "List gamebooks history",
        "operationId": "v2-list-gamebooks-history",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageToken",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfListGamebooksResultDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/gamebooks/history/{gamebookId}/playbooks": {
      "get": {
        "tags": [
          "Gamebooks"
        ],
        "summary": "Get playbooks by gamebook id",
        "operationId": "v2-get-playbooks-by-gamebook-id",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "gamebookId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfPlaybookGameplanDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/gamebooks/by-incident/{incidentId}": {
      "get": {
        "tags": [
          "Gamebooks"
        ],
        "summary": "List incident gamebooks",
        "operationId": "v2-list-incident-gamebooks",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "withUserDetails",
            "in": "query",
            "required": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfGamebookDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/gamebooks/run": {
      "post": {
        "tags": [
          "Gamebooks"
        ],
        "summary": "Run a gamebook",
        "description": "Requires gamebooks:execute and access to the route workspace. Service accounts may submit new gamebooks only: only documented inputs are accepted; portal approval, retry, and internal state fields are rejected. Playbook sequence values must contain exactly 1..N without duplicates or gaps. Workspace policies and partner approval settings apply. A 200 response with isQueued=true and status=Pending means the plan awaits portal approval; it has not executed. Use gamebooks:read to poll history. Service accounts cannot approve, retry, deny, or cancel gamebooks.",
        "operationId": "v2-run-gamebook",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RunGamebookRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "415": {
            "description": "Unsupported Media Type",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfRunGamebookResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/datasources": {
      "get": {
        "tags": [
          "Data sources"
        ],
        "summary": "Get connected datasources",
        "operationId": "v2-get-connected-datasources",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfDataSource"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/tickets/search": {
      "get": {
        "tags": [
          "Service tickets"
        ],
        "summary": "Search tickets",
        "operationId": "v2-search-tickets",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "groupingId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ticketNumber",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedApiResponseOfServiceTicketResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/tickets/link": {
      "post": {
        "tags": [
          "Service tickets"
        ],
        "summary": "Link ticket",
        "description": "Links an existing ticket in the workspace's connected ticketing system to an incident.\n\n`ticketId` must be the ticketing system's record id, not the ticket number people see:\n\n| Ticketing system | Send | Not |\n| --- | --- | --- |\n| ServiceNow | The incident `sys_id` (32 hex characters) | The incident number, such as `INC0049162` |\n| Jira Service Management | The issue id or the issue key, such as `SUP-123` | |\n| Autotask | The numeric ticket id | The ticket number, such as `T20261007.0001` |\n\nIf you only have the ticket number, call `GET /api/v2/workspaces/{workspaceId}/tickets/search?ticketNumber=<number>` first and send the `id` of the matching ticket (`serviceNowTicket.id`, `jiraTicket.id` or `autotaskTicket.id`). When the ticketing system cannot find a ticket with the given id, the request returns `400` with \"Unable to find the selected ticket\".",
        "operationId": "v2-link-ticket",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinkServiceTicketRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceTicketResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/tickets/unlink": {
      "post": {
        "tags": [
          "Service tickets"
        ],
        "summary": "Unlink ticket",
        "operationId": "v2-unlink-ticket",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UnlinkServiceTicketRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/tickets/priority": {
      "put": {
        "tags": [
          "Service tickets"
        ],
        "summary": "Update ticket priority",
        "operationId": "v2-update-ticket-priority",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceTicketUpdatePriorityRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/investigation/users/signin-logs": {
      "get": {
        "tags": [
          "Investigation"
        ],
        "summary": "List signin logs",
        "operationId": "v2-list-signin-logs",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "UserId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "TimeFilteringType",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/TimeFilteringType"
            }
          },
          {
            "name": "StartDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EndDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "NextPageLink",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfSignInLogsResultDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/investigation/users/directory-logs": {
      "get": {
        "tags": [
          "Investigation"
        ],
        "summary": "List directory logs",
        "operationId": "v2-list-directory-logs",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "UserId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "TimeFilteringType",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/TimeFilteringType"
            }
          },
          {
            "name": "StartDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EndDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "NextPageLink",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAuditLogsResultDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/export/audit": {
      "get": {
        "tags": [
          "Export"
        ],
        "summary": "Export audit events",
        "operationId": "v2-export-audit-events",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "startTime",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "nextPageToken",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExportAuditResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/incidents/{source}/{incidentId}/gamebooks": {
      "post": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool submit gamebook",
        "operationId": "v2-agent-tool-submit-gamebook",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentToolGamebookSubmissionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolGamebookSubmissionResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/incidents/{source}/{incidentId}/investigation": {
      "post": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool submit investigation",
        "operationId": "v2-agent-tool-submit-investigation",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentToolInvestigationSubmissionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolInvestigationSubmissionResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/users/{userId}": {
      "get": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool get user details",
        "operationId": "v2-agent-tool-get-user-details",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolUserDetailsResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/kql/tables": {
      "get": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool list kql tables",
        "operationId": "v2-agent-tool-list-kql-tables",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolKqlTablesResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/kql/tables/columns": {
      "post": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool get kql table columns",
        "operationId": "v2-agent-tool-get-kql-table-columns",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentToolKqlTableColumnsRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolKqlTableColumnsResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/kql/query": {
      "post": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool execute kql",
        "operationId": "v2-agent-tool-execute-kql",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentToolKqlQueryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolKqlQueryResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/users/{userId}/signin-logs": {
      "get": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool list signin logs",
        "operationId": "v2-agent-tool-list-signin-logs",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "TimeFilteringType",
            "in": "query",
            "description": "Time window for the lookup. Allowed values: ThreeHours, SixHours, TwelveHours, TwentyFourHours, FortyEightHours, Custom. Prefer the smallest window that resolves your specific uncertainty — sign-in volume can be high. Default: TwentyFourHours.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/TimeFilteringType"
            }
          },
          {
            "name": "StartDate",
            "in": "query",
            "description": "UTC start instant for Custom windows. Required when TimeFilteringType is Custom; ignored otherwise.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EndDate",
            "in": "query",
            "description": "UTC end instant for Custom windows. Required when TimeFilteringType is Custom; ignored otherwise.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "NextPageLink",
            "in": "query",
            "description": "Pagination cursor returned by a previous call's response. Pass to fetch the next page of results; omit for the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityName",
            "in": "query",
            "description": "Display name of the user entity being investigated. Surfaced in the audit trail; not used for matching.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceId",
            "in": "query",
            "description": "Audit-trail anchor — the ID of the resource the lookup is attributed to. Typically the incident ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceName",
            "in": "query",
            "description": "Audit-trail anchor — the display name of the resource the lookup is attributed to. Typically the incident title.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolTabularResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/users/{userId}/directory-logs": {
      "get": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool list directory logs",
        "operationId": "v2-agent-tool-list-directory-logs",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "TimeFilteringType",
            "in": "query",
            "description": "Time window for the lookup. Allowed values: ThreeHours, SixHours, TwelveHours, TwentyFourHours, FortyEightHours, Custom. Prefer the smallest window that resolves your specific uncertainty — directory audit volume can be high. Default: TwentyFourHours.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/TimeFilteringType"
            }
          },
          {
            "name": "StartDate",
            "in": "query",
            "description": "UTC start instant for Custom windows. Required when TimeFilteringType is Custom; ignored otherwise.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EndDate",
            "in": "query",
            "description": "UTC end instant for Custom windows. Required when TimeFilteringType is Custom; ignored otherwise.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "NextPageLink",
            "in": "query",
            "description": "Pagination cursor returned by a previous call's response. Pass to fetch the next page of results; omit for the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityName",
            "in": "query",
            "description": "Display name of the user entity being investigated. Surfaced in the audit trail; not used for matching.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceId",
            "in": "query",
            "description": "Audit-trail anchor — the ID of the resource the lookup is attributed to. Typically the incident ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ResourceName",
            "in": "query",
            "description": "Audit-trail anchor — the display name of the resource the lookup is attributed to. Typically the incident title.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolTabularResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/devices/{deviceId}/timeline": {
      "get": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool get device timeline",
        "operationId": "v2-agent-tool-get-device-timeline",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "deviceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "alertTime",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "entityName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "resourceId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "resourceName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolTabularResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/workspaces/{workspaceId}/agent/tools/incidents/{source}/{incidentId}/related-by-entity": {
      "get": {
        "tags": [
          "agent-tools"
        ],
        "summary": "Agent tool related incidents",
        "operationId": "v2-agent-tool-related-incidents",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/IncidentSource"
            }
          },
          {
            "name": "incidentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityKind",
            "in": "query",
            "description": "The entity's `kind` property as it appears on the incident (e.g. 'Account', 'Host', 'File', 'FileHash', 'Ip', 'Mailbox').",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityFilter",
            "in": "query",
            "description": "Main matching property of the entity — the hash for File/FileHash, device name or ID for Host, UPN/email/object ID for Account, IP string for Ip. Wrong choices return zero matches; refer to the entity's primary identifier on the incident.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "TimeFilteringType",
            "in": "query",
            "description": "Time window for related-incident search. Allowed values: ThreeHours, SixHours, TwelveHours, TwentyFourHours, FortyEightHours, Custom. Default: TwentyFourHours.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/TimeFilteringType"
            }
          },
          {
            "name": "StartDate",
            "in": "query",
            "description": "UTC start instant for Custom windows. Required when TimeFilteringType is Custom; ignored otherwise.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EndDate",
            "in": "query",
            "description": "UTC end instant for Custom windows. Required when TimeFilteringType is Custom; ignored otherwise.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "EntityName",
            "in": "query",
            "description": "Display name of the entity being investigated. Surfaced in the audit trail and the result's human-readable summary.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "EntityType",
            "in": "query",
            "description": "Internal entity type enum — more granular than EntityKind (e.g. EntityType.Account vs EntityType.User). Use the value present on the entity in the incident.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/EntityType"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentToolTabularResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/incidents/across-workspaces": {
      "post": {
        "tags": [
          "Cross-workspace incidents"
        ],
        "summary": "List incidents across workspaces",
        "operationId": "v2-list-incidents-across-workspaces",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListIncidentsAcrossWorkspacesRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfListIncidentsForWorkspacesResultDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/incidents/across-workspaces/bulk-update": {
      "post": {
        "tags": [
          "Cross-workspace incidents"
        ],
        "summary": "Bulk update incidents across workspaces",
        "operationId": "v2-bulk-update-incidents-across-workspaces",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkUpdateIncidentsRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfBulkUpdateIncidentResultDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/gamebooks/across-workspaces/history": {
      "get": {
        "tags": [
          "Cross-workspace gamebooks"
        ],
        "summary": "List gamebooks history across workspaces",
        "operationId": "v2-list-gamebooks-history-across-workspaces",
        "parameters": [
          {
            "name": "workspaces",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "statuses",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "currentPage",
            "in": "query",
            "required": true,
            "schema": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            }
          },
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfPageListOfGamebookDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/datasources/across-workspaces/anomalies": {
      "post": {
        "tags": [
          "Cross-workspace data sources"
        ],
        "summary": "List datasource anomalies across workspaces",
        "operationId": "v2-list-datasource-anomalies-across-workspaces",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListMultipleWorkspacesGeneralRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfDataConnectorAnomaliesDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/datasources/across-workspaces": {
      "get": {
        "tags": [
          "Cross-workspace data sources"
        ],
        "summary": "Get datasource workspaces across workspaces",
        "operationId": "v2-get-datasource-workspaces-across-workspaces",
        "parameters": [
          {
            "name": "workspaceIds",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfDataConnectorWorkspacesDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "List webhooks",
        "operationId": "v2-list-webhooks",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfWebhookConfigurationDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Create webhook",
        "operationId": "v2-create-webhook",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookConfigurationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookConfigurationCreatedDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Get webhook",
        "operationId": "v2-get-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookConfigurationDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Update webhook",
        "operationId": "v2-update-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebhookConfigurationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookConfigurationDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Delete webhook",
        "operationId": "v2-delete-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/delivery-logs": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "List webhook delivery logs",
        "operationId": "v2-list-webhook-delivery-logs",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": true,
            "schema": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            }
          },
          {
            "name": "continuationToken",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfPagedResultOfWebhookDeliveryLogDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/delivery-logs/{logId}": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Get webhook delivery log",
        "operationId": "v2-get-webhook-delivery-log",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "logId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "createdAt",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookDeliveryLogDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/pause": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Pause webhook",
        "operationId": "v2-pause-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookConfigurationDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/resume": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Resume webhook",
        "operationId": "v2-resume-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookConfigurationDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/enable": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Enable webhook",
        "operationId": "v2-enable-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookConfigurationDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/credentials": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Update webhook credentials",
        "operationId": "v2-update-webhook-credentials",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebhookCredentialsRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookCredentialsUpdatedDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/regenerate-secret": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Regenerate webhook secret",
        "operationId": "v2-regenerate-webhook-secret",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWebhookSecretRegeneratedDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/test": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Test webhook",
        "operationId": "v2-test-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfSendTestWebhookResult"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/webhooks/{id}/delivery-logs/{logId}/redeliver": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Redeliver webhook",
        "operationId": "v2-redeliver-webhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "logId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "createdAt",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfRedeliverWebhookCommandResult"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/service-accounts": {
      "get": {
        "tags": [
          "Service accounts"
        ],
        "summary": "List service accounts",
        "operationId": "v2-list-service-accounts",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfListOfServiceAccountDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Create service account",
        "operationId": "v2-create-service-account",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateServiceAccountRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceAccountCreatedDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/service-accounts/{id}": {
      "get": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Get service account",
        "operationId": "v2-get-service-account",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceAccountDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Update service account",
        "operationId": "v2-update-service-account",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateServiceAccountRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceAccountDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Delete service account",
        "operationId": "v2-delete-service-account",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/service-accounts/{id}/disable": {
      "post": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Disable service account",
        "operationId": "v2-disable-service-account",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceAccountDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/service-accounts/{id}/enable": {
      "post": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Enable service account",
        "operationId": "v2-enable-service-account",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceAccountDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/service-accounts/{id}/credentials": {
      "post": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Create service account credential",
        "operationId": "v2-create-service-account-credential",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateServiceAccountCredentialRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceAccountCredentialCreatedDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/service-accounts/{id}/credentials/{credentialId}/revoke": {
      "post": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Revoke service account credential",
        "operationId": "v2-revoke-service-account-credential",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "credentialId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfServiceAccountCredentialDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/service-accounts/sentinel-ingest/deployment-card": {
      "post": {
        "tags": [
          "Service accounts"
        ],
        "summary": "Provision sentinel ingest credential",
        "operationId": "v2-provision-sentinel-ingest-credential",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProvisionSentinelIngestRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfSentinelIngestDeploymentCardDto"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/users": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "List users",
        "operationId": "v2-list-users",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfUser"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "Add user",
        "operationId": "v2-add-user",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubmitAddUsersRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Users"
        ],
        "summary": "Update user",
        "operationId": "v2-update-user",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubmitUserManagementRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/users/profile": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "Get user profile",
        "operationId": "v2-get-user-profile",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfUserProfileDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/users/workspace/users": {
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "Get workspace users",
        "operationId": "v2-get-workspace-users",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetWorkspaceUsersRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfWorkspaceUserDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/users/{id}": {
      "delete": {
        "tags": [
          "Users"
        ],
        "summary": "Remove user",
        "operationId": "v2-remove-user",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/users/workspace": {
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "Add workspace users",
        "operationId": "v2-add-workspace-users",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/users/organization/role": {
      "put": {
        "tags": [
          "Users"
        ],
        "summary": "Update org role",
        "operationId": "v2-update-org-role",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserOrganizationalRoleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/subscriptions": {
      "get": {
        "tags": [
          "Azure resources"
        ],
        "summary": "List azure subscriptions",
        "operationId": "v2-list-azure-subscriptions",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfAzureSubscriptionDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/subscriptions/{subscriptionId}/network-security-groups": {
      "get": {
        "tags": [
          "Azure resources"
        ],
        "summary": "List azure nsgs",
        "operationId": "v2-list-azure-nsgs",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfNetworkSecurityGroupDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/subscriptions/is-owner": {
      "get": {
        "tags": [
          "Azure resources"
        ],
        "summary": "Check azure subscription owner",
        "operationId": "v2-check-azure-subscription-owner",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/subscriptions/{subscriptionId}/resource-groups": {
      "get": {
        "tags": [
          "Azure resources"
        ],
        "summary": "List azure resource groups",
        "operationId": "v2-list-azure-resource-groups",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfAzureResourceDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/subscriptions/{subscriptionId}/resource-groups/{resourceGroup}/workspaces": {
      "get": {
        "tags": [
          "Azure resources"
        ],
        "summary": "List azure workspaces",
        "operationId": "v2-list-azure-workspaces",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "resourceGroup",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfAzureResourceDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/subscriptions/{subscriptionId}/resource-groups/{resourceGroup}/sentinels": {
      "get": {
        "tags": [
          "Azure resources"
        ],
        "summary": "List azure sentinels",
        "operationId": "v2-list-azure-sentinels",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "resourceGroup",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIEnumerableOfAzureResourceDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/subscriptions/{subscriptionId}/resource-groups/{resourceGroup}/workspaces/{workspaceName}/validate": {
      "get": {
        "tags": [
          "Azure resources"
        ],
        "summary": "Validate azure workspace",
        "operationId": "v2-validate-azure-workspace",
        "parameters": [
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "resourceGroup",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspaceName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/azure-resources/analytical-rules/{ruleId}": {
      "put": {
        "tags": [
          "Azure resources"
        ],
        "summary": "Update analytical rule",
        "operationId": "v2-update-analytical-rule",
        "parameters": [
          {
            "name": "ruleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "enabled",
            "in": "query",
            "required": true,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfboolean"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/incident-flow": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting incident flow",
        "operationId": "v2-get-reporting-incident-flow",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingReadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfIncidentFlowReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/agent-investigations": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting agent investigations",
        "operationId": "v2-get-reporting-agent-investigations",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingReadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfAgentInvestigationsReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/sla": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting sla",
        "operationId": "v2-get-reporting-sla",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingReadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfSlaReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/workload": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting workload",
        "operationId": "v2-get-reporting-workload",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingReadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWorkloadReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/response-actions": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting response actions",
        "operationId": "v2-get-reporting-response-actions",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingReadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfResponseActionsReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/by-workspace": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting by workspace",
        "operationId": "v2-get-reporting-by-workspace",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingByWorkspaceRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfWorkspaceBreakdownResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/value": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting value",
        "operationId": "v2-get-reporting-value",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingReadRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfValueReportResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/facts/export": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Export reporting facts",
        "operationId": "v2-export-reporting-facts",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingFactsExportRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfReportingFactsTableResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/reporting/facts": {
      "post": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get reporting facts",
        "operationId": "v2-get-reporting-facts",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportingFactsPageRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseOfReportingFactsPageResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request — validation or parameter binding failed.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid Bearer token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden — insufficient scope or workspace access.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not found — workspace or resource is missing.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AgentInvestigationsPointResponse": {
        "type": "object",
        "properties": {
          "date": {
            "type": [
              "null",
              "string"
            ],
            "description": "`yyyy-MM-dd` or `yyyy-MM`; empty for range totals."
          },
          "runs": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "All terminal runs, including re-runs.",
            "format": "int32"
          },
          "resolvedByAgent": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest run's submission closed them.",
            "format": "int32"
          },
          "escalated": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest run left them for a person.",
            "format": "int32"
          },
          "failed": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest run failed.",
            "format": "int32"
          },
          "completedNoVerdict": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest run completed without a verdict.",
            "format": "int32"
          },
          "noChange": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest run recommended closing them when they were already closed.",
            "format": "int32"
          },
          "medianDurationSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "Median run duration in seconds; null when there were no runs.",
            "format": "double"
          },
          "p90DurationSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "90th percentile run duration in seconds; null when there were no runs.",
            "format": "double"
          },
          "costUsd": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "The agents' compute spend in US dollars, or `null` where it is not the caller's to see.",
            "format": "double"
          },
          "totalTokens": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Tokens the runs consumed, withheld with decimal? AgentInvestigationsPointResponse.CostUsd: priced at a model's rate, they are the spend.",
            "format": "int64"
          }
        },
        "description": "Agent investigation totals for one day or month, or the whole range."
      },
      "AgentInvestigationsReportResponse": {
        "type": "object",
        "properties": {
          "granularity": {
            "type": [
              "null",
              "string"
            ],
            "description": "`day` for ranges up to 92 days, otherwise `month`."
          },
          "points": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Agent investigation totals for one day or month, or the whole range.",
              "$ref": "#/components/schemas/AgentInvestigationsPointResponse"
            },
            "description": "One point per day or month in the range, oldest first; a period with no runs has zero counts and no durations."
          },
          "totals": {
            "description": "Totals for the whole range.",
            "$ref": "#/components/schemas/AgentInvestigationsPointResponse"
          },
          "investigatedBySeverity": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Incidents investigated, by the incident's severity."
          },
          "investigatedByVerdict": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Incidents investigated, by the verdict their latest run reached; a run that reached none is not counted."
          },
          "feedbackBySignal": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Every feedback record on the investigations, by signal, including bulk and automated closes."
          },
          "scoredFeedbackBySignal": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "The feedback records that count toward accuracy, by signal; accuracy is read from these alone."
          },
          "undeterminedScoredFeedbackBySignal": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "The part of the scored records on runs where the agent answered Undetermined. Accuracy is stated over decided\nruns only, so it is read from the difference."
          },
          "verdictsReviewed": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest run reached a verdict that a person reviewed, out of the incidents by verdict.",
            "format": "int32"
          },
          "runsWithVerdict": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Runs that reached a verdict, re-runs included; how often the agent decides is stated per run.",
            "format": "int32"
          },
          "decidedRuns": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "The part of the runs with a verdict whose verdict was True, Benign or False Positive.",
            "format": "int32"
          },
          "costBasis": {
            "type": [
              "null",
              "string"
            ],
            "description": "How the account's runs are priced: `Compute`, where the compute spend is reported, `Billed` or\n`None`, where it is ContraForce's cost and withheld, or `Restricted` for a caller who may not see spend."
          },
          "read": {
            "description": "How the response was read.",
            "$ref": "#/components/schemas/ReportingReadInfoResponse"
          }
        },
        "description": "v2 agent investigation outcomes over time."
      },
      "AgentToolCallKql": {
        "type": "object",
        "properties": {
          "query": {
            "type": [
              "null",
              "string"
            ],
            "description": "Exact KQL query that was executed. Shown verbatim in the comment activity header so an analyst can replay or audit the query."
          },
          "row_count": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Number of rows the query returned before any client-side truncation. Use the row_count from the execute-kql tool result.",
            "format": "int32"
          }
        },
        "description": "Per-call detail emitted alongside an `execute-kql` tool call so the comment\nheader can render the query and result size without a re-execution."
      },
      "AgentToolCallRecord": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tool name as the agent invoked it (e.g. 'execute-kql', 'get-user-details', 'list-signin-logs'). Use the MCP tool name verbatim so the activity header maps to the right icon/label."
          },
          "time": {
            "type": "string",
            "description": "UTC instant the tool call started. ISO 8601 / RFC 3339 format.",
            "format": "date-time"
          },
          "duration_ms": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Wall-clock duration of the call in milliseconds, including network time. Used to surface slow tool calls in the activity header.",
            "format": "int64"
          },
          "target_entity": {
            "type": [
              "null",
              "string"
            ],
            "description": "Entity the tool call targeted — UPN for users, device ID for hosts, table name for KQL, etc. Null for tools that do not address a specific entity (e.g. list-kql-tables)."
          },
          "kql": {
            "description": "KQL-specific detail. REQUIRED on every execute-kql tool call and null for every other tool. Carry the exact query text you passed to execute-kql in `query` and the tool result's row_count in `row_count`: the portal shows the query to the analyst on the comment, lets them re-run it in log search, and audits it. An execute-kql entry without `query` cannot be reviewed or replayed.",
            "$ref": "#/components/schemas/AgentToolCallKql"
          }
        },
        "description": "One entry in the agent's tool-call timeline."
      },
      "AgentToolGamebookSubmissionRequest": {
        "type": "object",
        "properties": {
          "incident_number": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Sequential incident number from the source platform. Used in human-readable summaries and gamebook tracking.",
            "format": "int32"
          },
          "incident_title": {
            "type": [
              "null",
              "string"
            ],
            "description": "Human-readable incident title from the source platform. Used in summaries and audit logs."
          },
          "trigger_type": {
            "description": "How the agent run was triggered. OnQueue (background): subject to per-severity Gamebooks capability gating — submissions are rejected for severities where Gamebooks is not enabled. ManualInvestigateAndRespond (operator-requested): always allowed to submit gamebooks regardless of capability settings.",
            "$ref": "#/components/schemas/AgentTriggerType"
          },
          "playbooks": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/AgentToolPlaybook"
            },
            "description": "Ordered playbook actions to run as part of this gamebook. Each entry binds a playbook from the registered catalog to its target entity. Must contain at least one entry — empty arrays are rejected."
          }
        },
        "description": "Request DTO for the agent's submit-gamebook tool. Allows the agent to queue one or more\nremediation gamebooks against an incident as it investigates."
      },
      "AgentToolGamebookSubmissionResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "True when the gamebook was queued. False for application-level failures (severity gating, unknown playbook, missing entity properties, upstream errors) — the failure reason is in `summary`."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Compact human-readable digest the agent can quote directly. On success: 'Gamebook GB-XXXXXX queued for {severity} severity incident. N playbook(s) scheduled: …'. On failure: a one-line failure reason."
          },
          "gamebook_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the queued gamebook. Pass this back in `submit-investigation`'s gamebook_ids so the investigation record references the gamebooks the agent triggered."
          },
          "status": {
            "type": [
              "null",
              "string"
            ],
            "description": "Gamebook lifecycle status at the moment of queueing (e.g. 'Queued', 'Running'). Not authoritative for completion — gamebooks run asynchronously after this call returns."
          },
          "is_queued_for_approval": {
            "type": "boolean",
            "description": "True when the gamebook was recorded but not started — it is sitting in the analyst's queue waiting for approval. Happens when the trigger type or severity capability doesn't give the agent run-authority (OnQueue without the Gamebooks capability for the incident's severity, or ManualInvestigateOnly). False when the gamebook was run directly."
          }
        },
        "description": "Result of an agent submit-gamebook tool call. Designed for LLM consumption — the\nstring AgentToolGamebookSubmissionResult.Summary field is a compact human-readable digest the agent can emit\ndirectly into chat or chain into follow-up reasoning."
      },
      "AgentToolInvestigationSubmissionRequest": {
        "type": "object",
        "properties": {
          "comment": {
            "type": [
              "null",
              "string"
            ],
            "description": "Final investigation summary. Posted on the incident as the agent's comment as-is — no server-side wrapping or section headers are applied. Write as a detailed security analyst would: cover initial hypothesis, indicators matched, tools called and why, evidence found, classification rationale, response actions, and recommended next steps. This is what a human analyst will read to learn from the agent's analysis."
          },
          "classification_reason_comment": {
            "type": [
              "null",
              "string"
            ],
            "description": "Short rationale (1–2 sentences) shown on the incident's closure record when the status transition closes the incident. Surfaces in the closure dialog and audit log alongside the classification reason."
          },
          "malicious_score": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "How malicious the agent judged the activity, 0 to 100, where 0 is clearly benign and 100 is\nclearly malicious. This is not confidence in the verdict: a False Positive the agent is\ncertain about scores near zero, not near a hundred.",
            "format": "int32"
          },
          "classification": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Final incident classification, identical for every security platform. Allowed values: TruePositive (confirmed malicious), FalsePositive (the detection was wrong; no suspicious activity occurred), BenignPositive (real activity confirmed benign, expected, or authorized), Undetermined (no firm verdict reached). Status transition follows from this via the per-severity agent settings.",
                "$ref": "#/components/schemas/Classification"
              }
            ]
          },
          "classification_reason": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Reason corresponding to the classification; required on every classified closeout and identical for every security platform. TruePositive → MultistagedAttack | Malware | MaliciousUserActivity | UnwantedSoftware | Phishing | CompromisedUser | Apt | SuspiciousActivity | Other. FalsePositive → NotMalicious | NoEnoughDataToValidate | InaccurateData | IncorrectAlertLogic | Other. BenignPositive → SecurityTesting | ConfirmedUserActivity | LineOfBusinessApplication | SecurityPersonnel | SuspiciousButExpected | Other. Undetermined → Unknown | Other. Pick the most specific reason the evidence supports; a pairing outside this list is normalized server-side to Other.",
                "$ref": "#/components/schemas/ClassificationReason"
              }
            ]
          },
          "classification_sop": {
            "description": "The single classification SOP whose decision tree drove the classification. Null when no SOP applied to this incident type.",
            "$ref": "#/components/schemas/AgentToolSopReference"
          },
          "response_sops": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "A reference to a Standard Operating Procedure used by the agent — both the SOP's\ninternal id and its display name are sent so the metadata is self-describing\nwithout a follow-up lookup.",
              "$ref": "#/components/schemas/AgentToolSopReference"
            },
            "description": "SOPs whose response steps the agent executed during the investigation. Empty when the agent decided no response action was warranted."
          },
          "gamebook_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "IDs of gamebooks the agent queued earlier via submit-gamebook during this investigation. Use the `gamebook_id` returned by each submit-gamebook call. Receive-only here — submit-investigation does NOT queue additional gamebooks."
          },
          "tool_calls": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "One entry in the agent's tool-call timeline.",
              "$ref": "#/components/schemas/AgentToolCallRecord"
            },
            "description": "Per-tool-call timeline the agent recorded during the investigation. Used to render the activity header on the comment so an analyst can see exactly which tools the agent invoked, on what target, in what order, and how long each took."
          }
        },
        "description": "Request DTO for the agent's submit-investigation tool — the closeout call the agent\nmakes after it has finished investigating an incident."
      },
      "AgentToolInvestigationSubmissionResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "True when both the comment was posted and the status transition (if any) succeeded. False if either failed — see `comment_posted` and `status_updated` for which leg failed."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Compact human-readable digest of what happened: comment posted? status changed from X to Y? failure reason if any."
          },
          "previous_status": {
            "type": [
              "null",
              "string"
            ],
            "description": "Status the incident was in before this call."
          },
          "new_status": {
            "type": [
              "null",
              "string"
            ],
            "description": "Status the incident is in after this call. Equals previous_status when no transition was applied (either because the status already matched the target or because the update failed)."
          },
          "applied_classification": {
            "type": [
              "null",
              "string"
            ],
            "description": "Classification actually applied after server-side normalisation. Null when no status transition was applied."
          },
          "applied_classification_reason": {
            "type": [
              "null",
              "string"
            ],
            "description": "Classification reason actually applied after server-side normalisation. Null when no status transition was applied."
          },
          "comment_posted": {
            "type": "boolean",
            "description": "True when the agent's comment was successfully posted on the incident."
          },
          "status_updated": {
            "type": "boolean",
            "description": "True when the incident's status was successfully transitioned. False when the status was already at the target value (no update needed) or when the update failed."
          }
        },
        "description": "Result of an agent submit-investigation tool call."
      },
      "AgentToolKqlColumn": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Column name. Use verbatim in KQL queries — column names are case-sensitive in Kusto."
          },
          "type": {
            "type": [
              "null",
              "string"
            ],
            "description": "Column data type as Kusto names it (e.g. 'string', 'datetime', 'long', 'real', 'bool', 'dynamic', 'guid'). Use to decide on appropriate operators and casts in your KQL."
          }
        }
      },
      "AgentToolKqlQueryRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": [
              "null",
              "string"
            ],
            "description": "KQL query to execute against the workspace's Log Analytics workspace. Ground the query in the real schema first by calling list-kql-tables and get-kql-table-columns — queries against non-existent tables or columns return a clear error. Prefer narrowly-scoped queries (specific table, time range, project clause) over broad scans to keep results inside the row cap."
          },
          "max_rows": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Optional row cap. Defaults to 50 server-side; values above the hard maximum (200) are clamped silently. Set explicitly only when the default is too narrow for the investigation — the cap protects the LLM context window from runaway queries.",
            "format": "int32"
          }
        },
        "description": "Request DTO for the agent's KQL execution tool. Trimmed for LLM consumption — the\nagent supplies a query string the schema-aware sub-agent has already generated, and we\nrun it under the workspace's Log Analytics context."
      },
      "AgentToolKqlQueryResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "True when the query ran. False for KQL syntax errors, schema mismatches, upstream Log Analytics failures, or XDR-only workspaces — the failure reason is in `summary`."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Compact human-readable digest: 'Query returned N rows.' or 'Query returned X rows; showing first N (truncated).' or a one-line failure reason."
          },
          "row_count": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Number of rows actually returned (after server-side truncation). When `truncated` is true, this is less than the total rows the query matched.",
            "format": "int32"
          },
          "truncated": {
            "type": "boolean",
            "description": "True when the query produced more rows than were returned (hit the row cap). The agent should narrow the query (tighter time range, more selective filters, project fewer columns) rather than attempt pagination — these tools have no pagination contract. Omitted when false."
          },
          "columns": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Column names in order. Index into each row in `rows` using the position of the column name here. Columns whose values were null/empty across every projected row are auto-pruned."
          },
          "rows": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Result rows as parallel arrays aligned to `columns`. Position-aligned: rows[r][c] is the value of columns[c] for row r. Values are stringified — booleans become 'true'/'false', objects/arrays become compact JSON, oversized cells are truncated with a `…(N more)` suffix."
          }
        },
        "description": "Result of an agent KQL execution tool call. Returns true-columnar rows (parallel arrays\nindexed against the List&lt;string&gt; AgentToolKqlQueryResult.Columns header) — far more token-efficient than a\nper-row dictionary because column names are written exactly once."
      },
      "AgentToolKqlTable": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Table name as it appears in Log Analytics. Use this verbatim in KQL queries."
          },
          "columns": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/AgentToolKqlColumn"
            },
            "description": "Columns defined on this table. Order follows the table's schema definition."
          }
        }
      },
      "AgentToolKqlTableColumnsRequest": {
        "type": "object",
        "properties": {
          "table_names": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Table names to fetch column metadata for. Names from list-kql-tables work as-is. Unknown names are echoed back in `unknown_table_names` rather than silently dropped, so the agent can recover. Must contain at least one entry."
          }
        },
        "description": "Request DTO for the agent's get-KQL-table-columns tool. Pass the table names the\nagent wants column metadata for — the response includes per-table column lists and\nechoes back any names that didn't resolve to a real table."
      },
      "AgentToolKqlTableColumnsResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "True when at least one requested table matched the schema. False when none matched, on XDR-only workspaces, or on upstream schema-fetch failures — reason in `summary`."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Compact human-readable digest: 'Resolved N table(s) with M column(s) total.' plus a list of unknown names when any failed to resolve."
          },
          "tables": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/AgentToolKqlTable"
            },
            "description": "Per-table column metadata for the names that resolved. Order follows the request input."
          },
          "unknown_table_names": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Names from the request that did not resolve to a real table. Empty when every requested name was found. Use this to retry with corrected names or to back off and call list-kql-tables again."
          }
        },
        "description": "Result of the agent's get-KQL-table-columns tool."
      },
      "AgentToolKqlTablesResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "True when the schema fetch succeeded. False on XDR-only onboarded workspaces (Log Analytics not available) or upstream failures — reason in `summary`."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Compact human-readable digest: 'Workspace exposes N table(s). Call get-table-columns with the names you intend to query.' or a one-line failure reason."
          },
          "tables": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Table names available in the workspace, sorted alphabetically. Use verbatim in subsequent get-kql-table-columns and execute-kql calls."
          }
        },
        "description": "Result of the agent's list-KQL-tables tool. Returns table names only — column data\nis intentionally excluded so the agent can broaden discovery cheaply and then call\nthe get-table-columns tool with a narrowed set of names."
      },
      "AgentToolPlaybook": {
        "type": "object",
        "properties": {
          "playbook_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of a playbook from the registered playbook catalog. Unknown IDs cause the entire submission to fail — there is no partial-success mode."
          },
          "entity_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable identifier of the target entity. MUST be the entity object's `id` property — NEVER `aadUserId`, `DeviceId`, `FileHash`, or any other entity-specific property. Using the wrong identifier here will cause the playbook to act on the wrong target or fail."
          },
          "affected_entity": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the target entity (e.g. UPN for a user, hostname for a device). Shown in human-readable summaries and audit logs."
          },
          "sequence": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Run order within the gamebook, starting at 1. Lower numbers execute first. Use this to express dependencies — e.g., scan endpoint (sequence 1) before isolate endpoint (sequence 2) on the same device. Sequence is independent per entity: playbooks targeting different entities run in parallel groups.",
            "format": "int32"
          },
          "internet_message_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "OPTIONAL — for the 'deleteemail' playbook only. RFC 2822 internet-message-id of the email to delete (the Message-ID header value, typically including angle brackets, e.g. '<abc-123@contoso.com>'). Read it verbatim from the incident's email entity — do not strip the brackets or invent it. When supplied together with user_object_id (or user_principal_name) the playbook deletes that exact message from the user's mailbox and skips incident-entity resolution entirely. Leave null for other playbooks or to fall back to entity-based resolution."
          },
          "user_object_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "OPTIONAL — for the 'deleteemail' playbook only. Azure AD object id (GUID) of the mailbox owner whose inbox holds the email. Read it from the incident's recipient user entity (its aadUserId) — never invent it. Preferred over user_principal_name. Supply alongside internet_message_id to delete the message directly without entity-graph resolution."
          },
          "user_principal_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "OPTIONAL — for the 'deleteemail' playbook only. User principal name (UPN, e.g. 'user@contoso.com') of the mailbox owner, used when the object id is unavailable; the server resolves it to an object id via the directory. Read it from the incident's user entity. Supply user_object_id instead when you have it."
          }
        }
      },
      "AgentToolSopReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Internal SOP identifier (UUID or slug). Used to link back to the SOP record in the knowledge base."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the SOP. Shown in the comment header so the analyst sees which SOP drove the decision without a follow-up lookup."
          }
        },
        "description": "A reference to a Standard Operating Procedure used by the agent — both the SOP's\ninternal id and its display name are sent so the metadata is self-describing\nwithout a follow-up lookup."
      },
      "AgentToolTabularResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "True when the underlying lookup completed and the rows reflect real data. False for upstream failures, prerequisite-missing errors (e.g. module disabled, no aadUserId), or empty-with-reason responses — see `summary` for the cause."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Compact human-readable digest: row count + truncation hint, or a one-line failure reason. Omitted when there is nothing meaningful to say beyond the rows themselves."
          },
          "row_count": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Number of rows actually returned in `rows`. Zero when the lookup ran successfully but produced no matches.",
            "format": "int32"
          },
          "truncated": {
            "type": "boolean",
            "description": "True when the upstream produced more rows than were returned (row cap hit). Narrow the query / time window rather than attempting pagination — these tools have no pagination contract unless `next_page_link` is present."
          },
          "columns": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Column names in order. Index into each row in `rows` using the position of the column name here. Columns whose values were null/empty across every projected row are auto-pruned so the agent isn't asked to reason about noise."
          },
          "rows": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Result rows as parallel arrays aligned to `columns`. Position-aligned: rows[r][c] is the value of columns[c] for row r. Values are stringified — booleans become 'true'/'false', timestamps are ISO-8601 UTC, oversized cells are truncated with a `…(N more)` suffix."
          },
          "constants": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Columns whose value was identical across every projected row, promoted out of `rows` and emitted once here. Saves tokens when (e.g.) every sign-in event has the same userPrincipalName."
          },
          "next_page_link": {
            "type": [
              "null",
              "string"
            ],
            "description": "Opaque pagination cursor returned by the upstream provider. Pass back as `next_page_link` on the next call to continue paging; omit for the first page. Absent when the upstream does not support pagination or there are no more pages."
          }
        },
        "description": "Token-efficient envelope for agent-tool list responses. Rows are stored as parallel\narrays aligned to a single shared List&lt;string&gt; AgentToolTabularResult.Columns header so column names are\nwritten exactly once rather than once per row."
      },
      "AgentToolUserDetailsResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "True when the user was found in Microsoft Graph. False when the user does not exist, when the Gamebooks-for-Identity module is disabled for the workspace, or when Graph returned an error — reason in `summary`."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Compact one-line human-readable digest: '{DisplayName}, {JobTitle} in {Department} ({OfficeLocation}). UPN: {UPN}.' — fields omitted when null."
          },
          "user_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Azure AD object ID of the resolved user. Echoes the request input — useful for chained calls."
          },
          "display_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name (first + last) of the user."
          },
          "user_principal_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "User Principal Name (UPN), typically the user's email-like sign-in name (e.g. alice@contoso.com)."
          },
          "mail": {
            "type": [
              "null",
              "string"
            ],
            "description": "Primary SMTP email address. May differ from the UPN."
          },
          "job_title": {
            "type": [
              "null",
              "string"
            ],
            "description": "Job title from the user's directory profile. Useful for assessing whether the account is privileged (e.g. 'Domain Admin', 'CFO')."
          },
          "department": {
            "type": [
              "null",
              "string"
            ],
            "description": "Department from the user's directory profile."
          },
          "office_location": {
            "type": [
              "null",
              "string"
            ],
            "description": "Office location from the user's directory profile. Useful when correlating sign-in geolocation against expected location."
          },
          "mobile_phone": {
            "type": [
              "null",
              "string"
            ],
            "description": "Mobile phone number from the user's directory profile."
          }
        },
        "description": "Result of an agent user-lookup tool call. Returns a token-efficient view of a Microsoft\nGraph user with only the fields that have proven useful in incident analysis — full\nGraph payloads include large arrays of identities, business phones, and password change\nmetadata that bloat LLM context without changing decisions."
      },
      "AgentTriggerType": {
        "enum": [
          "OnQueue",
          "ManualInvestigateOnly",
          "ManualInvestigateAndRespond"
        ],
        "description": "Define the type of the agent trigger that identifies the behaviour of the agent"
      },
      "ApiProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": [
              "null",
              "string"
            ]
          },
          "title": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "detail": {
            "type": [
              "null",
              "string"
            ]
          },
          "instance": {
            "type": [
              "null",
              "string"
            ]
          },
          "code": {
            "type": [
              "null",
              "string"
            ]
          },
          "requestId": {
            "type": [
              "null",
              "string"
            ]
          },
          "timestamp": {
            "type": [
              "null",
              "string"
            ]
          },
          "target": {
            "type": [
              "null",
              "string"
            ]
          },
          "errors": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "description": "API extension of ProblemDetails that surfaces the stable error code,\ntrace identifier, timestamp, optional target, and optional field-keyed validation\nerror map alongside the RFC 7807 members."
      },
      "ApiResponseOfAgentInvestigationsReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 agent investigation outcomes over time.",
            "$ref": "#/components/schemas/AgentInvestigationsReportResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAgentToolGamebookSubmissionResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result of an agent submit-gamebook tool call. Designed for LLM consumption — the\nstring AgentToolGamebookSubmissionResult.Summary field is a compact human-readable digest the agent can emit\ndirectly into chat or chain into follow-up reasoning.",
            "$ref": "#/components/schemas/AgentToolGamebookSubmissionResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAgentToolInvestigationSubmissionResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result of an agent submit-investigation tool call.",
            "$ref": "#/components/schemas/AgentToolInvestigationSubmissionResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAgentToolKqlQueryResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result of an agent KQL execution tool call. Returns true-columnar rows (parallel arrays\nindexed against the List&lt;string&gt; AgentToolKqlQueryResult.Columns header) — far more token-efficient than a\nper-row dictionary because column names are written exactly once.",
            "$ref": "#/components/schemas/AgentToolKqlQueryResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAgentToolKqlTableColumnsResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result of the agent's get-KQL-table-columns tool.",
            "$ref": "#/components/schemas/AgentToolKqlTableColumnsResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAgentToolKqlTablesResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result of the agent's list-KQL-tables tool. Returns table names only — column data\nis intentionally excluded so the agent can broaden discovery cheaply and then call\nthe get-table-columns tool with a narrowed set of names.",
            "$ref": "#/components/schemas/AgentToolKqlTablesResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAgentToolTabularResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Token-efficient envelope for agent-tool list responses. Rows are stored as parallel\narrays aligned to a single shared List&lt;string&gt; AgentToolTabularResult.Columns header so column names are\nwritten exactly once rather than once per row.",
            "$ref": "#/components/schemas/AgentToolTabularResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAgentToolUserDetailsResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result of an agent user-lookup tool call. Returns a token-efficient view of a Microsoft\nGraph user with only the fields that have proven useful in incident analysis — full\nGraph payloads include large arrays of identities, business phones, and password change\nmetadata that bloat LLM context without changing decisions.",
            "$ref": "#/components/schemas/AgentToolUserDetailsResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfAuditLogsResultDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/AuditLogsResultDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIncidentFlowReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 incident flow totals for a date range and workspace selection.",
            "$ref": "#/components/schemas/IncidentFlowReportResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfReportingFactsPageResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "One page of reporting facts for a drill-down table.",
            "$ref": "#/components/schemas/ReportingFactsPageResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfReportingFactsTableResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Every row behind a report, as a table with the columns of its fact type.",
            "$ref": "#/components/schemas/ReportingFactsTableResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfResponseActionsReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 response actions for a date range and workspace selection.",
            "$ref": "#/components/schemas/ResponseActionsReportResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfSlaReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 SLA results and state changes for a date range and workspace selection.",
            "$ref": "#/components/schemas/SlaReportResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfValueReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 agent cost against the analyst time it saved.",
            "$ref": "#/components/schemas/ValueReportResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfWorkloadReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 analyst workload for a date range and workspace selection.",
            "$ref": "#/components/schemas/WorkloadReportResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfWorkspaceBreakdownResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 one reporting metric by workspace: the highest workspaces and a remainder.",
            "$ref": "#/components/schemas/WorkspaceBreakdownResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfboolean": {
        "type": "object",
        "properties": {
          "data": {
            "type": "boolean"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfBulkUpdateIncidentResultDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Outcome of a bulk incident update request after per-incident authorization.",
            "$ref": "#/components/schemas/BulkUpdateIncidentResultDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfContraForceIncident": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Object that represents all the data from an incident that could come from any source",
            "$ref": "#/components/schemas/ContraForceIncident"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfDataConnectorAnomaliesDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/DataConnectorAnomaliesDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfDataConnectorWorkspacesDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/DataConnectorWorkspacesDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfGamebookDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/GamebookDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfGeneralTableDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/GeneralTableDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfAzureResourceDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/AzureResourceDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfAzureSubscriptionDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/AzureSubscriptionDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfDataSource": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DataSource"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfGamebookDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/GamebookDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfIncidentCommentDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/IncidentCommentDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfNetworkSecurityGroupDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/NetworkSecurityGroupDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfPlaybookGameplanDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PlaybookGameplanDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfPlaybookMetadataDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PlaybookMetadataDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfUser": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Represents an employee or a user in ContraForce client's tenant and it's built on top of the Microsoft Graph user model and could be extended based on other provider needs",
              "$ref": "#/components/schemas/User"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfWebhookConfigurationDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WebhookConfigurationDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIEnumerableOfWorkspaceUserDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkspaceUserDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIncidentCommentDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/IncidentCommentDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfIncidentsByEntityResultDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/IncidentsByEntityResultDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfListGamebooksResultDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ListGamebooksResultDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfListIncidentsForWorkspacesResultDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Wraps the result of listing incidents for multiple workspaces in the multi-tenancy mode.",
            "$ref": "#/components/schemas/ListIncidentsForWorkspacesResultDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfListOfServiceAccountDto": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ServiceAccountDto"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfPagedResultOfWebhookDeliveryLogDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Represents a page of results with a token to load more.",
            "$ref": "#/components/schemas/PagedResultOfWebhookDeliveryLogDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfPageListOfGamebookDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/PageListOfGamebookDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfRedeliverWebhookCommandResult": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/RedeliverWebhookCommandResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfRunGamebookResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Public result of submitting a gamebook, without workspace or incident target details.",
            "$ref": "#/components/schemas/RunGamebookResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfSendTestWebhookResult": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result returned after a test webhook has been queued for delivery.",
            "$ref": "#/components/schemas/SendTestWebhookResult"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfSentinelIngestDeploymentCardDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "The deployment card the portal shows after provisioning Sentinel Content Hub ingest: the shared client id\nand secret for the organization, plus each onboarded workspace and the endpoint its playbook posts to.",
            "$ref": "#/components/schemas/SentinelIngestDeploymentCardDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfServiceAccountCreatedDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Returned only on service account creation. Contains the plaintext client secret which is shown once.",
            "$ref": "#/components/schemas/ServiceAccountCreatedDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfServiceAccountCredentialCreatedDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Returned only when a credential is created. Contains the plaintext client secret which is shown once.",
            "$ref": "#/components/schemas/ServiceAccountCredentialCreatedDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfServiceAccountCredentialDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Represents a single API credential belonging to a service account.",
            "$ref": "#/components/schemas/ServiceAccountCredentialDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfServiceAccountDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ServiceAccountDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfServiceTicketResponse": {
        "type": "object",
        "properties": {
          "data": {
            "description": "v2 view of an incident's service ticket in the workspace's connected ticketing system.",
            "$ref": "#/components/schemas/ServiceTicketResponse"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfSignInLogsResultDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/SignInLogsResultDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfUserProfileDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/UserProfileDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfWebhookConfigurationCreatedDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/WebhookConfigurationCreatedDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfWebhookConfigurationDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/WebhookConfigurationDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfWebhookCredentialsUpdatedDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/WebhookCredentialsUpdatedDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfWebhookDeliveryLogDto": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/WebhookDeliveryLogDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "ApiResponseOfWebhookSecretRegeneratedDto": {
        "type": "object",
        "properties": {
          "data": {
            "description": "Result of regenerating a webhook's signing secret. string WebhookSecretRegeneratedDto.Secret is the only time the\nplaintext leaves the server; it is never readable again after this response.",
            "$ref": "#/components/schemas/WebhookSecretRegeneratedDto"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for single-item responses."
      },
      "AppRole": {
        "enum": [
          "DefaultAccess",
          "Admin",
          "User",
          "Billing",
          "IncidentAnalyst",
          "IncidentResponder",
          "DataSourceAdmin"
        ]
      },
      "AssignIncidentRequest": {
        "type": "object",
        "properties": {
          "userId": {
            "type": [
              "null",
              "string"
            ],
            "description": "ContraForce user id of the assignee. Takes precedence over email when both are set."
          },
          "email": {
            "type": [
              "null",
              "string"
            ],
            "description": "Email of the assignee, used when userId is empty. Matches an active member of your organization, ignoring\ncase; an email that matches no member returns 404, and one that several members share returns 400."
          }
        },
        "description": "v2 request body for assigning an incident to a user. Leave both userId and email empty to unassign the incident."
      },
      "AuditedResourceType": {
        "enum": [
          "None",
          "Incident",
          "Account"
        ],
        "description": "Specifies the types of resources that can be audited within the system."
      },
      "AuditLogItemDto": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date-time"
          },
          "service": {
            "type": [
              "null",
              "string"
            ]
          },
          "activity": {
            "type": [
              "null",
              "string"
            ]
          },
          "category": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "type": [
              "null",
              "string"
            ]
          },
          "statusReason": {
            "type": [
              "null",
              "string"
            ]
          },
          "targetResources": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "targets": {
            "type": [
              "null",
              "string"
            ]
          },
          "actor": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "AuditLogsResultDto": {
        "type": "object",
        "properties": {
          "items": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/AuditLogItemDto"
            },
            "description": "The user audit log items."
          },
          "nextPageLink": {
            "type": [
              "null",
              "string"
            ],
            "description": "The link to load the next page of user audit logs."
          },
          "message": {
            "type": [
              "null",
              "string"
            ],
            "description": "A consumer-neutral message describing why data could not be retrieved.\nPresent when bool AuditLogsResultDto.CanRetrieveData is `false`."
          },
          "canRetrieveData": {
            "type": "boolean",
            "description": "Indicates whether the handler was able to retrieve the requested data.\nWhen `false`, callers should check string AuditLogsResultDto.Message for the reason\nand avoid retrying the same request without addressing the underlying cause."
          }
        }
      },
      "AutotaskTicketNoteResponse": {
        "type": "object",
        "properties": {
          "id": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Autotask note id.",
            "format": "int32"
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Note text."
          },
          "ticketId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Ticket the note belongs to.",
            "format": "int32"
          },
          "title": {
            "type": [
              "null",
              "string"
            ],
            "description": "Note title."
          }
        },
        "description": "v2 view of a note on an Autotask ticket."
      },
      "AutotaskTicketPriority": {
        "enum": [
          "High",
          "Medium",
          "Low",
          "Critical"
        ]
      },
      "AutotaskTicketPriorityUpdateRequest": {
        "type": "object",
        "properties": {
          "id": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "priority": {
            "$ref": "#/components/schemas/AutotaskTicketPriority"
          }
        }
      },
      "AutotaskTicketResponse": {
        "type": "object",
        "properties": {
          "id": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Autotask ticket id.",
            "format": "int32"
          },
          "companyId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Autotask company the ticket belongs to.",
            "format": "int32"
          },
          "projectId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Autotask project the ticket belongs to, if any.",
            "format": "int32"
          },
          "assignedResourceId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Resource the ticket is assigned to, if any.",
            "format": "int64"
          },
          "assignedResourceRoleId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Role of the assigned resource, if any.",
            "format": "int64"
          },
          "billingCodeId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Billing code, if any.",
            "format": "int32"
          },
          "categoryId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Ticket category id.",
            "format": "int32"
          },
          "number": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ticket number as Autotask shows it."
          },
          "type": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Autotask ticket type id.",
            "format": "int32"
          },
          "title": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ticket title."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ticket description."
          },
          "priority": {
            "description": "Ticket priority.",
            "$ref": "#/components/schemas/ServiceTicketAutotaskPriority"
          },
          "status": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Autotask status id.",
            "format": "int32"
          },
          "queueId": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Autotask queue id.",
            "format": "int32"
          },
          "dueDateTime": {
            "type": "string",
            "description": "When the ticket is due.",
            "format": "date-time"
          },
          "notes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "v2 view of a note on an Autotask ticket.",
              "$ref": "#/components/schemas/AutotaskTicketNoteResponse"
            },
            "description": "Notes on the ticket; null when they were not loaded."
          }
        },
        "description": "v2 view of an Autotask ticket."
      },
      "AzureResourceDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "azureId": {
            "type": [
              "null",
              "string"
            ]
          },
          "location": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "AzureSubscriptionDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "BulkUpdateIncidentResultDto": {
        "type": "object",
        "properties": {
          "accepted": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Incident IDs the caller is authorized to update. These are scheduled for async processing."
          },
          "forbidden": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Per-incident rejection detail for a bulk update.",
              "$ref": "#/components/schemas/ForbiddenBulkUpdateIncidentDto"
            },
            "description": "Incidents the caller is not authorized to update, grouped with the reason."
          }
        },
        "description": "Outcome of a bulk incident update request after per-incident authorization."
      },
      "BulkUpdateIncidentsRequest": {
        "type": "object",
        "properties": {
          "items": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/UpdateIncidentRequest"
            }
          }
        },
        "description": "v2 request body for the cross-workspace bulk incident update endpoint."
      },
      "Classification": {
        "enum": [
          "BenignPositive",
          "FalsePositive",
          "TruePositive",
          "Undetermined",
          null
        ]
      },
      "ClassificationReason": {
        "enum": [
          "InaccurateData",
          "IncorrectAlertLogic",
          "SuspiciousActivity",
          "SuspiciousButExpected",
          "Unknown",
          "Apt",
          "Malware",
          "SecurityPersonnel",
          "SecurityTesting",
          "UnwantedSoftware",
          "Other",
          "MultistagedAttack",
          "CompromisedUser",
          "Phishing",
          "MaliciousUserActivity",
          "NotMalicious",
          "NoEnoughDataToValidate",
          "ConfirmedUserActivity",
          "LineOfBusinessApplication",
          null
        ]
      },
      "ConnectorParameterHelper": {
        "type": "object",
        "properties": {
          "propertyName": {
            "type": [
              "null",
              "string"
            ]
          },
          "propertyValue": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "ConnectorType": {
        "enum": [
          "MicrosoftOffice",
          "AzureADIdentityProtection",
          "MicrosoftDefenderForEndpoint",
          "MicrosoftDefenderForCloudApps",
          "MicrosoftDefenderForCloud",
          "MicrosoftDefenderForIdentity",
          "AWSCloudTrail"
        ]
      },
      "ContraForceIncident": {
        "type": "object",
        "properties": {
          "source": {
            "description": "Property to retrieve the source of the incident (DefenderXDR, Sentinel, etc)",
            "$ref": "#/components/schemas/IncidentSource"
          },
          "incident": {
            "description": "Object to retrieve the base information of the incident",
            "$ref": "#/components/schemas/Incident"
          },
          "investigationDetails": {
            "description": "Object to retrieve the entities and alerts related to the incident",
            "$ref": "#/components/schemas/IncidentInvestigationDetailsDto"
          },
          "evidence": {
            "description": "Object to retrieve the evidence related to the incident",
            "$ref": "#/components/schemas/GeneralTableDto"
          },
          "gamebookCatalog": {
            "description": "(Nullable) Represents the recommended gamebook by ContraForce or the last run gamebook for the incident",
            "$ref": "#/components/schemas/IncidentGamebooksCatalogDto"
          }
        },
        "description": "Object that represents all the data from an incident that could come from any source"
      },
      "CreateIncidentCommentRequest": {
        "required": [
          "content"
        ],
        "type": "object",
        "properties": {
          "content": {
            "type": [
              "null",
              "string"
            ],
            "description": "Body of the comment."
          },
          "extensionId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ignored. The source in the route decides where the comment is written; this field\nis accepted so clients that still send it keep working (PLAT-3611)."
          }
        },
        "description": "v2 request body for creating a comment on an incident."
      },
      "CreateServiceAccountCredentialRequest": {
        "type": "object",
        "properties": {
          "expirationDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "scopes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "The API scopes to grant to this credential."
          }
        },
        "description": "Request to create an additional credential for an existing service account."
      },
      "CreateServiceAccountRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "organizationalRole": {
            "$ref": "#/components/schemas/OrganizationalRole"
          },
          "workspaceAssignments": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkspaceRoleAssignment"
            }
          },
          "expirationDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "scopes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "The granular API scopes granted to the initial credential."
          }
        }
      },
      "CreateWebhookConfigurationRequest": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": [
              "null",
              "string"
            ],
            "format": "uuid"
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "url": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventTypes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "monitoredAccountIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "authenticationType": {
            "$ref": "#/components/schemas/WebhookAuthenticationType"
          },
          "token": {
            "type": [
              "null",
              "string"
            ]
          },
          "signingToken": {
            "type": [
              "null",
              "string"
            ]
          },
          "username": {
            "type": [
              "null",
              "string"
            ]
          },
          "password": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "DataConnectorAnomaliesDto": {
        "type": "object",
        "properties": {
          "items": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DataConnectorAnomalyItemDto"
            }
          }
        }
      },
      "DataConnectorAnomalyItemDto": {
        "type": "object",
        "properties": {
          "workspaceName": {
            "type": [
              "null",
              "string"
            ]
          },
          "dataConnector": {
            "description": "Data Connector that is supported by the onboarding process and the",
            "$ref": "#/components/schemas/DataConnectorDto"
          },
          "status": {
            "$ref": "#/components/schemas/DataConnectorAnomalyStatus"
          }
        }
      },
      "DataConnectorAnomalyStatus": {
        "enum": [
          "Active",
          "Resolved",
          "Investigating",
          "Failed"
        ]
      },
      "DataConnectorDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "icon": {
            "type": [
              "null",
              "string"
            ]
          },
          "link": {
            "type": [
              "null",
              "string"
            ]
          },
          "category": {
            "type": [
              "null",
              "string"
            ]
          },
          "provider": {
            "type": [
              "null",
              "string"
            ]
          },
          "isConnected": {
            "type": "boolean"
          },
          "isWaitingActivation": {
            "type": "boolean"
          },
          "directApiConnectionAvailable": {
            "type": "boolean",
            "description": "Indicates if the data connector has an API to connect/disconnect it"
          },
          "metadata": {
            "type": [
              "null",
              "string"
            ],
            "description": "Defines a JSON / String that contains the configuration for a specific data source (ARN for AWS CloudTrail)"
          },
          "isConfigurable": {
            "type": "boolean",
            "description": "Data Connector requires configuration before it can be used (Form of data is needed)"
          },
          "plan": {
            "type": [
              "null",
              "string"
            ]
          },
          "isSupported": {
            "type": "boolean"
          },
          "isPrivate": {
            "type": "boolean"
          },
          "isSubscribedToDeployments": {
            "type": "boolean"
          },
          "deployedVersionDto": {
            "$ref": "#/components/schemas/VersionDto"
          },
          "cfCurrentVersionDto": {
            "$ref": "#/components/schemas/VersionDto"
          },
          "status": {
            "$ref": "#/components/schemas/DataSourceAnalysisStatus"
          },
          "modificationDate": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "Data Connector that is supported by the onboarding process and the"
      },
      "DataConnectorWorkspacesDto": {
        "type": "object",
        "properties": {
          "workspaces": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DataConnectorWorkspaceSourceDto"
            }
          }
        }
      },
      "DataConnectorWorkspaceSourceDto": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceName": {
            "type": [
              "null",
              "string"
            ]
          },
          "tenantId": {
            "type": [
              "null",
              "string"
            ]
          },
          "source": {
            "type": [
              "null",
              "string"
            ]
          },
          "dataConnectorCount": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          }
        }
      },
      "DataSource": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "icon": {
            "type": [
              "null",
              "string"
            ]
          },
          "dataConnectorId": {
            "type": [
              "null",
              "string"
            ]
          },
          "provider": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "connectorType": {
            "$ref": "#/components/schemas/ConnectorType"
          },
          "connected": {
            "type": "boolean"
          },
          "modificationDateTime": {
            "type": "string",
            "format": "date-time"
          },
          "parametersHelper": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ConnectorParameterHelper"
            }
          }
        }
      },
      "DataSourceAnalysisStatus": {
        "enum": [
          "RulesDeployed",
          "UpdatesAvailable",
          "PartiallyDeployed",
          "NoRulesDeployed"
        ]
      },
      "DefenderIncidentIdentifiers": {
        "type": "object",
        "properties": {
          "incidentId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Defender XDR incident id."
          },
          "tenantId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Entra tenant the Defender incident belongs to, when the vendor reported it."
          },
          "portalUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direct link to the incident in the Microsoft Defender portal."
          }
        },
        "description": "Microsoft Defender XDR's identifiers for an incident."
      },
      "EntityIncidentDto": {
        "type": "object",
        "properties": {
          "creationTime": {
            "type": "string",
            "format": "date-time"
          },
          "number": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "title": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "severity": {
            "$ref": "#/components/schemas/Severity"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "source": {
            "$ref": "#/components/schemas/IncidentSource"
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "classificationComment": {
            "type": [
              "null",
              "string"
            ]
          },
          "classification": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Classification"
              }
            ]
          }
        }
      },
      "EntityType": {
        "enum": [
          "User",
          "IP",
          "File",
          "Process",
          "Device",
          "Malware",
          "CloudApplication",
          "DomainName",
          "AzureResource",
          "FileHash",
          "RegistryKey",
          "RegistryValue",
          "SecurityGroup",
          "URL",
          "IoTDevice",
          "Mailbox",
          "MailCluster",
          "MailMessage",
          "Submission",
          "SentinelEntities",
          "DnsResolution",
          "Registry",
          "OAuthApplication",
          "AmazonResource",
          "BlobContainer",
          "Blob",
          "Container",
          "ContainerRegistry",
          "ContainerImage",
          "GoogleCloudResource",
          "KubernetesCluster",
          "KubernetesController",
          "KubernetesNamespace",
          "KubernetesPod",
          "KubernetesService",
          "KubernetesSecret",
          "KubernetesServiceAccount",
          "AnalyzedMessage",
          "DNS",
          "Unknown"
        ]
      },
      "ExportAuditResponse": {
        "required": [
          "value"
        ],
        "type": "object",
        "properties": {
          "value": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "One workspace audit event in the machine-export shape.",
              "$ref": "#/components/schemas/ExportedAuditEventDto"
            },
            "description": "The audit events in this page."
          },
          "nextPageToken": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL-safe token for the next page, or `null` when this is the last page."
          }
        },
        "description": "Response envelope for the workspace audit-export endpoint."
      },
      "ExportedAuditEventDto": {
        "required": [
          "id",
          "timeGenerated",
          "workspaceId",
          "discriminator",
          "activityType",
          "activityAction",
          "actorId",
          "targetResourceType",
          "targetResourceId"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The audit entry's unique id.",
            "format": "uuid"
          },
          "timeGenerated": {
            "type": "string",
            "description": "When the audited activity happened (UTC).",
            "format": "date-time"
          },
          "workspaceId": {
            "type": "string",
            "description": "The ContraForce workspace the event belongs to.",
            "format": "uuid"
          },
          "discriminator": {
            "type": [
              "null",
              "string"
            ],
            "description": "The audit domain, e.g. `WorkspaceManagement` or `IncidentInvestigation`."
          },
          "activityType": {
            "type": [
              "null",
              "string"
            ],
            "description": "The activity type name, e.g. `WorkspaceRoleChanged`."
          },
          "activityAction": {
            "type": [
              "null",
              "string"
            ],
            "description": "The activity action name, e.g. `Update`."
          },
          "actorId": {
            "type": "string",
            "description": "The id of the user or agent that performed the activity.",
            "format": "uuid"
          },
          "actorName": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display name of the actor, when recorded."
          },
          "actorEmail": {
            "type": [
              "null",
              "string"
            ],
            "description": "The email of the actor, when recorded."
          },
          "targetResourceType": {
            "type": [
              "null",
              "string"
            ],
            "description": "The type of the resource the activity targeted, e.g. `Incident` or `User`."
          },
          "targetResourceId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The id of the resource the activity targeted."
          },
          "targetResourceName": {
            "type": [
              "null",
              "string"
            ],
            "description": "The human-readable name of the target resource, when recorded."
          },
          "metadata": {
            "type": [
              "null",
              "string"
            ],
            "description": "The entry's activity-specific metadata serialized as a JSON string (including its\n`$type` discriminator), or `null` when the entry carries none."
          }
        },
        "description": "One workspace audit event in the machine-export shape."
      },
      "ForbiddenBulkUpdateIncidentDto": {
        "type": "object",
        "properties": {
          "incidentId": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "reason": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "Per-incident rejection detail for a bulk update."
      },
      "GamebookDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "tracingId": {
            "type": [
              "null",
              "string"
            ]
          },
          "incidentId": {
            "type": [
              "null",
              "string"
            ]
          },
          "source": {
            "description": "Source of the system that owns the incident Sentinel, Defender ATP, etc.",
            "$ref": "#/components/schemas/IncidentSource"
          },
          "incidentTitle": {
            "type": [
              "null",
              "string"
            ]
          },
          "incidentNumber": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "isOcr": {
            "type": "boolean"
          },
          "isRecover": {
            "type": "boolean"
          },
          "triggedByUserId": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "modificationDate": {
            "type": "string",
            "format": "date-time"
          },
          "creationDate": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/GamebookRunningStatus"
          },
          "title": {
            "type": [
              "null",
              "string"
            ]
          },
          "isAdminRequired": {
            "type": "boolean"
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceName": {
            "type": [
              "null",
              "string"
            ]
          },
          "tenantId": {
            "type": [
              "null",
              "string"
            ]
          },
          "isAutoRun": {
            "type": "boolean"
          },
          "originalGamebookId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Used if the gamebook is retry gamebook and refers to the id of the gamebook id that has been retried"
          },
          "originalGamebookTitle": {
            "type": [
              "null",
              "string"
            ],
            "description": "Used if the gamebook is retry gamebook and refers to the id of the gamebook title that has been retried"
          },
          "isRetryGamebook": {
            "type": "boolean",
            "description": "Indicator if the gamebook is a retry to failed gamebook"
          },
          "isQueued": {
            "type": "boolean",
            "description": "Indicator if the gamebook is queued by a service provider and it is not started yet"
          },
          "playbooks": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PlaybookGameplanDto"
            }
          },
          "summary": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "GamebookRunningStatus": {
        "enum": [
          "Pending",
          "Running",
          "Finished",
          "Failed",
          "Queued",
          "Denied",
          "Cancelled"
        ]
      },
      "GeneralTableDto": {
        "type": "object",
        "properties": {
          "columns": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "rows": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "array"
            }
          }
        }
      },
      "GetWorkspaceUsersRequest": {
        "required": [
          "accountId"
        ],
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "query": {
            "type": [
              "null",
              "string"
            ]
          },
          "role": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/WorkspaceRole"
              }
            ]
          }
        }
      },
      "Incident": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional human-readable identifier shown in the table and\npage heading instead of the long opaque string Incident.Id.\nPopulated for sources whose IDs are unwieldy (e.g. CrowdStrike\ncases use a 165-char base64 ID but expose a friendly\n\"`6F1-24`\"-style `reference_id`). When null, callers\nfall back to the existing short-form derivation of\nstring Incident.Id."
          },
          "title": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "number": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "type": {
            "type": [
              "null",
              "string"
            ]
          },
          "source": {
            "$ref": "#/components/schemas/IncidentSource"
          },
          "sourceDisplayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "lastModificationTime": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date/Time represents the user's local time",
            "format": "date-time"
          },
          "creationTime": {
            "type": "string",
            "description": "Date/Time represents the user's local time",
            "format": "date-time"
          },
          "lastActivityTime": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date/Time represents the user's local time",
            "format": "date-time"
          },
          "severity": {
            "$ref": "#/components/schemas/Severity"
          },
          "classification": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Classification"
              }
            ]
          },
          "comment": {
            "type": [
              "null",
              "string"
            ]
          },
          "classificationReason": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/ClassificationReason"
              }
            ]
          },
          "classificationComment": {
            "type": [
              "null",
              "string"
            ]
          },
          "tactics": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "ruleIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Represents the Ids of the related rules of this incidents"
          },
          "providerName": {
            "type": [
              "null",
              "string"
            ],
            "description": "The vendor that generated this incident, as the vendor reports it. Sentinel returns\n\"Azure Sentinel\", \"Microsoft 365 Defender\" or \"Microsoft XDR\"; other sources leave it null."
          },
          "isForwardedMirror": {
            "type": "boolean",
            "description": "True when this incident is the mirror of one that originated in the other Microsoft system, so\nshowing it would put the same real-world incident in the inbox twice."
          },
          "vendorIdentifiers": {
            "description": "The identifiers of every vendor system that holds a record of this incident, for consumers that\nneed to resolve it back to the source vendor.",
            "$ref": "#/components/schemas/IncidentVendorIdentifiers"
          },
          "alertProductNames": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "user": {
            "description": "Represents the user assigned to work on this incident",
            "$ref": "#/components/schemas/UserSummary"
          },
          "isAssigned": {
            "type": "boolean"
          },
          "productId": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "closedUpstreamDuringPause": {
            "type": "boolean",
            "description": "Set by `IncidentsManager.GetByIdAsync` reconciliation when the CF incident is in a\nCF-native pause status (Status.OnHold / Status.WaitingOnCustomer)\nbut the upstream source has reached terminal Closed. The UI uses this to render the\n\"Closed upstream while paused\" badge on the detail header. Not persisted."
          },
          "sourceRecordExpired": {
            "type": "boolean",
            "description": "True when the source no longer holds this incident's record, so only what ContraForce recorded\n(status, classification, owner, comments) can be shown."
          },
          "sourceLinks": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "A labeled link to an incident's record in its source console.",
              "$ref": "#/components/schemas/IncidentSourceLink"
            },
            "description": "Links to this incident in the source's own console, when the source provides them (for\nexample the Sumo Logic monitor and the search behind the alert). Always absolute HTTPS URLs."
          },
          "alertsCount": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "entities": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "This class is used to unify the Entities from different sources into a ContraForce Entity",
              "$ref": "#/components/schemas/IncidentEntity"
            }
          },
          "workspaceName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the workspace in the customer tenant\nThis property is beneficial when the customer has multiple workspaces or when the partner is working under the multi-tenancy mode"
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the workspace in the customer tenant\nThis property is beneficial when the customer has multiple workspaces or when the partner is working under the multi-tenancy mode"
          },
          "isDefenderXDRSourced": {
            "type": "boolean",
            "description": "Determines whether the incident is originally sourced from Microsoft Defender XDR"
          }
        },
        "description": "This incident object built on top of the Microsoft Azure Sentinel Incident and it's open to extend to any new provider"
      },
      "IncidentCommentDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "message": {
            "type": [
              "null",
              "string"
            ]
          },
          "createdTime": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "authorEmail": {
            "type": [
              "null",
              "string"
            ]
          },
          "authorName": {
            "type": [
              "null",
              "string"
            ]
          },
          "isActivityComment": {
            "type": "boolean",
            "description": "Indicates if the comment doesn't represent a written note, instead if just a system activity like status changed, priority changed, user assigned, etc."
          },
          "isAgentComment": {
            "type": "boolean",
            "description": "Indicates if the comment was authored by an AI agent rather than a human analyst."
          },
          "agentName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the agent that authored the comment."
          },
          "isClosingComment": {
            "type": "boolean",
            "description": "Indicates if the comment is the closing comment added when the incident was resolved or closed."
          },
          "ticketNoteId": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the ticket note in the service ticketing system if the comment is related to a ticket note.\n(Nullable) only available if the tenant written this comment has a ticketing system enabled in their configuration."
          },
          "ticketId": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the ticket in the service ticketing system if the comment is related to a ticket note.\n(Nullable) only available if the tenant written this comment has a ticketing system enabled in their configuration."
          }
        }
      },
      "IncidentEntity": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "type": {
            "$ref": "#/components/schemas/EntityType"
          },
          "kind": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "friendlyName": {
            "type": [
              "null",
              "string"
            ]
          },
          "fileName": {
            "type": [
              "null",
              "string"
            ]
          },
          "hostName": {
            "type": [
              "null",
              "string"
            ]
          },
          "accountEntityId": {
            "type": [
              "null",
              "string"
            ]
          },
          "deviceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "deviceAzureId": {
            "type": [
              "null",
              "string"
            ]
          },
          "defenderAtpDeviceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "defenderEndpointDeviceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "networkMessageId": {
            "type": [
              "null",
              "string"
            ]
          },
          "hashAlgorithm": {
            "type": [
              "null",
              "string"
            ]
          },
          "aadUserId": {
            "type": [
              "null",
              "string"
            ]
          },
          "emailAddress": {
            "type": [
              "null",
              "string"
            ]
          },
          "userPrincipalName": {
            "type": [
              "null",
              "string"
            ]
          },
          "ipAddress": {
            "type": [
              "null",
              "string"
            ]
          },
          "fileHash": {
            "type": [
              "null",
              "string"
            ]
          },
          "emailId": {
            "type": [
              "null",
              "string"
            ]
          },
          "emailSubject": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "This class is used to unify the Entities from different sources into a ContraForce Entity"
      },
      "IncidentFlowPointResponse": {
        "type": "object",
        "properties": {
          "date": {
            "type": [
              "null",
              "string"
            ],
            "description": "`yyyy-MM-dd` or `yyyy-MM`."
          },
          "received": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "closed": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "closedBy": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "The bucket's closures by who closed them: `Agent`, `Analyst` or `Upstream`."
          },
          "investigated": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "medianTimeToCloseSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "Median seconds from detection to closure in this bucket, when detections are known.",
            "format": "double"
          }
        },
        "description": "Incident flow totals for one day or month."
      },
      "IncidentFlowReportResponse": {
        "type": "object",
        "properties": {
          "received": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents detected in the range.",
            "format": "int32"
          },
          "closed": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incident closures in the range, counted once per incident per day.",
            "format": "int32"
          },
          "closedBy": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Closures by who closed them: Agent, Analyst or Upstream."
          },
          "investigated": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest agent run finished in the range.",
            "format": "int32"
          },
          "outcomes": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Outcome of each investigated incident's latest run: ResolvedByAgent, Escalated, NoChange, Failed or CompletedNoVerdict."
          },
          "medianTimeToCloseSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "Median seconds from detection to closure, when detections are known.",
            "format": "double"
          },
          "closedBySeverity": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Closures by the incident's severity."
          },
          "closedByRule": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Closures counted under one detection rule.",
              "$ref": "#/components/schemas/ReportingRuleCountResponse"
            },
            "description": "The detection rules with the most closures, most first; each rule is the incident title it is counted under."
          },
          "closedByOtherRules": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Closures under every other rule together; a remainder, never a rule.",
            "format": "int32"
          },
          "granularity": {
            "type": [
              "null",
              "string"
            ],
            "description": "`day` for ranges up to 92 days, otherwise `month`; the grain of List&lt;IncidentFlowPointResponse&gt; IncidentFlowReportResponse.Points."
          },
          "points": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Incident flow totals for one day or month.",
              "$ref": "#/components/schemas/IncidentFlowPointResponse"
            },
            "description": "One point per day or month, oldest first, for the trend behind the totals."
          },
          "read": {
            "description": "How the response was read.",
            "$ref": "#/components/schemas/ReportingReadInfoResponse"
          }
        },
        "description": "v2 incident flow totals for a date range and workspace selection."
      },
      "IncidentGamebooksCatalogDto": {
        "type": "object",
        "properties": {
          "recommended": {
            "$ref": "#/components/schemas/RecommendedGamebookDto"
          },
          "lastGamebook": {
            "$ref": "#/components/schemas/GamebookDto"
          },
          "isPreviousRunAvailable": {
            "type": "boolean",
            "description": "Indicates if the last Gamebook Run is available"
          },
          "isRecommendedAvailable": {
            "type": "boolean",
            "description": "Indicates if the recommended Gamebook is available"
          },
          "aiRecommendedAvailable": {
            "type": "boolean",
            "description": "Indicator if there is a recommended Gamebook by ContraForce"
          },
          "serviceProviderRecommendedAvailable": {
            "type": "boolean",
            "description": "Indicator if there is a recommended Gamebook by the Service Provider"
          }
        },
        "description": "Contains the recommended gamebooks by ContraForce or the Service Provider, in addition to the last Gamebook Run associated with an Incident"
      },
      "IncidentInvestigationDetailsDto": {
        "type": "object",
        "properties": {
          "entities": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "DTO that is being used for the investigation graph while retrieving the related entity of an node",
              "$ref": "#/components/schemas/InvestigationEntityDto"
            }
          },
          "alerts": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "DTO that is being used for the investigation graph while retrieving the related Alerts of an entity",
              "$ref": "#/components/schemas/InvestigationAlertDto"
            }
          },
          "incident": {
            "description": "This incident object built on top of the Microsoft Azure Sentinel Incident and it's open to extend to any new provider",
            "$ref": "#/components/schemas/Incident"
          },
          "incidentComment": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/IncidentCommentDto"
            }
          }
        }
      },
      "IncidentReference": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "source": {
            "$ref": "#/components/schemas/IncidentSource"
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "number": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "IncidentsByEntityResultDto": {
        "type": "object",
        "properties": {
          "incidents": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/EntityIncidentDto"
            }
          }
        }
      },
      "IncidentSource": {
        "enum": [
          "Sentinel",
          "DefenderXDR",
          "QRadar",
          "Splunk",
          "CrowdStrike",
          "SentinelOne",
          "SumoLogic"
        ]
      },
      "IncidentSourceLink": {
        "type": "object",
        "properties": {
          "label": {
            "type": [
              "null",
              "string"
            ],
            "description": "What the link opens, for example \"Monitor\" or \"Search\"."
          },
          "url": {
            "type": [
              "null",
              "string"
            ],
            "description": "Absolute HTTPS URL; producers validate it before setting it."
          }
        },
        "description": "A labeled link to an incident's record in its source console."
      },
      "IncidentVendorIdentifiers": {
        "type": "object",
        "properties": {
          "sentinel": {
            "description": "Sentinel's identifiers for this incident, when it exists in Sentinel.",
            "$ref": "#/components/schemas/SentinelIncidentIdentifiers"
          },
          "defender": {
            "description": "Defender XDR's identifiers for this incident, when it exists in Defender XDR.",
            "$ref": "#/components/schemas/DefenderIncidentIdentifiers"
          }
        },
        "description": "The identifiers of every vendor system that holds a record of one incident, carried together so an\nexternal consumer can resolve the incident back to whichever system it standardizes on."
      },
      "IngestIncidentRequest": {
        "required": [
          "incidentArmId"
        ],
        "type": "object",
        "properties": {
          "incidentArmId": {
            "type": "string",
            "description": "Full Azure Resource Manager id of the Sentinel incident, taken from the playbook trigger."
          },
          "incidentTitle": {
            "type": [
              "null",
              "string"
            ],
            "description": "Incident title from the trigger. Accepted for compatibility; not forwarded downstream."
          },
          "severity": {
            "type": [
              "null",
              "string"
            ],
            "description": "Incident severity from the trigger, forwarded to the pipeline only as a hint."
          },
          "workspaceId": {
            "type": "string",
            "description": "The Sentinel (Log Analytics) workspace GUID from the trigger. Accepted for compatibility;\nthe ContraForce workspace used for authorization is taken from the route, not this value.",
            "format": "uuid"
          }
        },
        "description": "v2 request body for ingesting a Microsoft Sentinel incident from a customer's Content Hub playbook."
      },
      "InvestigationAlertDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "kind": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "alertName": {
            "type": [
              "null",
              "string"
            ]
          },
          "vendorName": {
            "type": [
              "null",
              "string"
            ]
          },
          "type": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "timeGenerated": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "tactics": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "severity": {
            "type": [
              "null",
              "string"
            ]
          },
          "productName": {
            "type": [
              "null",
              "string"
            ]
          },
          "deviceId": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "DTO that is being used for the investigation graph while retrieving the related Alerts of an entity"
      },
      "InvestigationEntityDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "fileName": {
            "type": [
              "null",
              "string"
            ]
          },
          "fileHash": {
            "type": [
              "null",
              "string"
            ]
          },
          "type": {
            "$ref": "#/components/schemas/EntityType"
          },
          "friendlyName": {
            "type": [
              "null",
              "string"
            ]
          },
          "hostName": {
            "type": [
              "null",
              "string"
            ]
          },
          "kind": {
            "type": [
              "null",
              "string"
            ]
          },
          "accountEntityId": {
            "type": [
              "null",
              "string"
            ]
          },
          "networkMessageId": {
            "type": [
              "null",
              "string"
            ]
          },
          "commandLine": {
            "type": [
              "null",
              "string"
            ]
          },
          "userUpn": {
            "type": [
              "null",
              "string"
            ]
          },
          "deviceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "aadUserId": {
            "type": [
              "null",
              "string"
            ]
          },
          "internetMessageId": {
            "type": [
              "null",
              "string"
            ]
          },
          "entityType": {
            "$ref": "#/components/schemas/PlaybookEntityType"
          },
          "isValidEntraIdUser": {
            "type": "boolean",
            "description": "True if the user is a Microsoft Entra ID user (AAD), false indicates that the user is a local user"
          },
          "isValidEntraIdDevice": {
            "type": "boolean",
            "description": "True if the device is a Microsoft Entra ID joined-device (AAD), false indicates that the device is a local device"
          }
        },
        "description": "DTO that is being used for the investigation graph while retrieving the related entity of an node"
      },
      "JiraIssueTypeResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Issue type id."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Issue type name."
          },
          "projectId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Project the issue type belongs to."
          },
          "subtask": {
            "type": "boolean",
            "description": "Whether the issue type is a subtask type."
          }
        },
        "description": "v2 view of a Jira issue type."
      },
      "JiraPriorityResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Priority id."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Priority name."
          }
        },
        "description": "v2 view of a Jira priority."
      },
      "JiraProjectResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Project id."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Project name."
          },
          "key": {
            "type": [
              "null",
              "string"
            ],
            "description": "Project key."
          }
        },
        "description": "v2 view of a Jira Service Management project."
      },
      "JiraRequestTypeResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Request type id."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Request type name."
          }
        },
        "description": "v2 view of a Jira Service Management request type."
      },
      "JiraStatusResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Status id."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Status name."
          }
        },
        "description": "v2 view of a Jira issue status."
      },
      "JiraTicketPriorityUpdateRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "priorityId": {
            "type": [
              "null",
              "string"
            ]
          },
          "priorityName": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "JiraTicketResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Jira issue id."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Issue description."
          },
          "summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "Issue summary."
          },
          "number": {
            "type": [
              "null",
              "string"
            ],
            "description": "Issue key as Jira shows it."
          },
          "currentStatus": {
            "description": "Current issue status.",
            "$ref": "#/components/schemas/JiraStatusResponse"
          },
          "priority": {
            "description": "Issue priority.",
            "$ref": "#/components/schemas/JiraPriorityResponse"
          },
          "assignee": {
            "description": "User the issue is assigned to, if any.",
            "$ref": "#/components/schemas/JiraUserResponse"
          },
          "project": {
            "description": "Service desk project the issue belongs to.",
            "$ref": "#/components/schemas/JiraProjectResponse"
          },
          "issueType": {
            "description": "Issue type.",
            "$ref": "#/components/schemas/JiraIssueTypeResponse"
          },
          "requestType": {
            "description": "Service desk request type.",
            "$ref": "#/components/schemas/JiraRequestTypeResponse"
          },
          "labels": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Issue labels."
          },
          "availablePriorities": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "v2 view of a Jira priority.",
              "$ref": "#/components/schemas/JiraPriorityResponse"
            },
            "description": "Priorities the issue can be set to."
          },
          "availableStatuses": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "v2 view of a Jira issue status.",
              "$ref": "#/components/schemas/JiraStatusResponse"
            },
            "description": "Statuses the issue can move to from its current status."
          }
        },
        "description": "v2 view of a Jira Service Management issue linked as a ticket."
      },
      "JiraUserResponse": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Atlassian account id."
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name."
          },
          "active": {
            "type": "boolean",
            "description": "Whether the account is active."
          }
        },
        "description": "v2 view of a Jira user."
      },
      "LinkServiceTicketRequest": {
        "type": "object",
        "properties": {
          "ticketId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Record id of the ticket in the connected ticketing system: the ServiceNow `sys_id`, the Jira issue id or key, or the numeric Autotask ticket id. Ticket numbers such as `INC0049162` are not accepted; resolve them with `GET tickets/search?ticketNumber=` and send the returned `id`.",
            "examples": [
              "9d385017c611228701d22104cc95c371"
            ]
          },
          "incident": {
            "$ref": "#/components/schemas/IncidentReference"
          }
        }
      },
      "ListGamebooksResultDto": {
        "type": "object",
        "properties": {
          "gamebooks": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/GamebookDto"
            }
          },
          "pageToken": {
            "type": [
              "null",
              "string"
            ]
          },
          "totalCount": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          }
        }
      },
      "ListIncidentsAcrossWorkspacesRequest": {
        "type": "object",
        "properties": {
          "severities": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/Severity"
            },
            "description": "Filter incidents to only the listed severities. Empty list returns all severities."
          },
          "statuses": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/Status"
            },
            "description": "Filter incidents to only the listed statuses. Empty list returns all statuses."
          },
          "timeFilterSelection": {
            "description": "Time window applied to the incident's creation time, or to its last-modified time when `filterByLastModified` is `true`. Defaults to the last 24 hours.",
            "$ref": "#/components/schemas/TimeFilterSelection"
          },
          "filterByLastModified": {
            "type": "boolean",
            "description": "When `true`, `timeFilterSelection` bounds the incident's last-modified time instead of its creation time, and each page is ordered by last-modified time descending. Use this to synchronise updates into an external system: poll a short window that ends at the time of the call and receive every incident whose Microsoft Sentinel or Microsoft Defender XDR record changed in that window (alert grouped in, severity, status, owner, label, comment), including incidents created long before the window. An incident created inside the window but modified after its end is not in this window; it appears in the next one. In this mode each workspace's window is returned in full in one call unless it exceeds the server's page cap; if `moreIncidentsAvailable` is `true`, narrow the window rather than paging, because vendor continuations are positional and a concurrent edit can shift them. The timestamp is the vendor's (`lastModifiedTimeUtc` / `lastUpdateDateTime`), not `lastActivityTime`. Supported for `Sentinel` and `DefenderXDR` only: an empty `sources` list selects those two, and listing any other source together with this flag returns 400."
          },
          "workspacePageTokens": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Opaque continuation tokens for a single workspace, partitioned by incident source.",
              "$ref": "#/components/schemas/WorkspaceSourcePageTokens"
            },
            "description": "Opaque pagination tokens echoed from the previous response's `SourcePageTokens`.\nLeave empty on the first call. See type-level remarks for the pagination protocol."
          },
          "query": {
            "type": [
              "null",
              "string"
            ],
            "description": "Free-text search applied across incident title/description fields. Empty matches all."
          },
          "isFirstCall": {
            "type": "boolean",
            "description": "`true` for the initial request; `false` when echoing\n        List&lt;WorkspaceSourcePageTokens&gt; ListIncidentsAcrossWorkspacesRequest.WorkspacePageTokens back for subsequent pages. See type-level\n        remarks for the pagination protocol."
          },
          "sources": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/IncidentSource"
            },
            "description": "Filter incidents to only the listed sources (e.g. Sentinel, DefenderXDR,\nCrowdStrike). Empty list returns all sources the caller has access to."
          },
          "assigneeIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Filter incidents assigned to any of the listed ContraForce user IDs."
          },
          "assigneeEmails": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Filter incidents assigned to any of the listed user email addresses."
          },
          "includeUnassigned": {
            "type": "boolean",
            "description": "When `true`, include incidents that have no assignee alongside any\nmatches from List&lt;string&gt; ListIncidentsAcrossWorkspacesRequest.AssigneeIds / List&lt;string&gt; ListIncidentsAcrossWorkspacesRequest.AssigneeEmails."
          }
        },
        "description": "v2 request for listing incidents across multiple workspaces."
      },
      "ListIncidentsForWorkspacesResultDto": {
        "type": "object",
        "properties": {
          "incidents": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "This incident object built on top of the Microsoft Azure Sentinel Incident and it's open to extend to any new provider",
              "$ref": "#/components/schemas/Incident"
            },
            "description": "Incidents returned for this page across all workspaces and sources the caller\nhas access to. Aggregated and merged in time-descending order by the server."
          },
          "sourcePageTokens": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Opaque continuation tokens for a single workspace, partitioned by incident source.",
              "$ref": "#/components/schemas/WorkspaceSourcePageTokens"
            },
            "description": "Opaque per-workspace, per-source continuation tokens for fetching the next\npage. Pass this value verbatim as `WorkspacePageTokens` on the next\nrequest along with `IsFirstCall = false`."
          },
          "moreIncidentsAvailable": {
            "type": "boolean",
            "description": "`true` when at least one workspace/source still has additional pages.\n        When `false`, the caller has consumed the full result set and may stop\n        paging."
          }
        },
        "description": "Wraps the result of listing incidents for multiple workspaces in the multi-tenancy mode."
      },
      "ListMultipleWorkspacesGeneralRequestDto": {
        "type": "object",
        "properties": {
          "workspaceIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "timeFilterSelection": {
            "description": "Canonical representation of a global time filter.\nWhen Type == Custom, CustomStartUtc and CustomEndUtc must be provided (UTC).",
            "$ref": "#/components/schemas/TimeFilterSelection"
          }
        }
      },
      "NetworkSecurityGroupDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "location": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "OrganizationalRole": {
        "enum": [
          "Admin",
          "UserAdmin",
          "WorkspaceAdmin",
          "AgentAdmin",
          "Member",
          "OrgContentOperator",
          "OrgContentAdmin"
        ]
      },
      "PagedResultOfWebhookDeliveryLogDto": {
        "type": "object",
        "properties": {
          "items": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WebhookDeliveryLogDto"
            }
          },
          "continuationToken": {
            "type": [
              "null",
              "string"
            ]
          },
          "hasMore": {
            "type": "boolean"
          }
        },
        "description": "Represents a page of results with a token to load more."
      },
      "PageListOfGamebookDto": {
        "type": "object",
        "properties": {
          "items": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/GamebookDto"
            }
          },
          "currentPage": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "totalPages": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "pageSize": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "totalCount": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "hasPreviousPage": {
            "type": "boolean"
          },
          "hasNextPage": {
            "type": "boolean"
          }
        }
      },
      "PaginatedApiResponseOfServiceTicketResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "v2 view of an incident's service ticket in the workspace's connected ticketing system.",
              "$ref": "#/components/schemas/ServiceTicketResponse"
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationInfo"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        },
        "description": "Standard v2 API response envelope for paginated list responses."
      },
      "PaginationInfo": {
        "type": "object",
        "properties": {
          "continuationToken": {
            "type": [
              "null",
              "string"
            ]
          },
          "hasMore": {
            "type": "boolean"
          }
        }
      },
      "PlaybookEntityType": {
        "enum": [
          "User",
          "Endpoint",
          "General",
          "Network",
          "Email"
        ]
      },
      "PlaybookGameplanDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "referenceId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable identity of a plan item — the playbook id combined with the target it acts on.\nUsed for the gamebook plan's de-duplication, equality, and the V2 list `@key`."
          },
          "entityId": {
            "type": [
              "null",
              "string"
            ]
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "userObjectId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Azure AD object id (GUID) of the user/mailbox a playbook should act on, supplied\ndirectly by the caller instead of being resolved from the incident's entities."
          },
          "userPrincipalName": {
            "type": [
              "null",
              "string"
            ],
            "description": "User principal name (UPN) of the user/mailbox a playbook should act on, supplied\ndirectly by the caller instead of being resolved from the incident's entities."
          },
          "internetMessageId": {
            "type": [
              "null",
              "string"
            ],
            "description": "RFC 2822 internet message id of the email an email playbook should act on, supplied\ndirectly by the caller instead of being read from the incident's email entity."
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "entityType": {
            "$ref": "#/components/schemas/PlaybookEntityType"
          },
          "affectedEntity": {
            "type": [
              "null",
              "string"
            ]
          },
          "isRecommended": {
            "type": "boolean"
          },
          "status": {
            "$ref": "#/components/schemas/PlaybookRunningStatus"
          },
          "errorMessage": {
            "type": [
              "null",
              "string"
            ]
          },
          "sequence": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "modificationDate": {
            "type": "string",
            "format": "date-time"
          },
          "startingDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "finishingDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "executionTime": {
            "type": [
              "null",
              "string"
            ],
            "description": "Total execution time taken to execute the playbook, the value is null until the DateTime? PlaybookGameplanDto.FinishingDate property is populated"
          },
          "tracingId": {
            "type": [
              "null",
              "string"
            ]
          },
          "parameters": {
            "type": [
              "null",
              "object"
            ],
            "description": "Represents the parameters of the playbooks to be sent in the message\nThe value will be populated only if the playbook is configurable (Block IP)"
          },
          "isAdminRequired": {
            "type": "boolean"
          }
        }
      },
      "PlaybookMetadataDto": {
        "type": "object",
        "properties": {
          "playbookId": {
            "type": [
              "null",
              "string"
            ]
          },
          "playbookName": {
            "type": [
              "null",
              "string"
            ]
          },
          "playbookDescription": {
            "type": [
              "null",
              "string"
            ]
          },
          "incidentTitle": {
            "type": [
              "null",
              "string"
            ]
          },
          "entity": {
            "type": [
              "null",
              "string"
            ]
          },
          "sentinelEntities": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "recoverPlaybookId": {
            "type": [
              "null",
              "string"
            ]
          },
          "isAdminRequired": {
            "type": "boolean"
          }
        }
      },
      "PlaybookRunningStatus": {
        "enum": [
          "Pending",
          "Running",
          "Finished",
          "Failed",
          "Terminated"
        ]
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": [
              "null",
              "string"
            ]
          },
          "title": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "detail": {
            "type": [
              "null",
              "string"
            ]
          },
          "instance": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "ProvisionSentinelIngestRequest": {
        "type": "object",
        "properties": {
          "workspaceIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The customer workspaces (ContraForce accounts) to onboard onto the ingest credential."
          }
        },
        "description": "Request to provision (or reuse) the platform-managed Sentinel Content Hub ingest credential and add one or\nmore customer workspaces to it. The service-provider org is taken from the authenticated identity."
      },
      "RecommendedGamebookDto": {
        "type": "object",
        "properties": {
          "aiGamebook": {
            "$ref": "#/components/schemas/GamebookDto"
          },
          "serviceProviderGamebook": {
            "$ref": "#/components/schemas/GamebookDto"
          }
        }
      },
      "RedeliverErrorCode": {
        "enum": [
          "NotFailed",
          "AlreadyRedelivered",
          "NotRebuildable",
          "SourceUnavailable",
          "ConfigNotFound",
          "ConfigNotActive",
          null
        ]
      },
      "RedeliverWebhookCommandResult": {
        "type": "object",
        "properties": {
          "isSuccess": {
            "type": "boolean"
          },
          "result": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/RedeliverWebhookResult"
              }
            ]
          },
          "errorReason": {
            "type": [
              "null",
              "string"
            ]
          },
          "errorCode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/RedeliverErrorCode"
              }
            ]
          }
        }
      },
      "RedeliverWebhookResult": {
        "type": "object",
        "properties": {
          "webhookConfigurationId": {
            "type": "string",
            "format": "uuid"
          },
          "webhookConfigurationName": {
            "type": [
              "null",
              "string"
            ]
          },
          "originalDeliveryLogId": {
            "type": "string",
            "format": "uuid"
          },
          "eventId": {
            "type": "string",
            "format": "uuid"
          },
          "message": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "ReportingByWorkspaceRequest": {
        "required": [
          "metric",
          "from",
          "to"
        ],
        "type": "object",
        "properties": {
          "metric": {
            "type": [
              "null",
              "string"
            ],
            "description": "The metric to rank the workspaces by: `received`, `closed`, `investigated`, `actions`,\n`breached` or `atRisk`."
          },
          "top": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "How many workspaces to name before the remainder, from 1 to 10; 6 when omitted.",
            "format": "int32"
          },
          "from": {
            "type": "string",
            "description": "The first day of the range, inclusive (UTC days). A range spans at most 366 days.",
            "format": "date"
          },
          "to": {
            "type": "string",
            "description": "The last day of the range, inclusive (UTC days).",
            "format": "date"
          },
          "workspaceIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The workspaces to read, at most 500; `null` or empty reads every workspace the caller may see. A service\naccount sees the workspaces it holds a role on."
          }
        },
        "description": "One metric by workspace over the range."
      },
      "ReportingFactActorResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "Who did something."
      },
      "ReportingFactIncidentResponse": {
        "type": "object",
        "properties": {
          "source": {
            "type": [
              "null",
              "string"
            ]
          },
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "number": {
            "type": [
              "null",
              "string"
            ]
          },
          "severity": {
            "type": [
              "null",
              "string"
            ]
          },
          "title": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "The incident a fact is about."
      },
      "ReportingFactRowResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "type": {
            "type": [
              "null",
              "string"
            ],
            "description": "The fact type, for example `closure` or `investigation`."
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "day": {
            "type": [
              "null",
              "string"
            ],
            "description": "`yyyy-MM-dd`, UTC."
          },
          "eventAt": {
            "type": "string",
            "format": "date-time"
          },
          "incident": {
            "description": "The incident a fact is about.",
            "$ref": "#/components/schemas/ReportingFactIncidentResponse"
          },
          "closerType": {
            "type": [
              "null",
              "string"
            ]
          },
          "closer": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Who did something.",
                "$ref": "#/components/schemas/ReportingFactActorResponse"
              }
            ]
          },
          "classification": {
            "type": [
              "null",
              "string"
            ]
          },
          "reason": {
            "type": [
              "null",
              "string"
            ]
          },
          "timeToCloseSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "format": "double"
          },
          "executionId": {
            "type": [
              "null",
              "string"
            ]
          },
          "agent": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Who did something.",
                "$ref": "#/components/schemas/ReportingFactActorResponse"
              }
            ]
          },
          "outcome": {
            "type": [
              "null",
              "string"
            ]
          },
          "verdictClassification": {
            "type": [
              "null",
              "string"
            ]
          },
          "durationSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "format": "double"
          },
          "costUsd": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "What the run cost; withheld from a caller who may not see the organization's spend.",
            "format": "double"
          },
          "isLatestForIncident": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "signal": {
            "type": [
              "null",
              "string"
            ]
          },
          "countsTowardAccuracy": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "slaType": {
            "type": [
              "null",
              "string"
            ]
          },
          "result": {
            "type": [
              "null",
              "string"
            ]
          },
          "elapsedSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "format": "double"
          },
          "targetSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "format": "double"
          },
          "kind": {
            "type": [
              "null",
              "string"
            ]
          },
          "fromTier": {
            "type": [
              "null",
              "string"
            ]
          },
          "toTier": {
            "type": [
              "null",
              "string"
            ]
          },
          "assigneeId": {
            "type": [
              "null",
              "string"
            ]
          },
          "isFirstAssignment": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "timeToFirstAssignmentSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "format": "double"
          },
          "actionType": {
            "type": [
              "null",
              "string"
            ],
            "description": "The response action, such as `Isolate-Endpoint`."
          },
          "entityType": {
            "type": [
              "null",
              "string"
            ]
          },
          "actor": {
            "type": [
              "null",
              "string"
            ],
            "description": "Who requested a response action: `Agent`, `Automation` or `Analyst`."
          },
          "startedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "description": "One fact. The fields every fact has, plus the fields of its own type; the fields of other types are null."
      },
      "ReportingFactsColumnResponse": {
        "required": [
          "header",
          "kind"
        ],
        "type": "object",
        "properties": {
          "header": {
            "type": [
              "null",
              "string"
            ]
          },
          "kind": {
            "type": [
              "null",
              "string"
            ],
            "description": "string ReportingFactsColumnResponse.Text, string ReportingFactsColumnResponse.Number or string ReportingFactsColumnResponse.Time."
          }
        },
        "description": "One column of a ReportingFactsTableResponse."
      },
      "ReportingFactsExportRequest": {
        "required": [
          "type",
          "from",
          "to"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": [
              "null",
              "string"
            ],
            "description": "The fact type: `detection`, `closure`, `investigation`, `feedback`, `sla-result`,\n`sla-transition`, `assignment` or `response-action`."
          },
          "closerType": {
            "type": [
              "null",
              "string"
            ],
            "description": "Closure facts only: who closed the incident."
          },
          "outcome": {
            "type": [
              "null",
              "string"
            ],
            "description": "Investigation and response-action facts only: how the run ended."
          },
          "severity": {
            "type": [
              "null",
              "string"
            ],
            "description": "The incident's severity."
          },
          "verdict": {
            "type": [
              "null",
              "string"
            ],
            "description": "Investigation facts only: the agent's verdict."
          },
          "rule": {
            "type": [
              "null",
              "string"
            ],
            "description": "Closure facts only: the rule, as the incident title."
          },
          "slaType": {
            "type": [
              "null",
              "string"
            ],
            "description": "SLA state changes only: the clock, `Slo` or `Mttr`."
          },
          "tier": {
            "type": [
              "null",
              "string"
            ],
            "description": "SLA state changes only: the tier the clock moved to, `AtRisk`, `Breached` or `Met`."
          },
          "from": {
            "type": "string",
            "description": "The first day of the range, inclusive (UTC days). A range spans at most 366 days.",
            "format": "date"
          },
          "to": {
            "type": "string",
            "description": "The last day of the range, inclusive (UTC days).",
            "format": "date"
          },
          "workspaceIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The workspaces to read, at most 500; `null` or empty reads every workspace the caller may see. A service\naccount sees the workspaces it holds a role on."
          }
        },
        "description": "One fact type over the range with its optional filters: every row, as the export reads them."
      },
      "ReportingFactsPageRequest": {
        "required": [
          "type",
          "from",
          "to"
        ],
        "type": "object",
        "properties": {
          "pageSize": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Rows per page, from 1 to 200; 50 when omitted. A page can hold fewer rows while a token remains.",
            "format": "int32"
          },
          "continuationToken": {
            "type": [
              "null",
              "string"
            ],
            "description": "The previous page's token; omitted for the first page."
          },
          "type": {
            "type": [
              "null",
              "string"
            ],
            "description": "The fact type: `detection`, `closure`, `investigation`, `feedback`, `sla-result`,\n`sla-transition`, `assignment` or `response-action`."
          },
          "closerType": {
            "type": [
              "null",
              "string"
            ],
            "description": "Closure facts only: who closed the incident."
          },
          "outcome": {
            "type": [
              "null",
              "string"
            ],
            "description": "Investigation and response-action facts only: how the run ended."
          },
          "severity": {
            "type": [
              "null",
              "string"
            ],
            "description": "The incident's severity."
          },
          "verdict": {
            "type": [
              "null",
              "string"
            ],
            "description": "Investigation facts only: the agent's verdict."
          },
          "rule": {
            "type": [
              "null",
              "string"
            ],
            "description": "Closure facts only: the rule, as the incident title."
          },
          "slaType": {
            "type": [
              "null",
              "string"
            ],
            "description": "SLA state changes only: the clock, `Slo` or `Mttr`."
          },
          "tier": {
            "type": [
              "null",
              "string"
            ],
            "description": "SLA state changes only: the tier the clock moved to, `AtRisk`, `Breached` or `Met`."
          },
          "from": {
            "type": "string",
            "description": "The first day of the range, inclusive (UTC days). A range spans at most 366 days.",
            "format": "date"
          },
          "to": {
            "type": "string",
            "description": "The last day of the range, inclusive (UTC days).",
            "format": "date"
          },
          "workspaceIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The workspaces to read, at most 500; `null` or empty reads every workspace the caller may see. A service\naccount sees the workspaces it holds a role on."
          }
        },
        "description": "One page of facts: the filters, plus the page size and where the previous page stopped."
      },
      "ReportingFactsPageResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "One fact. The fields every fact has, plus the fields of its own type; the fields of other types are null.",
              "$ref": "#/components/schemas/ReportingFactRowResponse"
            },
            "description": "The rows, workspace by workspace and month by month, newest first within each."
          },
          "continuationToken": {
            "type": [
              "null",
              "string"
            ],
            "description": "Pass back to read the next page; `null` when there is no more. A page can be short while a token remains."
          }
        },
        "description": "One page of reporting facts for a drill-down table."
      },
      "ReportingFactsTableResponse": {
        "type": "object",
        "properties": {
          "columns": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "One column of a ReportingFactsTableResponse.",
              "$ref": "#/components/schemas/ReportingFactsColumnResponse"
            }
          },
          "rows": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "One list of cells per row, in column order; a value the fact does not have is `null`."
          }
        },
        "description": "Every row behind a report, as a table with the columns of its fact type."
      },
      "ReportingReadInfoResponse": {
        "type": "object",
        "properties": {
          "scope": {
            "type": [
              "null",
              "string"
            ],
            "description": "`account` when account-wide totals were read, otherwise `workspaces`."
          },
          "workspaceCount": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Workspaces the response covers.",
            "format": "int32"
          },
          "documentsRead": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Aggregate documents read to build the response (0 when served from cache).",
            "format": "int32"
          },
          "fromCache": {
            "type": "boolean",
            "description": "Whether the response came from the in-memory cache."
          },
          "authorizeMs": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "number",
              "string"
            ],
            "description": "Milliseconds this request spent validating the range and checking workspace access.",
            "format": "double"
          },
          "readMs": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "number",
              "string"
            ],
            "description": "Milliseconds spent loading aggregate documents (0 when served from cache).",
            "format": "double"
          }
        },
        "description": "How a reporting response was read, for load testing and diagnosis."
      },
      "ReportingReadRequest": {
        "required": [
          "from",
          "to"
        ],
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "description": "The first day of the range, inclusive (UTC days). A range spans at most 366 days.",
            "format": "date"
          },
          "to": {
            "type": "string",
            "description": "The last day of the range, inclusive (UTC days).",
            "format": "date"
          },
          "workspaceIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The workspaces to read, at most 500; `null` or empty reads every workspace the caller may see. A service\naccount sees the workspaces it holds a role on."
          }
        },
        "description": "The day range and workspace selection every reporting read takes."
      },
      "ReportingRuleCountResponse": {
        "required": [
          "rule",
          "closed"
        ],
        "type": "object",
        "properties": {
          "rule": {
            "type": [
              "null",
              "string"
            ],
            "description": "The incident title the closures are counted under; pass it as `rule` to open them."
          },
          "closed": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Closures in the range.",
            "format": "int32"
          }
        },
        "description": "Closures counted under one detection rule."
      },
      "ResponseActionsPointResponse": {
        "type": "object",
        "properties": {
          "date": {
            "type": [
              "null",
              "string"
            ],
            "description": "`yyyy-MM-dd` or `yyyy-MM`."
          },
          "actions": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "byOutcome": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Actions per outcome, as Dictionary&lt;string, int&gt; ResponseActionsReportResponse.ByOutcome counts them."
          }
        },
        "description": "v2 response actions for one day or month."
      },
      "ResponseActionsReportResponse": {
        "type": "object",
        "properties": {
          "actions": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Every action that reached a terminal state, including ones denied or cancelled before running.",
            "format": "int32"
          },
          "succeeded": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "failed": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "runs": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Distinct gamebook runs the actions came from.",
            "format": "int32"
          },
          "byType": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Actions per action type, such as `Isolate-Endpoint`."
          },
          "byActor": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Actions per actor: `Agent`, `Automation` or `Analyst`."
          },
          "byOutcome": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Actions per outcome: `Succeeded`, `Failed`, `Denied`, `Cancelled` or `Terminated`."
          },
          "byEntityType": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "Actions per kind of entity acted on."
          },
          "medianDurationSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "Median seconds an action that ran took; actions that never ran are excluded.",
            "format": "double"
          },
          "granularity": {
            "type": [
              "null",
              "string"
            ],
            "description": "`day` for ranges up to 92 days, otherwise `month`; the grain of IReadOnlyList&lt;ResponseActionsPointResponse&gt; ResponseActionsReportResponse.Points."
          },
          "points": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "v2 response actions for one day or month.",
              "$ref": "#/components/schemas/ResponseActionsPointResponse"
            },
            "description": "Actions per day or month by outcome, oldest first."
          },
          "read": {
            "description": "How the response was read.",
            "$ref": "#/components/schemas/ReportingReadInfoResponse"
          }
        },
        "description": "v2 response actions for a date range and workspace selection."
      },
      "ResponseMeta": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": [
              "null",
              "string"
            ]
          },
          "timestamp": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "RunGamebookEntityType": {
        "enum": [
          "User",
          "Endpoint",
          "General",
          "Network",
          "Email"
        ],
        "description": "Action categories supported by the v2 gamebook submission contract."
      },
      "RunGamebookPlaybookRequest": {
        "required": [
          "id",
          "entityType",
          "sequence"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Playbook identifier from the catalog."
          },
          "entityId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Exact incident entity identifier. General actions do not require a target."
          },
          "entityType": {
            "description": "Action category matching the playbook catalog, not the incident entity kind.",
            "$ref": "#/components/schemas/RunGamebookEntityType"
          },
          "sequence": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "One-based execution position; the complete plan must contain exactly 1..N.",
            "format": "int32"
          },
          "parameters": {
            "type": [
              "null",
              "object"
            ],
            "description": "Optional action configuration, such as the network resource settings for Block IP."
          }
        },
        "additionalProperties": false,
        "description": "Public v2 inputs for one catalog action and its incident target."
      },
      "RunGamebookRequest": {
        "required": [
          "incidentId",
          "incidentTitle",
          "source",
          "playbooks"
        ],
        "type": "object",
        "properties": {
          "incidentId": {
            "type": "string",
            "description": "Incident identifier in the authorized route workspace."
          },
          "incidentTitle": {
            "type": "string",
            "description": "Required non-empty incident display title."
          },
          "incidentNumber": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Optional incident display number.",
            "format": "int32"
          },
          "source": {
            "description": "Detection source of the incident.",
            "$ref": "#/components/schemas/IncidentSource"
          },
          "isQueued": {
            "type": "boolean",
            "description": "Requests human approval. False never overrides server-side approval requirements."
          },
          "playbooks": {
            "type": "array",
            "items": {
              "description": "Public v2 inputs for one catalog action and its incident target.",
              "$ref": "#/components/schemas/RunGamebookPlaybookRequest"
            },
            "description": "Actions with unique, contiguous sequence values from 1 through the number of actions."
          }
        },
        "additionalProperties": false,
        "description": "Public v2 inputs for a new gamebook submission, without portal approval or executor state."
      },
      "RunGamebookResponse": {
        "required": [
          "id",
          "status",
          "isQueued"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the submitted gamebook, for subsequent history lookups."
          },
          "status": {
            "description": "Current execution status of the submitted gamebook.",
            "$ref": "#/components/schemas/RunGamebookStatus"
          },
          "isQueued": {
            "type": "boolean",
            "description": "Whether the gamebook is waiting for portal approval rather than executing."
          }
        },
        "description": "Public result of submitting a gamebook, without workspace or incident target details."
      },
      "RunGamebookStatus": {
        "enum": [
          "Pending",
          "Running",
          "Finished",
          "Failed",
          "Queued",
          "Denied",
          "Cancelled"
        ],
        "description": "Execution states exposed by the public v2 gamebook submission result."
      },
      "SendTestWebhookResult": {
        "type": "object",
        "properties": {
          "webhookConfigurationId": {
            "type": "string",
            "format": "uuid"
          },
          "webhookConfigurationName": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventId": {
            "type": "string",
            "format": "uuid"
          },
          "message": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "Result returned after a test webhook has been queued for delivery."
      },
      "SentinelIncidentIdentifiers": {
        "type": "object",
        "properties": {
          "armId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The full ARM resource id, e.g.\n`/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.OperationalInsights/workspaces/{ws}/providers/Microsoft.SecurityInsights/incidents/{guid}`."
          },
          "incidentId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The incident GUID, the last segment of string SentinelIncidentIdentifiers.ArmId."
          },
          "subscriptionId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Azure subscription holding the Log Analytics workspace."
          },
          "resourceGroupName": {
            "type": [
              "null",
              "string"
            ],
            "description": "The resource group holding the Log Analytics workspace."
          },
          "workspaceName": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Log Analytics workspace name."
          },
          "incidentNumber": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "The incident's number within the Sentinel workspace, when known.",
            "format": "int32"
          },
          "portalUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direct link to the incident in the Microsoft Sentinel portal."
          }
        },
        "description": "Microsoft Sentinel's identifiers for an incident."
      },
      "SentinelIngestDeploymentCardDto": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "string",
            "description": "The client id every playbook authenticates with (the managed service account id, shared org-wide).",
            "format": "uuid"
          },
          "clientSecret": {
            "type": [
              "null",
              "string"
            ],
            "description": "The client secret, shared across all of the organization's workspaces. Returned on every provision so it\ncan be reused when adding a workspace later; the same secret authenticates every playbook. Null only if\nthe credential could not be resolved."
          },
          "credentialAlreadyIssued": {
            "type": "boolean",
            "description": "True when the credential already existed before this call (this provisioning reused it rather than\ncreating it). Informational; the secret is returned either way."
          },
          "workspaces": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "One onboarded workspace and the region-qualified ingest endpoint its playbook posts incidents to.",
              "$ref": "#/components/schemas/SentinelIngestWorkspaceDto"
            },
            "description": "The workspaces onboarded by this call, each with the endpoint its Sentinel playbook posts to."
          }
        },
        "description": "The deployment card the portal shows after provisioning Sentinel Content Hub ingest: the shared client id\nand secret for the organization, plus each onboarded workspace and the endpoint its playbook posts to."
      },
      "SentinelIngestWorkspaceDto": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "workspaceName": {
            "type": [
              "null",
              "string"
            ]
          },
          "ingestUrl": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "One onboarded workspace and the region-qualified ingest endpoint its playbook posts incidents to."
      },
      "ServiceAccountCreatedDto": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "string",
            "format": "uuid"
          },
          "clientSecret": {
            "type": [
              "null",
              "string"
            ]
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "isActive": {
            "type": "boolean"
          },
          "isPlatformManaged": {
            "type": "boolean",
            "description": "True for platform-provisioned service accounts (e.g. the Sentinel Content Hub ingest SA). The UI\nbadges these and hides destructive controls; the API rejects admin mutation of them."
          },
          "organizationalRole": {
            "$ref": "#/components/schemas/OrganizationalRole"
          },
          "clientSecretPrefix": {
            "type": [
              "null",
              "string"
            ]
          },
          "credentialExpirationDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "workspaceAssignments": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkspaceRoleAssignmentDto"
            }
          },
          "credentials": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Represents a single API credential belonging to a service account.",
              "$ref": "#/components/schemas/ServiceAccountCredentialDto"
            }
          },
          "lastUsedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "Returned only on service account creation. Contains the plaintext client secret which is shown once."
      },
      "ServiceAccountCredentialCreatedDto": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "string",
            "format": "uuid"
          },
          "clientSecret": {
            "type": [
              "null",
              "string"
            ]
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "clientSecretPrefix": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/ServiceAccountCredentialStatus"
          },
          "expirationDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "lastUsedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "scopes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "The API scopes granted to this credential."
          }
        },
        "description": "Returned only when a credential is created. Contains the plaintext client secret which is shown once."
      },
      "ServiceAccountCredentialDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "clientSecretPrefix": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/ServiceAccountCredentialStatus"
          },
          "expirationDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "lastUsedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "scopes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "The API scopes granted to this credential."
          }
        },
        "description": "Represents a single API credential belonging to a service account."
      },
      "ServiceAccountCredentialStatus": {
        "enum": [
          "Active",
          "Revoked"
        ]
      },
      "ServiceAccountDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "isActive": {
            "type": "boolean"
          },
          "isPlatformManaged": {
            "type": "boolean",
            "description": "True for platform-provisioned service accounts (e.g. the Sentinel Content Hub ingest SA). The UI\nbadges these and hides destructive controls; the API rejects admin mutation of them."
          },
          "organizationalRole": {
            "$ref": "#/components/schemas/OrganizationalRole"
          },
          "clientSecretPrefix": {
            "type": [
              "null",
              "string"
            ]
          },
          "credentialExpirationDate": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "workspaceAssignments": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkspaceRoleAssignmentDto"
            }
          },
          "credentials": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Represents a single API credential belonging to a service account.",
              "$ref": "#/components/schemas/ServiceAccountCredentialDto"
            }
          },
          "lastUsedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "ServiceNowTicketCommentResponse": {
        "type": "object",
        "properties": {
          "sysId": {
            "type": [
              "null",
              "string"
            ],
            "description": "ServiceNow journal entry sys_id."
          },
          "elementId": {
            "type": [
              "null",
              "string"
            ],
            "description": "sys_id of the record the comment belongs to."
          },
          "value": {
            "type": [
              "null",
              "string"
            ],
            "description": "Comment text."
          },
          "createdOn": {
            "type": "string",
            "description": "When the comment was created.",
            "format": "date-time"
          },
          "createdBy": {
            "type": [
              "null",
              "string"
            ],
            "description": "ServiceNow user who created the comment."
          },
          "element": {
            "type": [
              "null",
              "string"
            ],
            "description": "Journal field the comment was written to."
          }
        },
        "description": "v2 view of a comment on a ServiceNow incident."
      },
      "ServiceNowTicketResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ],
            "description": "ServiceNow record sys_id."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Incident description."
          },
          "shortDescription": {
            "type": [
              "null",
              "string"
            ],
            "description": "Incident short description."
          },
          "number": {
            "type": [
              "null",
              "string"
            ],
            "description": "Incident number as ServiceNow shows it."
          },
          "state": {
            "description": "Incident state.",
            "$ref": "#/components/schemas/ServiceTicketServiceNowState"
          },
          "urgency": {
            "description": "Incident urgency.",
            "$ref": "#/components/schemas/ServiceTicketServiceNowUrgency"
          },
          "comments": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "v2 view of a comment on a ServiceNow incident.",
              "$ref": "#/components/schemas/ServiceNowTicketCommentResponse"
            },
            "description": "Comments on the incident; null when they were not loaded."
          }
        },
        "description": "v2 view of a ServiceNow incident linked as a ticket."
      },
      "ServiceNowTicketUrgency": {
        "enum": [
          "High",
          "Medium",
          "Low"
        ]
      },
      "ServiceNowTicketUrgencyUpdateRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "urgency": {
            "$ref": "#/components/schemas/ServiceNowTicketUrgency"
          }
        }
      },
      "ServiceTicketAutotaskPriority": {
        "enum": [
          "High",
          "Medium",
          "Low",
          "Critical"
        ],
        "description": "Autotask ticket priorities in the v2 service-ticket contract."
      },
      "ServiceTicketProvider": {
        "enum": [
          "Autotask",
          "ServiceNow",
          "Jira",
          "Zendesk",
          "None"
        ],
        "description": "Ticketing systems in the v2 service-ticket contract."
      },
      "ServiceTicketResponse": {
        "type": "object",
        "properties": {
          "autotaskTicket": {
            "description": "The linked Autotask ticket; null unless the workspace uses Autotask and a ticket was returned.",
            "$ref": "#/components/schemas/AutotaskTicketResponse"
          },
          "serviceNowTicket": {
            "description": "The linked ServiceNow incident; null unless the workspace uses ServiceNow and a ticket was returned.",
            "$ref": "#/components/schemas/ServiceNowTicketResponse"
          },
          "jiraTicket": {
            "description": "The linked Jira Service Management issue; null unless the workspace uses Jira and a ticket was returned.",
            "$ref": "#/components/schemas/JiraTicketResponse"
          },
          "ticketingSystemType": {
            "description": "The ticketing system the workspace is connected to.",
            "$ref": "#/components/schemas/ServiceTicketProvider"
          },
          "isTicketSet": {
            "type": "boolean",
            "description": "Whether a ticket was returned."
          },
          "unavailableTicketId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Provider id of the incident's linked ticket when the provider no longer returns it; otherwise null."
          },
          "isTicketUnavailable": {
            "type": "boolean",
            "description": "Whether the incident is linked to a ticket the provider no longer returns."
          }
        },
        "description": "v2 view of an incident's service ticket in the workspace's connected ticketing system."
      },
      "ServiceTicketServiceNowState": {
        "enum": [
          "New",
          "InProgress",
          "OnHold",
          "Resolved",
          "Closed",
          "Canceled"
        ],
        "description": "ServiceNow incident states in the v2 service-ticket contract."
      },
      "ServiceTicketServiceNowUrgency": {
        "enum": [
          "High",
          "Medium",
          "Low"
        ],
        "description": "ServiceNow urgency levels in the v2 service-ticket contract."
      },
      "ServiceTicketUpdatePriorityRequest": {
        "type": "object",
        "properties": {
          "autotaskRequest": {
            "$ref": "#/components/schemas/AutotaskTicketPriorityUpdateRequest"
          },
          "serviceNowRequest": {
            "$ref": "#/components/schemas/ServiceNowTicketUrgencyUpdateRequest"
          },
          "jiraRequest": {
            "$ref": "#/components/schemas/JiraTicketPriorityUpdateRequest"
          },
          "resourceId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Gets or sets the unique identifier of the associated resource. Used to identify the target resource like Incident IDs."
          },
          "resourceType": {
            "description": "Gets or sets the type of the resource represented by this instance.",
            "$ref": "#/components/schemas/AuditedResourceType"
          },
          "resourceName": {
            "type": [
              "null",
              "string"
            ],
            "description": "An optional human-readable name of the resource."
          }
        },
        "description": "This DTO is a wrapper for priority (urgency for Snow) update calls."
      },
      "Severity": {
        "enum": [
          "Informational",
          "Low",
          "Medium",
          "High"
        ]
      },
      "SignInLogsResultDto": {
        "type": "object",
        "properties": {
          "dataTable": {
            "description": "The user sign-in log data table.",
            "$ref": "#/components/schemas/GeneralTableDto"
          },
          "nextPageLink": {
            "type": [
              "null",
              "string"
            ],
            "description": "The link to load the next page of user sign-in logs."
          },
          "message": {
            "type": [
              "null",
              "string"
            ],
            "description": "A consumer-neutral message describing why data could not be retrieved.\nPresent when bool SignInLogsResultDto.CanRetrieveData is `false`."
          },
          "canRetrieveData": {
            "type": "boolean",
            "description": "Indicates whether the handler was able to retrieve the requested data.\nWhen `false`, callers should check string SignInLogsResultDto.Message for the reason\nand avoid retrying the same request without addressing the underlying cause."
          }
        }
      },
      "SlaPointResponse": {
        "type": "object",
        "properties": {
          "date": {
            "type": [
              "null",
              "string"
            ],
            "description": "`yyyy-MM-dd` or `yyyy-MM`."
          },
          "met": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "breached": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "transitions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "The period's SLA state changes, keyed as the report's transitions are."
          }
        },
        "description": "v2 SLA results and state changes for one day or month."
      },
      "SlaReportResponse": {
        "type": "object",
        "properties": {
          "results": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "description": "Met and breached counts for one SLA type, overall and by incident severity.",
              "$ref": "#/components/schemas/SlaResultCountsResponse"
            },
            "description": "Met and breached counts per SLA type: `Slo` (time to respond) and `Mttr` (time to resolve)."
          },
          "transitions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            },
            "description": "SLA state changes in the range, keyed `{type}:{tier}` (for example `Slo:Breached`) or `Paused` / `Resumed`."
          },
          "granularity": {
            "type": [
              "null",
              "string"
            ],
            "description": "`day` for ranges up to 92 days, otherwise `month`; the grain of IReadOnlyList&lt;SlaPointResponse&gt; SlaReportResponse.Points."
          },
          "points": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "v2 SLA results and state changes for one day or month.",
              "$ref": "#/components/schemas/SlaPointResponse"
            },
            "description": "Met and breached per day or month, every SLA type counted, oldest first."
          },
          "read": {
            "description": "How the response was read.",
            "$ref": "#/components/schemas/ReportingReadInfoResponse"
          }
        },
        "description": "v2 SLA results and state changes for a date range and workspace selection."
      },
      "SlaResultCountsResponse": {
        "type": "object",
        "properties": {
          "met": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "breached": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "metBySeverity": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            }
          },
          "breachedBySeverity": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "pattern": "^-?(?:0|[1-9]\\d*)$",
              "type": [
                "integer",
                "string"
              ],
              "format": "int32"
            }
          }
        },
        "description": "Met and breached counts for one SLA type, overall and by incident severity."
      },
      "Status": {
        "enum": [
          "Active",
          "New",
          "Closed",
          "OnHold",
          "WaitingOnCustomer"
        ]
      },
      "SubmitAddUsersRequest": {
        "type": "object",
        "properties": {
          "users": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/SubmitUserManagementRequest"
            }
          },
          "assignToWorkspace": {
            "type": "boolean",
            "description": "Set to true if the user is needed to be assigned for the workspace by default"
          }
        }
      },
      "SubmitUserManagementRequest": {
        "type": "object",
        "properties": {
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "tenantId": {
            "type": [
              "null",
              "string"
            ]
          },
          "userId": {
            "type": [
              "null",
              "string"
            ]
          },
          "organizationalRole": {
            "$ref": "#/components/schemas/OrganizationalRole"
          },
          "email": {
            "type": [
              "null",
              "string"
            ]
          },
          "isOwner": {
            "type": "boolean"
          }
        }
      },
      "TimeFilteringType": {
        "enum": [
          "ThreeHours",
          "SixHours",
          "TwelveHours",
          "TwentyFourHours",
          "FortyEightHours",
          "Custom",
          "SevenDays",
          "ThirtyDays",
          "NinetyDays",
          "OneHundredEightyDays",
          "SixtyDays",
          null
        ]
      },
      "TimeFilterSelection": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/TimeFilteringType"
          },
          "customStartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "customEndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "description": "Canonical representation of a global time filter.\nWhen Type == Custom, CustomStartUtc and CustomEndUtc must be provided (UTC)."
      },
      "UnlinkServiceTicketRequest": {
        "type": "object",
        "properties": {
          "incident": {
            "$ref": "#/components/schemas/IncidentReference"
          }
        }
      },
      "UpdateIncidentCommentRequest": {
        "required": [
          "content"
        ],
        "type": "object",
        "properties": {
          "content": {
            "type": [
              "null",
              "string"
            ],
            "description": "Replacement body for the comment."
          },
          "extensionId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ignored. The source in the route decides where the comment is written; this field\nis accepted so clients that still send it keep working (PLAT-3611)."
          }
        },
        "description": "v2 request body for updating an existing comment on an incident."
      },
      "UpdateIncidentRequest": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Status"
              }
            ]
          },
          "user": {
            "description": "Represents a light version of the user object, that is used to add reference to a specific user in a foreign entities",
            "$ref": "#/components/schemas/UserSummary"
          },
          "workspace": {
            "type": [
              "null",
              "string"
            ],
            "description": "Indicates the workspace that the incident is related to in case of multi-workspace environments"
          },
          "removeAssignee": {
            "type": "boolean",
            "description": "If UserId is set to null but this is set to true,\nthe incident will be unassigned,\notherwise it will stay assigned to the current user"
          },
          "comment": {
            "type": [
              "null",
              "string"
            ]
          },
          "classification": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Classification"
              }
            ]
          },
          "classificationReason": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/ClassificationReason"
              }
            ]
          },
          "incidentSource": {
            "description": "The source system that contains the incident like Sentinel, Defender ..etc",
            "$ref": "#/components/schemas/IncidentSource"
          }
        }
      },
      "UpdateIncidentStatusRequest": {
        "required": [
          "status"
        ],
        "type": "object",
        "properties": {
          "status": {
            "description": "New status to apply to the incident.",
            "$ref": "#/components/schemas/Status"
          },
          "comment": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional comment recorded alongside the status change. Recommended when\ntransitioning to Status.Closed."
          },
          "classification": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Required when `status` is `Closed` for sources that support classifications\n(`Sentinel`, `DefenderXDR`, `SentinelOne`, `CrowdStrike`, `SumoLogic`);\nnot required for other sources, but recorded in ContraForce when supplied. One of\n`TruePositive`, `FalsePositive`, `BenignPositive`, or `Undetermined`; it\ndetermines which `classificationReason` values are accepted.",
                "$ref": "#/components/schemas/Classification"
              }
            ]
          },
          "classificationReason": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Required whenever `classification` is set for a source that supports classifications,\nand must belong to it:\n`TruePositive`: `MultistagedAttack`, `Malware`, `MaliciousUserActivity`, `UnwantedSoftware`, `Phishing`, `CompromisedUser`, `Apt`, `SuspiciousActivity`, `Other`.\n`FalsePositive`: `NotMalicious`, `NoEnoughDataToValidate`, `InaccurateData`, `IncorrectAlertLogic`, `Other`.\n`BenignPositive`: `SecurityTesting`, `ConfirmedUserActivity`, `LineOfBusinessApplication`, `SecurityPersonnel`, `SuspiciousButExpected`, `Other`.\n`Undetermined`: `Unknown`, `Other`.\nA reason outside the classification's list returns `400 VALIDATION_ERROR`.",
                "$ref": "#/components/schemas/ClassificationReason"
              }
            ]
          },
          "updateTicket": {
            "type": "boolean",
            "description": "When `true`, also closes the linked service ticket identified by\nstring UpdateIncidentStatusRequest.TicketId."
          },
          "ticketId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Linked service ticket id; required when bool UpdateIncidentStatusRequest.UpdateTicket is `true`."
          }
        },
        "description": "v2 request body for updating an incident's status."
      },
      "UpdateServiceAccountRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "organizationalRole": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/OrganizationalRole"
              }
            ]
          },
          "workspaceAssignments": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WorkspaceRoleAssignment"
            }
          }
        }
      },
      "UpdateUserOrganizationalRoleRequest": {
        "type": "object",
        "properties": {
          "userId": {
            "type": [
              "null",
              "string"
            ]
          },
          "organizationalRole": {
            "$ref": "#/components/schemas/OrganizationalRole"
          }
        }
      },
      "UpdateWebhookConfigurationRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "url": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventTypes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "monitoredAccountIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        }
      },
      "UpdateWebhookCredentialsRequest": {
        "type": "object",
        "properties": {
          "authenticationType": {
            "$ref": "#/components/schemas/WebhookAuthenticationType"
          },
          "token": {
            "type": [
              "null",
              "string"
            ]
          },
          "signingToken": {
            "type": [
              "null",
              "string"
            ]
          },
          "username": {
            "type": [
              "null",
              "string"
            ]
          },
          "password": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "User": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "firstName": {
            "type": [
              "null",
              "string"
            ]
          },
          "lastName": {
            "type": [
              "null",
              "string"
            ]
          },
          "profilePictureUrl": {
            "type": [
              "null",
              "string"
            ]
          },
          "email": {
            "type": [
              "null",
              "string"
            ]
          },
          "username": {
            "type": [
              "null",
              "string"
            ]
          },
          "appRole": {
            "$ref": "#/components/schemas/AppRole"
          },
          "addedOn": {
            "type": "string",
            "format": "date-time"
          },
          "hasLoggedIn": {
            "type": "boolean"
          },
          "isServiceAccount": {
            "type": "boolean"
          },
          "isAgentUser": {
            "type": "boolean"
          },
          "isScimManaged": {
            "type": "boolean",
            "description": "True when Microsoft Entra ID provisions the user through SCIM: their organizational role is derived from the\ndefault role for provisioned users and their groups, and cannot be set in the portal."
          },
          "organizationRole": {
            "$ref": "#/components/schemas/OrganizationalRole"
          },
          "workspaceRole": {
            "$ref": "#/components/schemas/WorkspaceRole"
          },
          "groups": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/UserGroup"
            }
          },
          "roleAssignments": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/UserRoleAssignment"
            }
          }
        },
        "description": "Represents an employee or a user in ContraForce client's tenant and it's built on top of the Microsoft Graph user model and could be extended based on other provider needs"
      },
      "UserGroup": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "accountName": {
            "type": [
              "null",
              "string"
            ]
          },
          "creationDate": {
            "type": "string",
            "format": "date-time"
          },
          "lastModificationDate": {
            "type": "string",
            "format": "date-time"
          },
          "groupOwner": {
            "type": [
              "null",
              "string"
            ]
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "members": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "Represents an employee or a user in ContraForce client's tenant and it's built on top of the Microsoft Graph user model and could be extended based on other provider needs",
              "$ref": "#/components/schemas/User"
            }
          },
          "role": {
            "$ref": "#/components/schemas/WorkspaceRole"
          },
          "workspacesAssigned": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "isScimManaged": {
            "type": "boolean",
            "description": "True when Microsoft Entra ID provisions the group through SCIM: its name and members are managed in Entra and\nlocked in the portal, while its description, workspace assignments and organizational role stay editable."
          },
          "orgRole": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "The organizational role members hold for as long as they belong to the group; null when the group grants none.\nOnly SCIM-managed groups grant one.",
                "$ref": "#/components/schemas/OrganizationalRole"
              }
            ]
          }
        }
      },
      "UserProfileDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "email": {
            "type": [
              "null",
              "string"
            ]
          },
          "upn": {
            "type": [
              "null",
              "string"
            ]
          },
          "userId": {
            "type": [
              "null",
              "string"
            ]
          },
          "role": {
            "$ref": "#/components/schemas/OrganizationalRole"
          },
          "organization": {
            "type": [
              "null",
              "string"
            ]
          },
          "organizationId": {
            "type": [
              "null",
              "string"
            ]
          },
          "tenantId": {
            "type": [
              "null",
              "string"
            ]
          },
          "preferredTimeZoneId": {
            "type": [
              "null",
              "string"
            ]
          },
          "lastReleaseNotesSeenId": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "UserRoleAssignment": {
        "type": "object",
        "properties": {
          "userId": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceName": {
            "type": [
              "null",
              "string"
            ]
          },
          "assignmentType": {
            "type": [
              "null",
              "string"
            ]
          },
          "role": {
            "$ref": "#/components/schemas/WorkspaceRole"
          }
        }
      },
      "UserSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "email": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "Represents a light version of the user object, that is used to add reference to a specific user in a foreign entities"
      },
      "ValueReportResponse": {
        "type": "object",
        "properties": {
          "runs": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Every terminal run in the range, retries and failures included. Activity, not spend.",
            "format": "int32"
          },
          "billableRuns": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "The runs a metered plan is charged for; fewer than int ValueReportResponse.Runs when an attempt failed.",
            "format": "int32"
          },
          "incidentsInvestigated": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents whose latest run reached a terminal outcome.",
            "format": "int32"
          },
          "resolvedByAgent": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents the agent resolved outright, the only ones counted as analyst work saved.",
            "format": "int32"
          },
          "costUsd": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "What the range cost, or `null` when no cost can be attributed.",
            "format": "double"
          },
          "costBasis": {
            "type": [
              "null",
              "string"
            ],
            "description": "Which number decimal? ValueReportResponse.CostUsd is: `Billed` for runs times the metered price, `Compute` for the\nagent's own spend, or `None` while nothing is being charged."
          },
          "unitPriceUsd": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "The discount-adjusted price per investigation a metered plan is charged; `null` on any other basis.",
            "format": "double"
          },
          "totalTokens": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "description": "Tokens the runs consumed, only where the compute spend is the caller's own: priced at a model's rate,\nthey are ContraForce's cost on a metered plan.",
            "format": "int64"
          },
          "read": {
            "description": "How the response was read.",
            "$ref": "#/components/schemas/ReportingReadInfoResponse"
          }
        },
        "description": "v2 agent cost against the analyst time it saved."
      },
      "VersionDto": {
        "type": "object",
        "properties": {
          "dataConnectorId": {
            "type": [
              "null",
              "string"
            ]
          },
          "version": {
            "type": [
              "null",
              "string"
            ]
          },
          "creationDate": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "WebhookAuthenticationType": {
        "enum": [
          "None",
          "BasicAuth",
          "BearerToken"
        ]
      },
      "WebhookConfigurationCreatedDto": {
        "type": "object",
        "properties": {
          "secret": {
            "type": [
              "null",
              "string"
            ]
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "serviceProviderId": {
            "type": "string",
            "format": "uuid"
          },
          "targetAccountId": {
            "type": "string",
            "format": "uuid"
          },
          "targetAccountName": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ],
            "format": "uuid"
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "url": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/WebhookConfigurationStatus"
          },
          "eventTypes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "monitoredAccountIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "authenticationType": {
            "$ref": "#/components/schemas/WebhookAuthenticationType"
          },
          "hasSigningToken": {
            "type": "boolean"
          },
          "disableReason": {
            "type": [
              "null",
              "string"
            ]
          },
          "disabledAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "WebhookConfigurationDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "serviceProviderId": {
            "type": "string",
            "format": "uuid"
          },
          "targetAccountId": {
            "type": "string",
            "format": "uuid"
          },
          "targetAccountName": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ],
            "format": "uuid"
          },
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "url": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/WebhookConfigurationStatus"
          },
          "eventTypes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          },
          "monitoredAccountIds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "authenticationType": {
            "$ref": "#/components/schemas/WebhookAuthenticationType"
          },
          "hasSigningToken": {
            "type": "boolean"
          },
          "disableReason": {
            "type": [
              "null",
              "string"
            ]
          },
          "disabledAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "WebhookConfigurationStatus": {
        "enum": [
          "Active",
          "Paused",
          "Disabled"
        ]
      },
      "WebhookCredentialsUpdatedDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "authenticationType": {
            "$ref": "#/components/schemas/WebhookAuthenticationType"
          },
          "hasSigningToken": {
            "type": "boolean"
          }
        }
      },
      "WebhookDeliveryLogDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "eventId": {
            "type": "string",
            "format": "uuid"
          },
          "eventType": {
            "type": [
              "null",
              "string"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/WebhookDeliveryStatus"
          },
          "httpStatusCode": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "errorMessage": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventSourceAccountId": {
            "type": [
              "null",
              "string"
            ],
            "description": "An optional reference to the account from which the event originated.",
            "format": "uuid"
          },
          "eventSourceAccountName": {
            "type": [
              "null",
              "string"
            ],
            "description": "The name of the account from which event originates"
          },
          "eventSubjectId": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventSubjectDisplayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventSubjectAttributes": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            }
          },
          "webhookConfigurationId": {
            "type": "string",
            "format": "uuid"
          },
          "isTest": {
            "type": "boolean"
          },
          "originalDeliveryId": {
            "type": [
              "null",
              "string"
            ],
            "format": "uuid"
          },
          "attemptNumber": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "latencyMs": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "null",
              "integer",
              "string"
            ],
            "format": "int64"
          },
          "responseSnippet": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventPayload": {
            "type": [
              "null",
              "string"
            ]
          },
          "eventOccurredAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "completedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "redeliveryRequestedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "WebhookDeliveryStatus": {
        "enum": [
          "Pending",
          "Succeeded",
          "Failed"
        ]
      },
      "WebhookSecretRegeneratedDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "secret": {
            "type": [
              "null",
              "string"
            ]
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "Result of regenerating a webhook's signing secret. string WebhookSecretRegeneratedDto.Secret is the only time the\nplaintext leaves the server; it is never readable again after this response."
      },
      "WorkloadAnalystResponse": {
        "type": "object",
        "properties": {
          "userId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The user id."
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Set only for users of the caller's own organization."
          },
          "assignments": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "closures": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          }
        },
        "description": "One analyst's assignments and closures."
      },
      "WorkloadReportResponse": {
        "type": "object",
        "properties": {
          "analysts": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "One analyst's assignments and closures.",
              "$ref": "#/components/schemas/WorkloadAnalystResponse"
            },
            "description": "One row per analyst with assignments or closures in the range, busiest first."
          },
          "assignments": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Assignments and reassignments in the range.",
            "format": "int32"
          },
          "unassignments": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          },
          "firstAssignments": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Incidents assigned for the first time in the range.",
            "format": "int32"
          },
          "medianTimeToFirstAssignmentSeconds": {
            "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
            "type": [
              "null",
              "number",
              "string"
            ],
            "description": "Median seconds from detection to first assignment, when detections are known.",
            "format": "double"
          },
          "read": {
            "description": "How the response was read.",
            "$ref": "#/components/schemas/ReportingReadInfoResponse"
          }
        },
        "description": "v2 analyst workload for a date range and workspace selection."
      },
      "WorkspaceBreakdownResponse": {
        "type": "object",
        "properties": {
          "metric": {
            "type": [
              "null",
              "string"
            ],
            "description": "`received`, `closed`, `investigated`, `actions` or `breached`."
          },
          "total": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "The metric over the whole selection, as its widget counts it.",
            "format": "int32"
          },
          "workspaces": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "description": "One workspace's value in a WorkspaceBreakdownResponse.",
              "$ref": "#/components/schemas/WorkspaceBreakdownRowResponse"
            },
            "description": "The workspaces with the highest value, highest first; none with a value of zero."
          },
          "remainder": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "The total less the listed workspaces, so the breakdown adds up to int WorkspaceBreakdownResponse.Total.",
            "format": "int32"
          },
          "otherWorkspaces": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "description": "Selected workspaces that are not listed.",
            "format": "int32"
          },
          "read": {
            "description": "How the response was read.",
            "$ref": "#/components/schemas/ReportingReadInfoResponse"
          }
        },
        "description": "v2 one reporting metric by workspace: the highest workspaces and a remainder."
      },
      "WorkspaceBreakdownRowResponse": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The workspace's name, or `null` when it could not be read."
          },
          "value": {
            "pattern": "^-?(?:0|[1-9]\\d*)$",
            "type": [
              "integer",
              "string"
            ],
            "format": "int32"
          }
        },
        "description": "One workspace's value in a WorkspaceBreakdownResponse."
      },
      "WorkspaceRole": {
        "enum": [
          "Owner",
          "ContentAdmin",
          "IncidentResponder",
          "IncidentAnalyst",
          "WorkspaceReader"
        ]
      },
      "WorkspaceRoleAssignment": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "role": {
            "$ref": "#/components/schemas/WorkspaceRole"
          }
        }
      },
      "WorkspaceRoleAssignmentDto": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "workspaceName": {
            "type": [
              "null",
              "string"
            ]
          },
          "role": {
            "$ref": "#/components/schemas/WorkspaceRole"
          }
        }
      },
      "WorkspaceSourcePageTokens": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Identifier of the workspace these tokens belong to."
          },
          "sourceTokens": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Per-source continuation tokens. Each entry represents one more page of incidents\navailable from that source within this workspace; absent sources have no further\npages."
          }
        },
        "description": "Opaque continuation tokens for a single workspace, partitioned by incident source."
      },
      "WorkspaceUserDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "null",
              "string"
            ]
          },
          "displayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "email": {
            "type": [
              "null",
              "string"
            ]
          },
          "workspaceId": {
            "type": [
              "null",
              "string"
            ]
          },
          "role": {
            "$ref": "#/components/schemas/WorkspaceRole"
          },
          "userId": {
            "type": [
              "null",
              "string"
            ]
          },
          "isAgentUser": {
            "type": "boolean",
            "description": "Whether the assignment belongs to an AI agent service identity. Agent assignments\nare immutable from IAM screens — agent requests authenticate through them."
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Incidents"
    },
    {
      "name": "Gamebooks"
    },
    {
      "name": "Data sources"
    },
    {
      "name": "Service tickets"
    },
    {
      "name": "Investigation"
    },
    {
      "name": "Export"
    },
    {
      "name": "agent-tools"
    },
    {
      "name": "Cross-workspace incidents"
    },
    {
      "name": "Cross-workspace gamebooks"
    },
    {
      "name": "Cross-workspace data sources"
    },
    {
      "name": "Webhooks"
    },
    {
      "name": "Service accounts"
    },
    {
      "name": "Users"
    },
    {
      "name": "Azure resources"
    },
    {
      "name": "Reporting"
    }
  ]
}
