swagger.json

{
  "openapi": "3.0.0",
  "paths": {
    "/public/assets": {
      "get": {
        "operationId": "AssetsPublicController_listAssets",
        "summary": "Find assets by search terms and filters",
        "description": "List all the assets",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "Security Program Overview",
            "description": "Filter data by searching by asset names",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "NAME",
            "description": "Which type of sort (default: CREATED)",
            "schema": {
              "enum": [
                "NAME",
                "ASSET_TYPE",
                "COMPANY_NAME",
                "DESCRIPTION",
                "ASSET_PROVIDER",
                "USER",
                "APPROVED_AT",
                "REMOVED_AT",
                "CREATED",
                "UPDATED",
                "EMPLOYMENT_STATUS"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "ASC",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          },
          {
            "name": "assetClassType",
            "required": false,
            "in": "query",
            "example": "DOCUMENT",
            "description": "Filter assets by class type (associated assets)",
            "schema": {
              "enum": [
                "HARDWARE",
                "POLICY",
                "DOCUMENT",
                "PERSONNEL",
                "SOFTWARE",
                "CODE",
                "CONTAINER",
                "COMPUTE",
                "NETWORKING",
                "DATABASE",
                "STORAGE"
              ],
              "type": "string"
            }
          },
          {
            "name": "assetType",
            "required": false,
            "in": "query",
            "example": "PHYSICAL",
            "description": "Filter assets by type",
            "schema": {
              "enum": [
                "PHYSICAL",
                "VIRTUAL"
              ],
              "type": "string"
            }
          },
          {
            "name": "assetProvider",
            "required": false,
            "in": "query",
            "example": "AGENT",
            "description": "Filter assets by provider",
            "schema": {
              "enum": [
                "DRATA_DEV",
                "AGENT",
                "DRATA",
                "GOOGLE",
                "MICROSOFT_365",
                "JAMF",
                "INTUNE",
                "OKTA_IDENTITY",
                "KANDJI",
                "JUMPCLOUD",
                "HEXNODE_UEM",
                "RIPPLING",
                "AWS",
                "MERGEDEV_ONELOGIN",
                "MERGEDEV_JUMPCLOUD",
                "WORKSPACE_ONE"
              ],
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Filter data to a user associated to the assets",
            "schema": {
              "maximum": 1000000000,
              "type": "number"
            }
          },
          {
            "name": "employmentStatus",
            "required": false,
            "in": "query",
            "example": "CURRENT_EMPLOYEE",
            "description": "Filter data to personnel of this employment status",
            "schema": {
              "enum": [
                "CURRENT_EMPLOYEE",
                "FORMER_EMPLOYEE",
                "CURRENT_CONTRACTOR",
                "FORMER_CONTRACTOR",
                "OUT_OF_SCOPE",
                "UNKNOWN",
                "SPECIAL_FORMER_EMPLOYEE",
                "SPECIAL_FORMER_CONTRACTOR"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetsResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Assets"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "operationId": "AssetsPublicController_createAsset",
        "summary": "Add a new asset to the account",
        "description": "Create one manual asset",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Assets"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/connections": {
      "get": {
        "operationId": "ConnectionsPublicController_getConnections",
        "summary": "List managed connections given the provided filters",
        "description": "Find managed connections by provider type and current state",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "description": "Which type of sort (default: CREATED)",
            "schema": {
              "enum": [
                "CREATED_AT",
                "CONNECTED_AT",
                "CONNECTION_PROVIDER_TYPE",
                "CONNECTION_CLIENT_TYPE",
                "CONNECTION_STATE"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          },
          {
            "name": "providerTypes",
            "required": false,
            "in": "query",
            "description": "Connection provider types",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "IDENTITY",
                  "INFRASTRUCTURE",
                  "VERSION_CONTROL",
                  "TICKETING",
                  "HRIS",
                  "BACKGROUND_CHECK",
                  "SINGLE_SIGN_ON",
                  "ENTERPRISE_SSO",
                  "MDM",
                  "SECURITY_TRAINING",
                  "OBSERVABILITY",
                  "COMMUNICATION",
                  "DIGITAL_SIGNATURE",
                  "EXTERNAL_POLICY",
                  "VULNERABILITY"
                ]
              }
            }
          },
          {
            "name": "state",
            "required": false,
            "in": "query",
            "description": "Connection current state",
            "schema": {
              "enum": [
                "ACTIVE",
                "MISCONFIGURED"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectionsResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Connections"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces": {
      "get": {
        "operationId": "WorkspacesPublicController_listWorkspaces",
        "summary": "List workspaces",
        "description": "List workspaces for an account",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "Acme",
            "description": "Filter data to search term",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspacesResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Multiple Workspace Support"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/reports": {
      "get": {
        "operationId": "ReportsPublicController_listReports",
        "summary": "Find reports by product id",
        "description": "List reports given the provided search terms and filters.",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "SOC 2 Type I Report",
            "description": "Filter data to search term",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "NAME",
            "description": "Which type of sort (default: NAME)",
            "schema": {
              "enum": [
                "CREATED",
                "DATE",
                "DESCRIPTION",
                "NAME",
                "TYPE",
                "RENEWAL_DATE"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "ASC",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "example": "SOC2_TYPE_I",
            "description": "Filter data to reports of this type",
            "schema": {
              "enum": [
                "SOC1",
                "SOC2_TYPE_I",
                "SOC2_TYPE_II",
                "SOC3",
                "RISK",
                "REMEDIATION",
                "VULNERABILITY",
                "PEN_TEST",
                "DR",
                "ARCH",
                "NETWORK",
                "AOC",
                "CERTIFICATE",
                "NOTES",
                "INCIDENT",
                "QUESTIONNAIRE",
                "DATA_FLOW",
                "OTHER",
                "INTERNAL_AUDIT",
                "CORRECTIVE_ACTION",
                "MANAGEMENT_REVIEW",
                "EVENT_LOGS",
                "MONITORING",
                "MEASUREMENTS",
                "BUSINESS_IMPACT_ANALYSIS",
                "ISMS_PLAN"
              ],
              "type": "string"
            }
          },
          {
            "name": "excludeIds",
            "required": false,
            "in": "query",
            "example": "",
            "description": "report ids to exclude from the results",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "excludeControlId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Exclude policies if mapped to control id",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Reports"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "operationId": "ReportsPublicController_createReport",
        "summary": "Upload report by product id",
        "description": "Create a report",
        "parameters": [
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CreateReportRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "413": {
            "description": "The file was too large to upload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "Third party system was unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Reports"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/reports/{id}": {
      "put": {
        "operationId": "ReportsPublicController_updateReport",
        "summary": "Update a report by report id and product id",
        "description": "Update a report's metadata",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateReportRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Reports"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "operationId": "ReportsPublicController_deleteReport",
        "summary": "Remove a report by report id and product id",
        "description": "Delete a report.",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Reports"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/controls": {
      "get": {
        "operationId": "GRCPublicController_getControls",
        "summary": "Find controls by search terms and filters",
        "description": "List Controls given the provided search terms and filters",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "Least-Privileged Policy for Customer Data Access",
            "description": "Filter data by searching for control names, codes, or descriptions",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "frameworkTags",
            "required": false,
            "in": "query",
            "example": [
              "SOC_2",
              "ISO27001"
            ],
            "description": "Filter data by controls associated with these framework tags",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "NONE",
                  "SOC_2",
                  "ISO27001",
                  "CCPA",
                  "GDPR",
                  "HIPAA",
                  "PCI",
                  "SCF",
                  "NIST80053",
                  "NISTCSF",
                  "CMMC",
                  "NIST800171",
                  "MSSSPA",
                  "FFIEC",
                  "ISO27701",
                  "COBIT",
                  "SOX_ITGC",
                  "ISO270012022",
                  "CCM",
                  "CUSTOM"
                ]
              }
            }
          },
          {
            "name": "frameworkSlug",
            "required": false,
            "in": "query",
            "example": "soc2",
            "description": "Filter data by controls associated with these custom framework Slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "trustServiceCriterion",
            "required": false,
            "in": "query",
            "example": [
              "AVAILABILITY"
            ],
            "description": "Filter controls on their Trust Service Criteria",
            "schema": {
              "enum": [
                "AVAILABILITY",
                "CONFIDENTIALITY",
                "SECURITY",
                "PRIVACY",
                "PROCESS_INTEGRITY",
                "GENERAL_RULES",
                "ADMINISTRATIVE_SAFEGUARDS",
                "PHYSICAL_SAFEGUARDS",
                "TECHNICAL_SAFEGUARDS",
                "REQUIREMENTS_ORGANIZATION",
                "REQUIREMENTS_POLICIES_PROCEDURES",
                "BASIC",
                "DERIVED",
                "NIST80053_PRIVACY"
              ],
              "type": "string"
            }
          },
          {
            "name": "trustServiceCriteria",
            "required": false,
            "in": "query",
            "example": [
              "AVAILABILITY",
              "CONFIDENTIALITY"
            ],
            "description": "Filter controls on their Trust Service Criteria",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "AVAILABILITY",
                  "CONFIDENTIALITY",
                  "SECURITY",
                  "PRIVACY",
                  "PROCESS_INTEGRITY",
                  "GENERAL_RULES",
                  "ADMINISTRATIVE_SAFEGUARDS",
                  "PHYSICAL_SAFEGUARDS",
                  "TECHNICAL_SAFEGUARDS",
                  "REQUIREMENTS_ORGANIZATION",
                  "REQUIREMENTS_POLICIES_PROCEDURES",
                  "BASIC",
                  "DERIVED",
                  "NIST80053_PRIVACY"
                ]
              }
            }
          },
          {
            "name": "ismsCategory",
            "required": false,
            "in": "query",
            "example": [
              "CONTEXT_OF_THE_ORGANIZATION",
              "LEADERSHIP"
            ],
            "description": "Filter controls on their ISMS requirements",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "CONTEXT_OF_THE_ORGANIZATION",
                  "LEADERSHIP",
                  "PLANNING",
                  "SUPPORT",
                  "OPERATION",
                  "PERFORMANCE_EVALUATION",
                  "IMPROVEMENT"
                ]
              }
            }
          },
          {
            "name": "isms2022Category",
            "required": false,
            "in": "query",
            "example": [
              "ISO_27001_2022_4_CONTEXT_OF_THE_ORGANIZATION",
              "ISO_27001_2022_5_LEADERSHIP"
            ],
            "description": "Filter controls on their ISMS requirements",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "ISO_27001_2022_4_CONTEXT_OF_THE_ORGANIZATION",
                  "ISO_27001_2022_5_LEADERSHIP",
                  "ISO_27001_2022_6_PLANNING",
                  "ISO_27001_2022_7_SUPPORT",
                  "ISO_27001_2022_8_OPERATION",
                  "ISO_27001_2022_9_PERFORMANCE_EVALUATION",
                  "ISO_27001_2022_10_IMPROVEMENT"
                ]
              }
            }
          },
          {
            "name": "isAnnexA2022",
            "required": false,
            "in": "query",
            "example": true,
            "description": "Filter controls on if they are an Annex A requirement",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "rules",
            "required": false,
            "in": "query",
            "example": [
              "BREACH_NOTIFICATION",
              "PRIVACY"
            ],
            "description": "Filter controls on their Hipaa rules",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "SECURITY",
                  "BREACH_NOTIFICATION",
                  "PRIVACY"
                ]
              }
            }
          },
          {
            "name": "subRules",
            "required": false,
            "in": "query",
            "example": [
              "GENERAL_RULES",
              "ADMINISTRATIVE_SAFEGUARDS"
            ],
            "description": "Filter controls on their Hipaa rules",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "GENERAL_RULES",
                  "ADMINISTRATIVE_SAFEGUARDS",
                  "PHYSICAL_SAFEGUARDS",
                  "TECHNICAL_SAFEGUARDS",
                  "REQUIREMENTS_ORGANIZATION",
                  "REQUIREMENTS_POLICIES_PROCEDURES"
                ]
              }
            }
          },
          {
            "name": "pciRequirements",
            "required": false,
            "in": "query",
            "example": [
              "FIREWALL",
              "ACCESS_RESTRICTION"
            ],
            "description": "Filter controls on their PCI requirements",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "FIREWALL",
                  "PASSWORDS",
                  "DATA_AT_REST_PROTECTION",
                  "DATA_IN_TRANSIT_ENCRYPTION",
                  "MALWARE_PROTECTION",
                  "SECURE_SYSTEM_MANAGEMENT",
                  "ACCESS_RESTRICTION",
                  "SYSTEM_ACCESS_CONTROL",
                  "PHYSICAL_ACCESS_CONTROL",
                  "NETWORK_ACCESS_MONITORING",
                  "VULNERABILITY_TESTING",
                  "INFORMATION_SECURITY_POLICY"
                ]
              }
            }
          },
          {
            "name": "chapters",
            "required": false,
            "in": "query",
            "example": [
              "CONTROLLER_AND_PROCESSOR",
              "PRINCIPLES"
            ],
            "description": "Filter controls on their GDPR chapters",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PRINCIPLES",
                  "RIGHTS_OF_THE_DATA_SUBJECT",
                  "CONTROLLER_AND_PROCESSOR",
                  "TRANSFERS_OF_PERSONNEL_DATA_TO_THIRD_COUNTRIES_AND_INTERNATIONAL_ORGANIZATIONS"
                ]
              }
            }
          },
          {
            "name": "statutes",
            "required": false,
            "in": "query",
            "example": [
              "INDIVIDUAL_RIGHTS",
              "SERVICE_PROVIDER"
            ],
            "description": "Filter controls on their CCPA statutes",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "INDIVIDUAL_RIGHTS",
                  "SERVICE_PROVIDER",
                  "CCPA_SECURITY"
                ]
              }
            }
          },
          {
            "name": "regulations",
            "required": false,
            "in": "query",
            "example": [
              "BUSINESS_PRACTICES_FOR_HANDLING_CONSUMER_REQUESTS",
              "NON_DISCRIMINATION"
            ],
            "description": "Filter controls on their CCPA regulations",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "NOTICES_TO_CONSUMERS",
                  "BUSINESS_PRACTICES_FOR_HANDLING_CONSUMER_REQUESTS",
                  "VERIFICATION_OF_REQUESTS",
                  "SPECIAL_RULES_REGARDING_CONSUMERS_UNDER_16_YEARS_OF_AGE",
                  "NON_DISCRIMINATION"
                ]
              }
            }
          },
          {
            "name": "functions",
            "required": false,
            "in": "query",
            "example": [
              "RECOVER",
              "RESPOND"
            ],
            "description": "Filter controls on their NIST CSF Functions",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "IDENTIFY",
                  "PROTECT",
                  "DETECT",
                  "RESPOND",
                  "RECOVER"
                ]
              }
            }
          },
          {
            "name": "sections",
            "required": false,
            "in": "query",
            "example": [
              "DATA_SUBJECTS",
              "CHOICE_AND_CONSENT"
            ],
            "description": "Filter controls on their MSSSPA Section",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "MANAGEMENT",
                  "NOTICE",
                  "CHOICE_AND_CONSENT",
                  "COLLECTION",
                  "RETENTION",
                  "DATA_SUBJECTS",
                  "DISCLOSURE_TO_THIRD_PARTIES",
                  "QUALITY",
                  "MONITORING_AND_ENFORCEMENT",
                  "MS_SSPA_SECURITY"
                ]
              }
            }
          },
          {
            "name": "controlFamilies",
            "required": false,
            "in": "query",
            "example": [
              "NIST_800_171_ACCESS_CONTROL",
              "PERSONNEL_SECURITY"
            ],
            "description": "Filter controls on their NIST SP 800-171 Control Family",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "AUDIT_AND_ACCOUNTABILITY",
                  "CONFIGURATION_MANAGEMENT",
                  "IDENTIFICATION_AND_AUTHENTICATION",
                  "INCIDENT_RESPONSE",
                  "MEDIA_PROTECTION",
                  "PERSONNEL_SECURITY",
                  "PHYSICAL_PROTECTION",
                  "SECURITY_ASSESSMENT",
                  "SYSTEM_AND_COMMUNICATIONS_PROTECTION",
                  "SYSTEM_AND_INFORMATION_INTEGRITY",
                  "NIST_CSF_RISK_ASSESSMENT",
                  "NIST_CSF_MAINTENANCE",
                  "NIST_800_171_ACCESS_CONTROL",
                  "NIST_800_171_AWARENESS_AND_TRAINING"
                ]
              }
            }
          },
          {
            "name": "controlClasses",
            "required": false,
            "in": "query",
            "example": [
              "TECHNICAL"
            ],
            "description": "Filter controls on their NIST SP 800-171 Control Class",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "TECHNICAL",
                  "OPERATIONAL",
                  "NIST_800_171_MANAGEMENT"
                ]
              }
            }
          },
          {
            "name": "iso27701",
            "required": false,
            "in": "query",
            "example": [
              "PII_CONTROLS_GUIDANCE"
            ],
            "description": "Filter controls on their ISO27701 requirements",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PIMS_SPECIFIC_REQUIREMENTS",
                  "PIMS_SPECIFIC_GUIDANCE",
                  "PII_CONTROLS_GUIDANCE",
                  "PII_PROCESSORS_GUIDANCE"
                ]
              }
            }
          },
          {
            "name": "cobit",
            "required": false,
            "in": "query",
            "example": [
              "ALIGN_PLAN_AND_ORGANIZE"
            ],
            "description": "Filter controls on their COBIT requirements",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "EVALUATE_DIRECT_AND_MONITOR",
                  "ALIGN_PLAN_AND_ORGANIZE",
                  "BUILD_ACQUIRE_AND_IMPLEMENT",
                  "DELIVER_SERVICE_AND_SUPPORT",
                  "MONITOR_EVALUATE_AND_ASSESS"
                ]
              }
            }
          },
          {
            "name": "soxitgc",
            "required": false,
            "in": "query",
            "example": [
              "PROGRAM_DEVELOPMENT"
            ],
            "description": "Filter controls on their SOX requirements",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PROGRAM_DEVELOPMENT",
                  "CHANGE_MANAGEMENT",
                  "SYSTEM_OPERATIONS",
                  "ACCESS_MANAGEMENT"
                ]
              }
            }
          },
          {
            "name": "controlBaselines",
            "required": false,
            "in": "query",
            "example": [
              "NIST_800_53_OPERATIONAL"
            ],
            "description": "Filter controls on their NIST SP 800-53 Control Baseline",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "NIST_800_53_TECHNICAL",
                  "NIST_800_53_OPERATIONAL",
                  "NIST_800_53_MANAGEMENT"
                ]
              }
            }
          },
          {
            "name": "cmmcClasses",
            "required": false,
            "in": "query",
            "example": [
              "CMMC_MANAGEMENT"
            ],
            "description": "Filter controls on their NIST SP 800-53 Control Baseline",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "CMMC_TECHNICAL",
                  "CMMC_OPERATIONAL",
                  "CMMC_MANAGEMENT"
                ]
              }
            }
          },
          {
            "name": "domains",
            "required": false,
            "in": "query",
            "example": [
              "FFIEC_CYBERSECURITY_CONTROLS"
            ],
            "description": "Filter controls on their FFIEC Domains",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "FFIEC_CYBER_RISK_MANAGEMENT_AND_OVERSIGHT",
                  "FFIEC_THREAT_INTELLIGENCE_AND_COLLABORATION",
                  "FFIEC_CYBERSECURITY_CONTROLS",
                  "FFIEC_EXTERNAL_DEPENDENCY_MANAGEMENT",
                  "FFIEC_CYBER_INCIDENT_MANAGEMENT_AND_RESILIENCE"
                ]
              }
            }
          },
          {
            "name": "assessmentFactors",
            "required": false,
            "in": "query",
            "example": [
              "FFIEC_GOVERNANCE"
            ],
            "description": "Filter controls on their FFIEC Assessment Factors",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "FFIEC_GOVERNANCE",
                  "FFIEC_RISK_MANAGEMENT",
                  "FFIEC_RESOURCES",
                  "FFIEC_TRAINING_AND_CULTURE",
                  "FFIEC_THREAT_INTELLIGENCE",
                  "FFIEC_MONITORING_AND_ANALYZING",
                  "FFIEC_INFORMATION_SHARING",
                  "FFIEC_PREVENTATIVE_CONTROLS",
                  "FFIEC_DETECTIVE_CONTROLS",
                  "FFIEC_CORRECTIVE_CONTROLS",
                  "FFIEC_CONNECTIONS",
                  "FFIEC_RELATIONSHIP_MANAGEMENT",
                  "FFIEC_INCIDENT_RESILIENCE_PLANNING_AND_STRATEGY",
                  "FFIEC_DETECTION_RESPONSE_AND_MITIGATION",
                  "FFIEC_ESCALATION_AND_REPORTING"
                ]
              }
            }
          },
          {
            "name": "userIds",
            "required": false,
            "in": "query",
            "example": [
              1
            ],
            "description": "User Ids of Control Owners",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "isOwned",
            "required": false,
            "in": "query",
            "example": true,
            "description": "Filter controls on if they have a control owner",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isReady",
            "required": false,
            "in": "query",
            "example": true,
            "description": "Filter controls on if they are ready",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isAnnexA",
            "required": false,
            "in": "query",
            "example": true,
            "description": "Filter controls on if they are an Annex A requirement",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isArchived",
            "required": false,
            "in": "query",
            "example": false,
            "description": "Filter to controls that are or are not archived",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isMonitored",
            "required": false,
            "in": "query",
            "example": false,
            "description": "Filter to controls that are or are not monitored",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hasEvidence",
            "required": false,
            "in": "query",
            "example": true,
            "description": "Filter to controls with or without evidence",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hasPassingTest",
            "required": false,
            "in": "query",
            "example": true,
            "description": "Filter to controls with at least one passing test",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "excludeIds",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Exclude controls by array of id",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "excludeRequirementId",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Exclude controls if they are mapped to this requirement id",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "requirementId",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Only include controls if they are mapped to this requirement id",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "excludeTestId",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Exclude controls if they are mapped to this test id",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "testId",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Only include controls if they are mapped to this test id",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "hasTicket",
            "required": false,
            "in": "query",
            "example": 0,
            "description": "Only include controls if they associted to a task management ticket",
            "schema": {
              "enum": [
                "IN_PROGRESS",
                "ARCHIVED"
              ],
              "type": "string"
            }
          },
          {
            "name": "connectionId",
            "required": false,
            "in": "query",
            "description": "This will be filled in automatic when using a taskManagementStatus.",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlPaginatedResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/controls/{id}/external-evidence": {
      "get": {
        "operationId": "GRCPublicController_getMappedExternalEvidence",
        "summary": "Find control external evidence by control id",
        "description": "Get all mapped external evidence to a control",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "excludeIds",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Exclude external evidence by array of id",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Public Api",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MappedExternalEvidencePaginatedResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/external-evidence/{id}/download": {
      "get": {
        "operationId": "GRCPublicController_getEvidenceDownloadUrl",
        "summary": "Get external evidence document download url by document id",
        "description": "Get signed download link for external evidence",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedUrlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/controls/{id}/external-evidence": {
      "post": {
        "operationId": "GRCPublicController_uploadExternalEvidence",
        "summary": "Upload external evidence document by control id",
        "description": "Upload external evidence to map to a control",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/UploadEvidencePublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MappedExternalEvidenceResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "413": {
            "description": "The file was too large to upload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "Third party system was unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/controls/{controlId}": {
      "get": {
        "operationId": "GRCPublicController_getControlById",
        "summary": "Find control by control id",
        "description": "List all the information for a specific control",
        "parameters": [
          {
            "name": "controlId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlShortResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "put": {
        "operationId": "GRCPublicController_editControl",
        "summary": "Edit control of the account",
        "description": "Edit control",
        "parameters": [
          {
            "name": "controlId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EditControlRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlShortResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/controls/{controlId}/evidence/download": {
      "get": {
        "operationId": "GRCPublicController_getDownloadAllEvidence",
        "summary": "Get control evidence download url by control id",
        "description": "Download zip with all control evidence",
        "parameters": [
          {
            "name": "controlId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedUrlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/controls/{id}/requirements": {
      "get": {
        "operationId": "GRCPublicController_getMappedRequirements",
        "summary": "Find control mapped requirements by control id",
        "description": "Get all mapped requirements from a control id",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "frameworkTag",
            "required": false,
            "in": "query",
            "example": [
              "SOC_2",
              "ISO27001"
            ],
            "description": "Filter data by controls associated with these framework tags",
            "schema": {
              "enum": [
                "NONE",
                "SOC_2",
                "ISO27001",
                "CCPA",
                "GDPR",
                "HIPAA",
                "PCI",
                "SCF",
                "NIST80053",
                "NISTCSF",
                "CMMC",
                "NIST800171",
                "MSSSPA",
                "FFIEC",
                "ISO27701",
                "COBIT",
                "SOX_ITGC",
                "ISO270012022",
                "CCM",
                "CUSTOM"
              ],
              "type": "string"
            }
          },
          {
            "name": "excludeIds",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Exclude notes by array of id",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "frameworkSlug",
            "required": false,
            "in": "query",
            "example": "slug",
            "description": "Filter data by controls associated with these framework slugs. This parameter is intended to be used only for custom frameworks",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RequirementPaginatedResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/controls/{id}/owners": {
      "get": {
        "operationId": "GRCPublicController_getControlOwnersForAControl",
        "summary": "Find control owners by control id",
        "description": "Get control owners for a control",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "John Doe",
            "description": "User first name, or last name, or email, or full name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "frameworkSlug",
            "required": false,
            "in": "query",
            "example": "soc2",
            "description": "Filter data by controls associated with this framework slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeUserIds[]",
            "required": false,
            "in": "query",
            "example": [
              1,
              2,
              3
            ],
            "description": "A set of users to return",
            "schema": {
              "nullable": true,
              "type": "array",
              "items": {
                "type": "integer"
              }
            }
          },
          {
            "name": "excludeIds",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Exclude users by array of id",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlOwnersResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "put": {
        "operationId": "GRCPublicController_putControlOwners",
        "summary": "Add control owners by control id",
        "description": "Add control owners",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlOwnerRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlOwnersResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/controls": {
      "post": {
        "operationId": "GRCPublicController_createControl",
        "summary": "Add a new control to the account",
        "description": "Create a new custom control",
        "parameters": [
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CreateControlRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "413": {
            "description": "The file was too large to upload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "Third party system was unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/external-evidence/{id}": {
      "delete": {
        "operationId": "GRCPublicController_deleteEvidence",
        "summary": "Remove external evidence by external evidence id",
        "description": "Soft delete external evidence",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MappedExternalEvidenceResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/controls/owners": {
      "delete": {
        "operationId": "GRCPublicController_bulkDeleteControlOwners",
        "summary": "Bulk delete control owners by control ids and owner ids",
        "description": "Bulk delete control owners",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlOwnerBulkRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlOwnersResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Controls"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/monitors": {
      "get": {
        "operationId": "MonitorsPublicController_listMonitors",
        "summary": "Find monitor by search terms and filters",
        "description": "List Monitors given the provided search terms and filters",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "SSL enforced on company website",
            "description": "Filter data by searching for test names",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "checkResultStatus",
            "required": false,
            "in": "query",
            "example": "ERROR",
            "description": "Filter monitors (control test instances) on a result status",
            "schema": {
              "enum": [
                "READY",
                "PASSED",
                "FAILED",
                "ERROR",
                "PREAUDIT"
              ],
              "type": "string"
            }
          },
          {
            "name": "checkResultStatuses",
            "required": false,
            "in": "query",
            "example": [
              "PASSED",
              "FAILED"
            ],
            "description": "Filter monitors (control test instances) on result statuses",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "READY",
                  "PASSED",
                  "FAILED",
                  "ERROR",
                  "PREAUDIT"
                ]
              }
            }
          },
          {
            "name": "checkStatus",
            "required": false,
            "in": "query",
            "example": "ENABLED",
            "description": "Filter monitors (control test instances) on system status",
            "schema": {
              "enum": [
                "UNUSED",
                "UPCOMING",
                "ENABLED",
                "DISABLED",
                "TESTING"
              ],
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "example": "INFRASTRUCTURE",
            "description": "Filter monitors by check type (associated monitor instances)",
            "schema": {
              "enum": [
                "POLICY",
                "IN_DRATA",
                "AGENT",
                "INFRASTRUCTURE",
                "VERSION_CONTROL",
                "IDENTITY",
                "TICKETING",
                "HRIS",
                "OBSERVABILITY"
              ],
              "type": "string"
            }
          },
          {
            "name": "controlOwner",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Owner id to filter against",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "getAll",
            "required": false,
            "in": "query",
            "example": true,
            "description": "boolean for running through the full pagination",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "includeArchivedControls",
            "required": false,
            "in": "query",
            "example": true,
            "description": "boolean for getting archived controls as well",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "controlId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Control id to filter against",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "excludeControlId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Control id to filter against",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "excludeTestIds",
            "required": false,
            "in": "query",
            "example": [],
            "description": "Exclude tests by array of id",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "sortByName",
            "required": false,
            "in": "query",
            "example": true,
            "description": "boolean for sorting results by name",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "reportInterval",
            "required": false,
            "in": "query",
            "example": "MONTHLY",
            "description": "The interval to group the data on",
            "schema": {
              "enum": [
                "WEEKLY",
                "MONTHLY"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlTestsPaginatedResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Monitor Instances"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/monitors/{testId}/details": {
      "get": {
        "operationId": "MonitorsPublicController_getControlTestInstance",
        "summary": "Find monitor details by test id",
        "description": "Get details for a monitor",
        "parameters": [
          {
            "name": "testId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlTestInstanceResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Monitor Instances"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/events": {
      "get": {
        "operationId": "EventsPublicController_listEvents",
        "summary": "Find events by search terms and filters",
        "description": "List events given the provided search terms and filters.",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
            "description": "Find an event by ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "CREATED",
            "description": "Which type of sort (default: CREATED)",
            "schema": {
              "enum": [
                "CREATED",
                "DESCRIPTION",
                "TYPE",
                "CATEGORY",
                "USER",
                "CHECK_RESULTS_STATUS"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "DESC",
            "description": "Which direction to sort the data (default: DESC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "example": "COMPANY_DATA_UPDATED",
            "description": "Filter data to events of this type",
            "schema": {
              "enum": [
                "COMPANY_DATA_UPDATED",
                "COMPANY_LOGO_UPDATED",
                "COMPANY_KEY_PERSONNEL_UPDATED",
                "COMPANY_ROLES_UPDATED",
                "COMPANY_SECURITY_DATA_UPDATED",
                "COMPANY_DOCUMENT_UPLOADED",
                "COMPANY_DOCUMENT_DOWNLOADED",
                "COMPANY_DOCUMENT_DELETED",
                "COMPANY_HUMAN_RESOURCES_DATA_UPDATED",
                "EMPLOYMENT_STATUS_UPDATED",
                "REMINDER_EMAIL_SENT",
                "POLICIES_DOWNLOAD_ALL",
                "POLICY_DOWNLOADED",
                "POLICY_VERSION_UPLOADED",
                "POLICY_VERSION_ADDED",
                "POLICY_VERSION_UPDATED",
                "POLICY_OWNER_APPROVED",
                "USER_POLICY_ACCEPTED",
                "REPORTS_DOWNLOAD_ALL",
                "REPORT_DOWNLOADED",
                "REPORT_CREATED",
                "REPORT_UPDATED",
                "REPORT_DELETED",
                "VENDORS_DOWNLOAD_ALL",
                "VENDOR_CREATED",
                "VENDOR_UPDATED",
                "VENDOR_DELETED",
                "VENDOR_DOCUMENT_UPLOADED",
                "VENDOR_DOCUMENT_DELETED",
                "VENDOR_DOCUMENT_DOWNLOADED",
                "AUTOPILOT_FREQUENCY_UPDATED",
                "TERMS_AGREED",
                "AUTOPILOT_USER_CREATED",
                "AUTOPILOT_USER_UPDATED",
                "AUTOPILOT_PERSONNEL_SEPARATED",
                "AUTOPILOT_COMPLIANCE_CHECK_UPDATED",
                "AGENT_USER_DATA_UPDATED",
                "USER_DOCUMENT_UPLOADED",
                "USER_DOCUMENT_DELETED",
                "USER_DOCUMENT_DOWNLOADED",
                "BACKGROUND_CHECK_STARTED",
                "PROVIDER_CONNECTION_CREATED",
                "PROVIDER_CONNECTION_REMOVED",
                "USER_IDENTITY_VERSION_CONTROL_LINK_UPDATED",
                "USER_IDENTITY_VERSION_CONTROL_TOGGLE_UPDATED",
                "USER_IDENTITY_VERSION_CONTROL_SERVICE_ACCOUNT_UPDATED",
                "USER_IDENTITY_PERSONNEL_SYNCED",
                "USER_IDENTITY_VERSION_CONTROL_SYNCED",
                "USER_IDENTITY_VERSION_CONTROL_USER_UPDATED",
                "USER_IDENTITY_VERSION_CONTROL_USER_CREATED",
                "USER_IDENTITY_VERSION_CONTROL_USER_DISCONNECTED",
                "AP_IDENTITY_PROVIDER_MFA_ENABLED",
                "AP_IDENTITY_PROVIDER_UNKNOWN_EMAIL",
                "AP_INTERNAL_POLICY_INCIDENT_RESPONSE",
                "AP_INTERNAL_POLICY_INCIDENT_RESPONSE_FOLLOW_UPS",
                "AP_INTERNAL_POLICY_INCIDENT_RESPONSE_LESSONS_LEARNED",
                "AP_INTERNAL_POLICY_INCIDENT_RESPONSE_TEAM",
                "AP_INTERNAL_POLICY_DATA_CLASSIFICATION",
                "AP_INTERNAL_POLICY_SDLC",
                "AP_INTERNAL_POLICY_ACCEPTABLE_USE",
                "AP_INTERNAL_POLICY_ACCESS_CONTROL",
                "AP_INTERNAL_POLICY_INFORMATION_SECURITY",
                "AP_INTERNAL_POLICY_CODE_OF_CONDUCT",
                "AP_INTERNAL_POLICY_DATA_PROTECTION",
                "AP_INTERNAL_POLICY_PASSWORD",
                "AP_INTERNAL_POLICY_BACKUPS",
                "AP_INTERNAL_POLICY_PHYSICAL_SECURITY",
                "AP_INTERNAL_POLICY_RISK_ASSESSMENT",
                "AP_INTERNAL_POLICY_DISASTER_RECOVERY",
                "AP_INTERNAL_POLICY_ENCRYPTION",
                "AP_INTERNAL_POLICY_SYSTEM_ACCESS_CONTROL",
                "AP_INTERNAL_POLICY_RESPONSIBLE_DISCLOSURE",
                "AP_INTERNAL_POLICY_EMPLOYEE_CONFIDENTIALITY",
                "AP_INTERNAL_POLICY_EMPLOYEE_ACCESS_TO_CUSTOMER_DATA",
                "AP_INTERNAL_POLICY_RISK_REMEDIATION",
                "AP_INTERNAL_POLICY_VULNERABILITY_MANAGEMENT",
                "AP_INTERNAL_DOCUMENT_ORGANIZATIONAL_CHART",
                "AP_COMPANY_POLICIES_APPROVED",
                "AP_COMPANY_POLICIES_CREATED",
                "AP_COMPANY_BOD_UNIQUE",
                "AP_INTERNAL_REPORT_RISK_ASSESSMENT",
                "AP_INTERNAL_REPORT_RISK_REMEDIATION",
                "AP_INTERNAL_REPORT_VULNERABILITY",
                "AP_INTERNAL_REPORT_PENETRATION",
                "AP_INTERNAL_REPORT_DISASTER_RECOVERY",
                "AP_INTERNAL_REPORT_BACKUP_AND_COMPLETENESS",
                "AP_INTERNAL_REPORT_ARCHITECTURAL_DIAGRAM",
                "AP_INTERNAL_REPORT_NETWORK_DIAGRAM",
                "AP_INTERNAL_URL_SUPPORT",
                "AP_INTERNAL_URL_PRIVACY_POLICY",
                "AP_INTERNAL_URL_TERMS_OF_SERVICE",
                "AP_EMPLOYEES_POLICIES_APPROVED",
                "AP_EMPLOYEES_ACCEPTABLE_USE_POLICY",
                "AP_EMPLOYEES_CODE_OF_CONDUCT_POLICY",
                "AP_EMPLOYEES_DATA_PROTECTION_POLICY",
                "AP_AGENT_PASSWORD_MANAGER",
                "AP_AGENT_ANTI_VIRUS_APPLICATION",
                "AP_AGENT_AUTO_UPDATES_ENABLED",
                "AP_CONTRACTORS_CODE_OF_CONDUCT_POLICY",
                "AP_CONTRACTORS_ACCEPTABLE_USE_POLICY",
                "AP_COMPANY_INFRASTRUCTURE_MFA_ENABLED",
                "AP_COMPANY_INFRASTRUCTURE_SSL_ENABLED",
                "AP_COMPANY_WEBSITE_SSL_ENFORCED",
                "AP_COMPANY_WEBSITE_SSL_CERT_NOT_EXPIRED",
                "AP_COMPANY_WEBSITE_SSL_CERT_STRONG_CIPHERS",
                "AP_COMPANY_WEBSITE_SSL_HAS_KNOWN_ISSUES",
                "AP_COMPANY_PRIORITIZE_SECURITY_ISSUES",
                "AP_VERSION_CONTROL_ENABLED",
                "AP_VERSION_CONTROL_MFA_ENABLED",
                "AP_VERSION_CONTROL_CODE_REVIEW_PROCESS",
                "AP_INFRASTRUCTURE_AUTHORIZATION_DETAILS",
                "AP_INFRASTRUCTURE_PUBLIC_SSH_DENIED",
                "AP_INFRASTRUCTURE_DATA_ENCRYPTED",
                "AP_INFRASTRUCTURE_DATA_MULTI_AZ",
                "AP_INFRASTRUCTURE_STORAGE_ENCRYPTED",
                "AP_INFRASTRUCTURE_DATA_MONITOR_CPU",
                "AP_INFRASTRUCTURE_DATA_MONITOR_READ_IO",
                "AP_INFRASTRUCTURE_DATA_MONITOR_WRITE_IO",
                "AP_INFRASTRUCTURE_DATA_MONITOR_FREE_STORAGE",
                "AP_INFRASTRUCTURE_INSTANCE_MONITOR_CPU",
                "AP_INFRASTRUCTURE_DISALLOWS_TRAFFIC",
                "AP_INFRASTRUCTURE_HAS_WAF",
                "AP_INFRASTRUCTURE_HAS_BALANCERS",
                "AP_INFRASTRUCTURE_QUEUE_MONITOR_MESSAGE_AGE",
                "AP_INFRASTRUCTURE_CLOUD_DATA_FREE_STORAGE",
                "AP_INFRASTRUCTURE_CREDENTIAL_REPORT",
                "USER_IDENTITY_INFRASTRUCTURE_LINK_UPDATED",
                "USER_IDENTITY_INFRASTRUCTURE_TOGGLE_UPDATED",
                "USER_IDENTITY_INFRASTRUCTURE_SERVICE_ACCOUNT_UPDATED",
                "USER_IDENTITY_INFRASTRUCTURE_SYNCED",
                "USER_IDENTITY_INFRASTRUCTURE_USER_UPDATED",
                "USER_IDENTITY_INFRASTRUCTURE_USER_CREATED",
                "USER_IDENTITY_INFRASTRUCTURE_USER_DISCONNECTED",
                "AGENT_UNREGISTERED",
                "ASSETS_DOWNLOAD_ALL",
                "BACKGROUND_CHECK_MANUAL",
                "BACKGROUND_CHECK_DELETED",
                "AP_INFRASTRUCTURE_STORAGE_RESTRICTED",
                "AP_INFRASTRUCTURE_STORAGE_VERSIONING",
                "AP_INFRASTRUCTURE_DATA_BACKUPS",
                "AP_INTERNAL_INFRASTRUCTURE_IDENTITIES_REMOVED",
                "AP_INTERNAL_INFRASTRUCTURE_IDENTITIES_UNIQUE",
                "AP_INFRASTRUCTURE_STORAGE_WAF",
                "AP_INTERNAL_VERSION_CONTROL_IDENTITIES_UNIQUE",
                "AP_INTERNAL_VERSION_CONTROL_IDENTITIES_REMOVED",
                "AP_INTERNAL_INFRASTRUCTURE_LINKED",
                "AP_INTERNAL_VERSION_CONTROL_IDENTITIES_ONLY_AUTHORIZED_ACCESS",
                "AP_INTERNAL_POLICY_PASSWORD_MANAGER_REQUIRED",
                "AP_INTERNAL_POLICY_SECURITY_AWARENESS",
                "AP_INTERNAL_POLICY_SECURITY_ENCRYPTION",
                "AP_INTERNAL_URL_EXTERNAL_JOBS",
                "AP_EMPLOYEES_SECURITY_COMPLIANCE",
                "AP_EMPLOYEES_BACKGROUND_CHECK_COMPLIANCE",
                "AP_EMPLOYEES_LOCK_SCREEN_COMPLIANCE",
                "AP_EMPLOYEES_HARD_DRIVE_ENCRYPTED_COMPLIANCE",
                "AP_VERSION_CONTROL_WRITE_ACCESS_TO_REPOSITORY",
                "AP_VERSION_CONTROL_WRITE_ACCESS_TO_PRODUCTION_CODE",
                "AP_CONTRACTORS_BACKGROUND_CHECK_COMPLIANCE",
                "AP_COMPANY_SECURITY_COMMITTEE",
                "AP_INTERNAL_DOCUMENT_PERFORMANCE_EVALUATION",
                "AP_INTERNAL_DOCUMENT_EMPLOYEE_AGREEMENT",
                "AP_INTERNAL_DOCUMENT_ENGINEERING_JOB_DESCRIPTION",
                "AP_INTERNAL_DOCUMENT_MSA",
                "AP_INTERNAL_POLICY_DATA_RETENTION",
                "AP_INTERNAL_POLICY_CUSTOMER_DATA_RETENTION",
                "AP_INTERNAL_POLICY_CLEAN_DESK",
                "AP_INTERNAL_POLICY_SENSITIVE_DATA_DISPOSAL",
                "COMPANY_SECURITY_REPORT_SETTING_UPDATED",
                "COMPANY_SECURITY_REPORT_SHAREABLE_UPDATED",
                "COMPANY_SECURITY_REPORT_SHARE_TOKEN_UPDATED",
                "MONITOR_EXCLUSION_CREATED",
                "MONITOR_EXCLUSION_UPDATED",
                "MONITOR_EXCLUSION_DELETED",
                "AP_INFRASTRUCTURE_ROOT_ACCOUNT_UNUSED",
                "POLICY_ADDED",
                "POLICY_VERSION_DELETED",
                "COMPANY_ARCHIVED_DOWNLOADED",
                "PROVIDER_CONNECTION_UPDATED",
                "ARCHIVE_CONTROL",
                "UNARCHIVE_CONTROL",
                "EXTERNAL_EVIDENCE_DELETED",
                "REPORT_ASSOCIATED_TO_CONTROL",
                "REPORT_UNASSOCIATED_TO_CONTROL",
                "UPLOAD_EXTERNAL_EVIDENCE",
                "POLICY_ASSOCIATED_TO_CONTROL",
                "POLICY_UNASSOCIATED_TO_CONTROL",
                "REQUIREMENT_ASSOCIATED_TO_CONTROL",
                "REQUIREMENT_UNASSOCIATED_TO_CONTROL",
                "BACKGROUND_CHECK_COMPLETED",
                "MDM_USER_DATA_UPDATED",
                "CREATE_CONTROL",
                "MANUAL_ASSET_CREATED",
                "MANUAL_ASSET_UPDATED",
                "MANUAL_ASSET_DELETED",
                "ASSET_NOTES_UPDATED",
                "COMPANY_WORKSTATION_CONFIGURATION_UPDATED",
                "COMPANY_LINKS_DOWNLOADED",
                "COMPANY_PACKAGE_DOWNLOADED",
                "CONNECTIONS_AUDIT_PACKAGE_DOWNLOADED",
                "HUMAN_RESOURCES_AUDIT_PACKAGE_DOWNLOADED",
                "INFRASTRUCTURE_ACCESS_AUDIT_PACKAGE_DOWNLOADED",
                "VERSION_CONTROL_AUDIT_PACKAGE_DOWNLOADED",
                "EDIT_CONTROL_INFO",
                "FORCE_SYNC_ON_A_PERSON",
                "FORCE_SYNC_ON_ALL",
                "CONTROL_OWNER_ADDED",
                "CONTROL_OWNER_DELETED",
                "POLICY_REVERT_TO_LATEST_TEMPLATE",
                "POLICY_REVERT_TO_LATEST_VERSION",
                "CONTROL_EVIDENCE_PACKAGE_GENERATED",
                "AUDITOR_TOGGLE_READ_ONLY",
                "FRAMEWORK_AUDIT_DETAILS_EDITED",
                "VENDOR_MANUAL_UPLOAD",
                "QUESTIONNAIRE_ARCHIVE_DOWNLOADED",
                "VENDOR_QUESTIONNAIRE_RESPONSE_SAVED",
                "VENDOR_QUESTIONNAIRE_EMAIL_SENT",
                "GROUPS_IDENTITY_CREATED",
                "GROUPS_IDENTITY_DELETED",
                "GROUPS_PERSONNEL_IDENTITY_ADDED",
                "GROUPS_PERSONNEL_IDENTITY_REMOVED",
                "GROUPS_IDENTITY_UPDATED",
                "BACKGROUND_CONNECTED_TO_USER",
                "BACKGROUND_DISCONNECTED_FROM_USER",
                "POLICY_REAFFIRMED",
                "SECURITY_AWARENESS_TRAINING_RESET",
                "POLICY_ASSIGNED_ALL",
                "POLICY_ASSIGNED_NONE",
                "POLICY_ASSIGNED_GROUPS",
                "GROUPS_PERSONNEL_DELETED",
                "GROUPS_PERSONNEL_ADDED",
                "GROUPS_DELETED",
                "POLICY_BECAME_ORPHAN",
                "AP_CONTRACTORS_POLICIES_APPROVED",
                "AP_CONTRACTORS_DATA_PROTECTION_POLICY",
                "COMPANY_HIPAA_TRAINING_DATA_UPDATED",
                "CONTROL_NOTE_ADDED",
                "CONTROL_NOTE_DELETED",
                "CONTROL_NOTE_EDITED",
                "AUDITOR_ADDED",
                "AUDITOR_REMOVED",
                "AUDITOR_HAS_ENTERED_TO_TENANT_DETAILS",
                "AUDITOR_DOES_A_READ_ONLY",
                "ACCOUNT_INFORMATION_PACKAGE_CREATION",
                "HIPAA_TRAINING_RESET",
                "SECURITY_AWARENESS_TRAINING_UPDATED",
                "AP_SECURITY_AWARENESS_TRAINING",
                "DEVICE_UNLINKED",
                "DEVICE_LINKED",
                "DEVICE_DOCUMENT_DELETED",
                "DEVICE_SWITCHED",
                "DEVICE_DOCUMENT_DOWNLOADED",
                "TRUST_PAGES_SAVED",
                "EXTERNAL_EVIDENCE_URL_EDITED",
                "REQUIREMENT_OUT_OF_SCOPE",
                "REQUIREMENT_IN_SCOPE",
                "CONTROLS_ASSOCIATED",
                "CONTROLS_UNASSOCIATED",
                "EXTERNAL_EVIDENCE_EDITED",
                "APPROVED_REQUEST",
                "DENIED_REQUEST",
                "NEW_REQUEST",
                "AUTO_APPROVE_REQUEST",
                "AP_INFRASTRUCTURE_ASSETS_SYNCED",
                "POLICY_ARCHIVED",
                "POLICY_REPLACED",
                "POLICY_RESTORE_ARCHIVED",
                "POLICY_RESTORE_REPLACED",
                "POLICY_RESTART_FROM_LATEST_TEMPLATE",
                "POLICY_RESTART_FROM_DRAFT",
                "AP_LOGS_ARE_CENTRALLY_STORED",
                "AP_LOGS_ARE_RETAINED_FOR_365_DAYS",
                "USER_IDENTITY_OBSERVABILITY_USER_CREATED",
                "USER_IDENTITY_OBSERVABILITY_USER_UPDATED",
                "USER_IDENTITY_OBSERVABILITY_SYNCED",
                "USER_IDENTITY_OBSERVABILITY_USER_DISCONNECTED",
                "USER_IDENTITY_OBSERVABILITY_LINK_UPDATED",
                "USER_IDENTITY_OBSERVABILITY_SERVICE_ACCOUNT_UPDATED",
                "OBSERVABILITY_ACCESS_AUDIT_PACKAGE_DOWNLOADED",
                "CONTROL_TEST_DELETED",
                "CONTROL_TEST_ADDED",
                "RISK_ADDED",
                "RISK_EDITED",
                "RISK_ASSESSMENT_REPORT_GENERATED",
                "RISK_TREATMENT_REPORT_GENERATED",
                "RISK_CATEGORY_CREATED",
                "RISK_CATEGORY_REMOVED",
                "RISK_OWNERS_ASSIGNED",
                "RISK_SET_APPLICABLE",
                "RISK_SET_NOT_APPLICABLE",
                "RISK_TREATMENT_SET",
                "RISK_SCORED",
                "RISK_ALL_APPLICABLE_SCORED",
                "RISK_ALL_APPLICABLE_TREATED",
                "COMPANY_NOTIFICATION_CREATED",
                "COMPANY_NOTIFICATION_DELETED",
                "COMPANY_NOTIFICATION_EDITED",
                "COMPANY_NOTIFICATION_DISABLED",
                "COMPANY_NOTIFICATION_ENABLED",
                "USER_IDENTITY_OBSERVABILITY_TOGGLE_UPDATED",
                "AP_CAPACITY_AND_USAGE_MONITORING",
                "AP_ONLY_AUTHORIZED_USERS_CAN_ACCESS_LOG_SINKS",
                "AP_LOGS_MONITORED_FOR_SUSPICIOUS_ACTIVITY",
                "CUSTOM_FRAMEWORK_CREATED",
                "CUSTOM_FRAMEWORK_DELETED",
                "CUSTOM_REQUIREMENTS_CREATED",
                "CUSTOM_REQUIREMENTS_DELETED",
                "BACKGROUND_CHECK_CANCELED",
                "JIRA_TICKET_CREATED_CONTROL",
                "JIRA_TICKET_CREATED_TEST",
                "PRE_APPROVED_DOMAIN_REMOVED",
                "PRE_APPROVED_DOMAIN_ADDED",
                "RISK_TICKET_CREATED",
                "PERSONNEL_BG_CHECKS_REVOKED",
                "WORKSPACE_CREATED",
                "WORKSPACE_EDITED",
                "DRATA_SUPPORT_ACCESS_GRANTED",
                "DRATA_SUPPORT_ACCESS_REMOVED",
                "PUBLIC_API_KEY_CREATED",
                "PUBLIC_API_KEY_UPDATED",
                "PUBLIC_API_KEY_REVOKED",
                "VULNERABILITY_FINDINGS_SYNCED",
                "VULNERABILITY_FINDING_CREATED",
                "VULNERABILITY_FINDING_UPDATED",
                "VULNERABILITY_AUDIT_PACKAGE_DOWNLOAD",
                "POLICY_TEMPLATE_DOWNLOADED",
                "EXTERNAL_DOCUMENT_LINKED_TO_POLICY",
                "PUBLIC_API_KEY_ALLOW_LIST_IP_ADDRESSES_EDITED",
                "CONTROL_TICKET_UNLINKED",
                "MONITOR_TICKET_UNLINKED",
                "RISK_TICKET_UNLINKED",
                "AP_FORMER_PERSONNEL_OFFBOARDED",
                "PERSONNEL_OFFBOARDING_TICKET_LINKED",
                "PERSONNEL_OFFBOARDING_TICKET_UNLINKED",
                "AUTOMATED_OFFBOARDING_TOGGLE",
                "AUTOMATED_OFFBOARDING_CONFIGURED",
                "AUTOMATED_OFFBOARDING_FAILED",
                "DEVICE_DOCUMENT_UPLOADED",
                "DEVICE_DELETED",
                "CUSTOM_REQUIREMENTS_UPDATED",
                "DEVICE_FAILED",
                "VENDOR_SECURTIY_QUESTIONNAIRE_CREATED",
                "VENDOR_SECURTIY_QUESTIONNAIRE_UPDATED",
                "VENDOR_SECURTIY_QUESTIONNAIRE_DELETED",
                "RISK_DASHBOARD_DOWNLOADED",
                "NDA_UPLOADED",
                "NDA_DELETED",
                "RISK_NOTE_ADDED",
                "RISK_NOTE_UPDATED",
                "RISK_NOTE_DELETED",
                "ASSET_OWNER_UPDATED",
                "CONTROL_TEST_INSTANCE_NOTE_ADDED",
                "CONTROL_TEST_INSTANCE_NOTE_DELETED",
                "CONTROL_TEST_INSTANCE_NOTE_EDITED",
                "SERVICE_PROVIDER_DELETED",
                "SERVICE_PROVIDER_ADDED"
              ],
              "type": "string"
            }
          },
          {
            "name": "source",
            "required": false,
            "in": "query",
            "example": "UPLOAD_EXTERNAL_EVIDENCE",
            "description": "Filter data to events of this source",
            "schema": {
              "enum": [
                "APP",
                "AUTOPILOT",
                "PUBLIC_API",
                "VENDOR_QUESTIONNAIRE"
              ],
              "type": "string"
            }
          },
          {
            "name": "category",
            "required": false,
            "in": "query",
            "example": "COMPANY",
            "description": "Filter data to events of this category",
            "schema": {
              "enum": [
                "AUTOPILOT",
                "AGENT",
                "POLICY",
                "PERSONNEL",
                "REPORT",
                "VENDOR",
                "ASSET",
                "COMPANY",
                "ASSESSMENT",
                "AUDIT",
                "MONITOR",
                "USER",
                "CONNECTION",
                "GRC",
                "MDM",
                "QUESTIONNAIRE",
                "DEVICE",
                "TRUST_PAGES",
                "TRUST_CENTER_PRIVATE_ACCESS",
                "RISK",
                "COMPANY_NOTIFICATION",
                "CUSTOM_FRAMEWORKS",
                "MUTIPLE_PRODUCT_SUPPORT",
                "PUBLIC_API_KEY",
                "SERVICE_PROVIDER"
              ],
              "type": "string"
            }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "example": "PASSED",
            "description": "Filter data to events of with this status",
            "schema": {
              "enum": [
                "READY",
                "PASSED",
                "FAILED",
                "ERROR",
                "PREAUDIT"
              ],
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "The user to filter events to",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "controlId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "The control to filter events to",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Events"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/events/{id}": {
      "get": {
        "operationId": "EventsPublicController_getEventDetails",
        "summary": "Find event by id",
        "description": "Get details for an event.",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Events"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/infrastructure": {
      "get": {
        "operationId": "UserIdentitiesPublicController_listInfrastructureUsersIdentities",
        "summary": "Find infrastructure user identities",
        "description": "List infrastructure user identities by username or email",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "1a2b3c",
            "description": "Filter data by searching for identity id, username or email",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientType",
            "required": false,
            "in": "query",
            "example": "AWS",
            "description": "The target client type",
            "schema": {
              "enum": [
                "AWS",
                "DIGITAL_OCEAN",
                "GCP",
                "HEROKU",
                "AZURE",
                "ATLAS",
                "CLOUDFLARE",
                "AWS_ORG_UNITS"
              ],
              "type": "string"
            }
          },
          {
            "name": "connectionId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "The target connection id (more granular than client type)",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "USERNAME",
            "description": "Which type of sort (default: USERNAME)",
            "schema": {
              "enum": [
                "IDENTITY_ID",
                "USERNAME",
                "EMAIL",
                "CONNECTED_AT",
                "DISCONNECTED_AT",
                "SERVICE_ACCOUNT",
                "HAS_MFA",
                "ADMIN_ACCESS",
                "DB_ACCESS",
                "USER",
                "CLIENT_ID",
                "CLIENT_ALIAS",
                "CONNECTION_STATUS"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "ASC",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentitiesInfrastructureResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/infrastructure/{id}/connect": {
      "put": {
        "operationId": "UserIdentitiesPublicController_updateUserIdentityInfrastructureConnection",
        "summary": "Update infrastructure user identity connection status",
        "description": "Update the connection status for the target infrastructure user identity",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserIdentityInfrastructureConnectRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentityInfrastructureResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/infrastructure/{id}/toggle": {
      "put": {
        "operationId": "UserIdentitiesPublicController_toggleUserIdentityInfrastructureSetting",
        "summary": "Update target infrastructure user identity toggle settings",
        "description": "Update the toggle setting for the target infrastructure user identity",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserIdentityInfrastructureToggleRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentityInfrastructureResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/infrastructure/{id}/service-account": {
      "put": {
        "operationId": "UserIdentitiesPublicController_setUserIdentityInfrastructureServiceStatus",
        "summary": "Update infrastructure user identity to a service account",
        "description": "Update the target infrastructure user identity to a service account",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserIdentityInfrastructureServiceStatusRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentityInfrastructureResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/version-control": {
      "get": {
        "operationId": "UserIdentitiesPublicController_listUsersIdentitiesVersionControl",
        "summary": "Find version control user identities",
        "description": "List user version control identities for the target client type.",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "1a2b3c",
            "description": "Filter data by searching for identity id, username or email",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientType",
            "required": false,
            "in": "query",
            "example": "GITHUB",
            "description": "The target client type",
            "schema": {
              "enum": [
                "BITBUCKET",
                "GITHUB",
                "GITLAB",
                "AZURE_REPOS",
                "AWS_CODE_COMMIT"
              ],
              "type": "string"
            }
          },
          {
            "name": "connectionId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "The target connection id (more granular than client type)",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "USERNAME",
            "description": "Which type of sort (default: USERNAME)",
            "schema": {
              "enum": [
                "IDENTITY_ID",
                "USERNAME",
                "EMAIL",
                "CONNECTED_AT",
                "DISCONNECTED_AT",
                "SERVICE_ACCOUNT",
                "HAS_MFA",
                "WRITE_ACCESS",
                "PUSH_PROD_CODE_ACCESS",
                "USER",
                "CLIENT_ID",
                "CONNECTION_STATUS"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "ASC",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentitiesVersionControlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/version-control/{id}/connect": {
      "put": {
        "operationId": "UserIdentitiesPublicController_updateUserIdentityVersionControlConnection",
        "summary": "Update version control user identity connection status",
        "description": "Update the connection status for the target version control user identity",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserIdentityVersionControlConnectRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentityVersionControlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/version-control/{id}/toggle": {
      "put": {
        "operationId": "UserIdentitiesPublicController_toggleUserIdentityVersionControlSetting",
        "summary": "Update target version control user identity toggle settings",
        "description": "Update the toggle setting for the target version control user identity",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserIdentityVersionControlToggleRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentityVersionControlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/user-identities/version-control/{id}/service-account": {
      "put": {
        "operationId": "UserIdentitiesPublicController_setUserIdentityVersionControlServiceStatus",
        "summary": "Update version control user identity to a service account",
        "description": "Update the target version control user identity to a service account",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserIdentityVersionControlServiceStatusRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserIdentityVersionControlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User Identities"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/users/{id}/documents": {
      "post": {
        "operationId": "UsersPublicController_uploadDocumentForUser",
        "summary": "Upload a document for user by user id",
        "description": "Upload document for user",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/UserDocumentRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserDocumentResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "413": {
            "description": "The file was too large to upload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "Third party system was unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Users"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "get": {
        "operationId": "UsersPublicController_getAllDocuments",
        "summary": "Find user documents by user id",
        "description": "List user documents given the provided search terms and filters",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "Security training 2020",
            "description": "Filter documents by name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "example": "SEC_TRAINING",
            "description": "Filter documents by their type",
            "schema": {
              "enum": [
                "SEC_TRAINING",
                "PASSWORD_MANAGER_EVIDENCE",
                "AUTO_UPDATES_EVIDENCE",
                "HARD_DRIVE_ENCRYPTION_EVIDENCE",
                "ANTIVIRUS_EVIDENCE",
                "LOCK_SCREEN_EVIDENCE",
                "MFA_EVIDENCE",
                "HIPAA_TRAINING_EVIDENCE",
                "OFFBOARDING_EVIDENCE"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAllDocumentsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Users"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/users/documents/{id}/download": {
      "get": {
        "operationId": "UsersPublicController_getUserDocumentDownloadUrl",
        "summary": "Get user document download url by document id",
        "description": "Get signed download link for user document",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedUrlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Users"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/users/documents/{docId}/{userId}": {
      "delete": {
        "operationId": "UsersPublicController_deleteDocumentForUser",
        "summary": "Remove user document by document id and user id",
        "description": "Remove user document",
        "parameters": [
          {
            "name": "docId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Users"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/personnel": {
      "get": {
        "operationId": "PersonnelPublicController_listPersonnel",
        "summary": "Find personnel by search terms and filters",
        "description": "List personnel given the search terms and filters",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "John Doe",
            "description": "Filter data by searching for first name, last name, full name, or email",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "employmentStatus",
            "required": false,
            "in": "query",
            "example": "CURRENT_EMPLOYEE",
            "description": "Filter data to personnel of this employment status",
            "schema": {
              "enum": [
                "CURRENT_EMPLOYEE",
                "FORMER_EMPLOYEE",
                "CURRENT_CONTRACTOR",
                "FORMER_CONTRACTOR",
                "OUT_OF_SCOPE",
                "UNKNOWN",
                "SPECIAL_FORMER_EMPLOYEE",
                "SPECIAL_FORMER_CONTRACTOR"
              ],
              "type": "string"
            }
          },
          {
            "name": "employmentStatuses[]",
            "required": false,
            "in": "query",
            "example": [
              "CURRENT_EMPLOYEE"
            ],
            "description": "Filter data to personnel of these employment statuses",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "CURRENT_EMPLOYEE",
                  "FORMER_EMPLOYEE",
                  "CURRENT_CONTRACTOR",
                  "FORMER_CONTRACTOR",
                  "OUT_OF_SCOPE",
                  "UNKNOWN",
                  "SPECIAL_FORMER_EMPLOYEE",
                  "SPECIAL_FORMER_CONTRACTOR"
                ]
              }
            }
          },
          {
            "name": "fullCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by a compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "acceptedPoliciesCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by accepted policies compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "identityMfaCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by identity MFA compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "bgCheckCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by background check compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "agentInstalledCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by monitor agent installation compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "passwordManagerCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by password manager compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "autoUpdatesCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by auto updates compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "locationServicesCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by location services compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hdEncryptionCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by HD encryption compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "antivirusCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by antivirus compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "lockScreenCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by lock screen compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "securityTrainingCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by security training compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hipaaTrainingCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by HIPAA Training compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "deviceCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by their device compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "multiSecurityTrainingCompliance",
            "required": false,
            "in": "query",
            "description": "Filter personnel by their training compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "multiTrainingComplianceType",
            "required": false,
            "in": "query",
            "example": "SECURITY_TRAINING",
            "description": "Type of training campaigns (default: SECURITY_TRAINING)",
            "schema": {
              "enum": [
                "SECURITY_TRAINING"
              ],
              "type": "string"
            }
          },
          {
            "name": "offboardingEvidence",
            "required": false,
            "in": "query",
            "description": "Filter personnel by their offboarding evidence compliance",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "groupIds",
            "required": false,
            "in": "query",
            "description": "List of groups to find personnel by",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "useExclusions",
            "required": false,
            "in": "query",
            "description": "Use exclusions on list personnel",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "NAME",
            "description": "Which type of sort (default: NAME)",
            "schema": {
              "enum": [
                "NAME",
                "EMPLOYMENT_STATUS",
                "ACCEPTED_POLICIES",
                "FULL_COMPLIANCE",
                "IDENTITY_MFA",
                "BG_CHECK",
                "AGENT_INSTALLED",
                "OS_VERSION",
                "SERIAL_NUM",
                "PASSWORD_MANAGER",
                "AUTO_UPDATES",
                "HDD_ENCRYPTION",
                "ANTIVIRUS",
                "APPS_COUNT",
                "START_DATE",
                "SEPARATION_DATE",
                "LOCK_SCREEN",
                "SECURITY_TRAINING",
                "HIPAA_TRAINING",
                "OFFBOARDING"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "ASC",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          },
          {
            "name": "mdmSourceType",
            "required": false,
            "in": "query",
            "example": "AGENT",
            "description": "Filter data to personnel of this Mdm source type",
            "schema": {
              "enum": [
                "AGENT",
                "JAMF",
                "INTUNE",
                "KANDJI",
                "JUMPCLOUD",
                "HEXNODE_UEM",
                "UNKNOWN",
                "RIPPLING",
                "WORKSPACE_ONE"
              ],
              "type": "string"
            }
          },
          {
            "name": "inverseMdmSourceTypes[]",
            "required": false,
            "in": "query",
            "example": [
              "AGENT"
            ],
            "description": "Inverse filter data to personnel of these Mdm source types",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "AGENT",
                  "JAMF",
                  "INTUNE",
                  "KANDJI",
                  "JUMPCLOUD",
                  "HEXNODE_UEM",
                  "UNKNOWN",
                  "RIPPLING",
                  "WORKSPACE_ONE"
                ]
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonnelTableResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Personnel"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/personnel/{id}": {
      "get": {
        "operationId": "PersonnelPublicController_getPersonnelDetails",
        "summary": "Get personnel by id",
        "description": "Get the full detail of a personnel record",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonnelDetailsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Personnel"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/personnel/{id}/contract-dates": {
      "put": {
        "operationId": "PersonnelPublicController_updateContractDates",
        "summary": "Update personnel contract dates",
        "description": "Update the hire and separation dates of a personnel record",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PersonnelContractDateRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonnelDetailsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "409": {
            "description": "There is a conflict in the business rules with this request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Personnel"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/vendors": {
      "get": {
        "operationId": "VendorsPublicController_listVendors",
        "summary": "Find vendors by search terms and filters",
        "description": "List vendors given the provided search terms and filters",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "example": "Acme",
            "description": "Filter data to search term",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "NAME",
            "description": "Which type of sort (default: NAME)",
            "schema": {
              "enum": [
                "CATEGORY",
                "NAME",
                "POLICY",
                "RISK",
                "USER"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "ASC",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          },
          {
            "name": "category",
            "required": false,
            "in": "query",
            "example": "ENGINEERING",
            "description": "Filter data to vendors of this category",
            "schema": {
              "enum": [
                "ENGINEERING",
                "PRODUCT",
                "MARKETING",
                "CS",
                "SALES",
                "FINANCE",
                "HR",
                "ADMINISTRATIVE",
                "SECURITY"
              ],
              "type": "string"
            }
          },
          {
            "name": "risk",
            "required": false,
            "in": "query",
            "example": "MODERATE",
            "description": "Filter data to vendors of this risk level",
            "schema": {
              "enum": [
                "NONE",
                "LOW",
                "MODERATE",
                "HIGH"
              ],
              "type": "string"
            }
          },
          {
            "name": "critical",
            "required": false,
            "in": "query",
            "example": false,
            "description": "Filter data to vendors depending on if it is considered critical",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "passwordPolicy",
            "required": false,
            "in": "query",
            "example": "USERNAME_PASSWORD",
            "description": "Filter data to vendors with this password policy",
            "schema": {
              "enum": [
                "USERNAME_PASSWORD",
                "SSO",
                "LDAP"
              ],
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Filter data to a person responsible for vendors",
            "schema": {
              "maximum": 1000000000,
              "type": "number"
            }
          },
          {
            "name": "withLastQuestionnaires",
            "required": false,
            "in": "query",
            "example": false,
            "description": "Add last questionnaires to vendors",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isArchived",
            "required": false,
            "in": "query",
            "example": false,
            "description": "Get archived or unarchived vendors",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "renewalDate",
            "required": false,
            "in": "query",
            "example": "2023-03-31",
            "description": "Vendor renewal date",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "renewalScheduleType",
            "required": false,
            "in": "query",
            "example": "ONE_YEAR",
            "description": "Vendor renewal schedule type",
            "schema": {
              "enum": [
                "ONE_MONTH",
                "TWO_MONTHS",
                "THREE_MONTHS",
                "SIX_MONTHS",
                "ONE_YEAR",
                "CUSTOM"
              ],
              "type": "string"
            }
          },
          {
            "name": "renewalDateStatus",
            "required": false,
            "in": "query",
            "example": "COMPLETED",
            "description": "Vendor renewal status based on how close it is to the renewal due date",
            "schema": {
              "enum": [
                "NO_RENEWAL",
                "COMPLETED",
                "RENEWAL_DUE_SOON",
                "RENEWAL_DUE"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "operationId": "VendorsPublicController_createVendor",
        "summary": "Add a new vendor to the account",
        "description": "Create a new vendor resource in the account",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VendorRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/vendors/{id}": {
      "get": {
        "operationId": "VendorsPublicController_getVendor",
        "summary": "Find vendor by id",
        "description": "Get a vendor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "put": {
        "operationId": "VendorsPublicController_updateVendor",
        "summary": "Update vendor details by id",
        "description": "Update a vendor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VendorRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "operationId": "VendorsPublicController_deleteVendor",
        "summary": "Remove a vendor by id",
        "description": "Delete a vendor",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Good to go!"
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/vendors/{id}/documents": {
      "post": {
        "operationId": "VendorsPublicController_uploadVendorDocument",
        "summary": "Upload document by vendor id",
        "description": "Upload vendor documents",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/VendorDocumentRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "413": {
            "description": "The file was too large to upload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "Third party system was unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/vendors/{id}/questionnaires": {
      "get": {
        "operationId": "VendorsPublicController_listVendorQuestionnaires",
        "summary": "Find vendor questionnaires by vendor id, page and limit",
        "description": "List vendor questionnaires by vendor id",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuestionnairesSentResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "operationId": "VendorsPublicController_sendQuestionnaireEmail",
        "summary": "Add a questionnaire to vendor by recipient email",
        "description": "Send questionnaire to recipient email",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QuestionnaireSentRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuestionnairesSentResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Vendors"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/tickets": {
      "post": {
        "operationId": "TicketsPublicController_createTicket",
        "summary": "Add a new to ticket to JIRA",
        "description": "Sync ticket id with data from JIRA",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketsCreateRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TicketCreateResponsePublicDto"
                }
              }
            }
          },
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "Third party system was unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Tickets"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/controls": {
      "get": {
        "operationId": "TrustCenterPublicController_getControls",
        "summary": "List monitoring controls",
        "description": "Get all the information of the monitoring controls",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitoringControlsResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/requests/{id}": {
      "get": {
        "operationId": "TrustCenterPublicController_getTrustCenterAccessRequest",
        "summary": "Get trust center access request by request id",
        "description": "Get the trust center request",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrustCenterRequestDocumentWithNameResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/requests/{id}/approve": {
      "put": {
        "operationId": "TrustCenterPublicController_approveRequest",
        "summary": "Approve access to private files by request id",
        "description": "Trust Center approve access to private files",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrustCenterRequestApproveResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/requests/{id}/deny": {
      "put": {
        "operationId": "TrustCenterPublicController_deniedRequest",
        "summary": "Deny access to private files by request id",
        "description": "Deny access to private files for Trust Center",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrustCenterRequestDeniedResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/private-access": {
      "get": {
        "operationId": "TrustCenterPublicController_getPrivateAccessData",
        "summary": "Get the private access info",
        "description": "Get private access info",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrustCenterPrivateAccessResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/company-info/private-access": {
      "put": {
        "operationId": "TrustCenterPublicController_updateCompanyInfoPrivateAccess",
        "summary": "Edit the company information private access section",
        "description": "Update the company information private access section",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanyInfoPrivateAccessRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanyInfoResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/private-documents": {
      "get": {
        "operationId": "TrustCenterPublicController_getAllPrivateDocuments",
        "summary": "Get all private documents",
        "description": "Get all the policies, compliance and security reports private documents",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrustCenterAllPrivateDocumentsResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/trust-center/requests": {
      "post": {
        "operationId": "TrustCenterPublicController_createTrustCenterAccessRequest",
        "summary": "Create trust center request",
        "description": "Create a trust center request for private documents",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrustCenterRequestRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!"
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "TrustCenter"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/workspaces/{workspaceId}/autopilot/{testId}/retest": {
      "post": {
        "operationId": "AutopilotPublicController_retest",
        "summary": "Run an autopilot test by test id",
        "description": "Run an autopilot test",
        "parameters": [
          {
            "name": "testId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "workspaceId",
            "required": true,
            "in": "path",
            "description": "The Workspace ID associated to the Account",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "201": {
            "description": ""
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "409": {
            "description": "There is a conflict in the business rules with this request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Autopilot"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/background-check/{userId}/manual": {
      "post": {
        "operationId": "BackgroundCheckPublicController_updateBackgroundCheck",
        "summary": "Upload a background check evidence to a user",
        "description": "Manually upload a background check URL for a user",
        "parameters": [
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ManualBackgroundCheckRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonnelDetailsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "409": {
            "description": "There is a conflict in the business rules with this request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Background Check"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/devices/{id}/documents": {
      "post": {
        "operationId": "DevicePublicController_uploadDocumentForDevice",
        "summary": "Upload device compliance document by device id",
        "description": "Upload a new device document for a given device",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/DeviceDocumentRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeviceDocumentResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "413": {
            "description": "The file was too large to upload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "Third party system was unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Devices"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "get": {
        "operationId": "DevicePublicController_getDeviceDocuments",
        "summary": "Find device documents by document type",
        "description": "Get a list of documents for a given device and document type",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "example": "ANTIVIRUS_EVIDENCE",
            "description": "Filter documents by their type",
            "schema": {
              "enum": [
                "PASSWORD_MANAGER_EVIDENCE",
                "AUTO_UPDATES_EVIDENCE",
                "HARD_DRIVE_ENCRYPTION_EVIDENCE",
                "ANTIVIRUS_EVIDENCE",
                "LOCK_SCREEN_EVIDENCE"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeviceDocumentsResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Devices"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/devices/documents/{id}/download": {
      "get": {
        "operationId": "DevicePublicController_getDeviceDocumentDownloadUrl",
        "summary": "Get device document download url by document id",
        "description": "Get signed download URL for device document.",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedUrlResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Devices"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/risk-management": {
      "get": {
        "operationId": "RiskManagementPublicController_listRisks",
        "summary": "Find risks by search terms and filters",
        "description": "List all risks",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Which page of data are you requesting",
            "schema": {
              "default": 1,
              "type": "number"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "example": 10,
            "description": "How many items are your requesting",
            "schema": {
              "maximum": 50,
              "default": 20,
              "type": "number"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "example": "ID",
            "description": "Which type of sort (default: ID)",
            "schema": {
              "enum": [
                "ID",
                "RISK_SCORE"
              ],
              "type": "string"
            }
          },
          {
            "name": "sortDir",
            "required": false,
            "in": "query",
            "example": "ASC",
            "description": "Which direction to sort the data (default: ASC)",
            "schema": {
              "enum": [
                "ASC",
                "DESC"
              ],
              "type": "string"
            }
          },
          {
            "name": "q",
            "required": false,
            "in": "query",
            "description": "Query to find a risks",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "applicable",
            "required": false,
            "in": "query",
            "description": "Filter risks by aplicable",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isScored",
            "required": false,
            "in": "query",
            "description": "Filter risks by scored or not scored",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "treatmentPlan",
            "required": false,
            "in": "query",
            "example": "NEEDS_TREATMENT",
            "description": "Filter risks by treatment plan",
            "schema": {
              "enum": [
                "NEEDS_TREATMENT",
                "ACCEPT",
                "TRANSFER",
                "AVOID",
                "MITIGATE"
              ],
              "type": "string"
            }
          },
          {
            "name": "categoriesIds",
            "required": false,
            "in": "query",
            "example": [
              1,
              2,
              3
            ],
            "description": "List of categories ids to find risks by",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "ownersIds",
            "required": false,
            "in": "query",
            "example": [
              1,
              2,
              3
            ],
            "description": "List of owners ids to find risks by",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            }
          },
          {
            "name": "needsAttention",
            "required": false,
            "in": "query",
            "description": "Filter risks by controls that are not ready",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "impact",
            "required": false,
            "in": "query",
            "example": 3,
            "description": "Filter by the impact",
            "schema": {
              "minimum": 1,
              "maximum": 5,
              "type": "number"
            }
          },
          {
            "name": "likelihood",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Filter by the likelihood",
            "schema": {
              "minimum": 1,
              "maximum": 5,
              "type": "number"
            }
          },
          {
            "name": "minScore",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Filter by the range of scores",
            "schema": {
              "minimum": 1,
              "maximum": 25,
              "type": "number"
            }
          },
          {
            "name": "maxScore",
            "required": false,
            "in": "query",
            "example": 1,
            "description": "Filter by range of scores",
            "schema": {
              "minimum": 1,
              "maximum": 25,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RisksPaginatedResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Risk Management"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "operationId": "RiskManagementPublicController_createCustomRisk",
        "summary": "Add a new custom risk to the account",
        "description": "Create a custom risk",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RiskRequestPublicDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record created!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RiskResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "409": {
            "description": "There is a conflict in the business rules with this request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Risk Management"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/public/risk-management/{id}": {
      "get": {
        "operationId": "RiskManagementPublicController_getRisk",
        "summary": "Get risk details",
        "description": "Get a risk by id",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RiskResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Risk Management"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "patch": {
        "operationId": "RiskManagementPublicController_updateRiskPartially",
        "summary": "Edit risk details",
        "description": "Updates a risk partially",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RiskRequestOptionalPublicDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Good to go!",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RiskResponsePublicDto"
                }
              }
            }
          },
          "400": {
            "description": "Malformed data and/or validation errors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "401": {
            "description": "Invalid Authorization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "You are not allowed to perform this action",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "404": {
            "description": "Record Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponsePublicDto"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Response Code: 412<br><br>You must accept the Drata terms and conditions to use the API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExceptionResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Risk Management"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "DRATA API Beta Documentation",
    "description": "REST API powering partners and friends 🏄",
    "version": "1.0.0",
    "contact": {},
    "license": {
      "name": "MIT",
      "url": "/"
    }
  },
  "tags": [],
  "servers": [
    {
      "url": "https://public-api.drata.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "API_KEY",
        "type": "http"
      }
    },
    "schemas": {
      "ExceptionResponseDto": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "number"
          },
          "message": {
            "type": "object"
          },
          "code": {
            "type": "number"
          }
        },
        "required": [
          "statusCode",
          "message",
          "code"
        ]
      },
      "ResponseDto": {
        "type": "object",
        "properties": {}
      },
      "AssetClassTypeResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Asset class type ID"
          },
          "assetClassType": {
            "type": "string",
            "example": "DOCUMENT",
            "description": "The string enum asset class type"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "asset class type created timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "asset class type update timestamp"
          }
        },
        "required": [
          "id",
          "assetClassType",
          "createdAt",
          "updatedAt"
        ]
      },
      "BackgroundCheckResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "The Background Check Id"
          },
          "userId": {
            "type": "number",
            "example": 1,
            "description": "The user ID"
          },
          "status": {
            "type": "string",
            "example": "OK",
            "description": "The status of the KarmaCheck case"
          },
          "caseId": {
            "type": "string",
            "example": "abc123",
            "description": "The case ID of the KarmaCheck background check"
          },
          "caseInvitationId": {
            "type": "string",
            "example": "abc123",
            "description": "The case invitation ID of the KarmaCheck background check"
          },
          "url": {
            "type": "string",
            "example": "https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
            "description": "The URL of the background check"
          },
          "manualCheckDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date this background check was manually uploaded"
          },
          "manuallyCheckUrl": {
            "type": "string",
            "example": "url.com",
            "description": "The url of manual background check"
          },
          "type": {
            "type": "string",
            "example": "CERTN",
            "description": "The background check type"
          },
          "source": {
            "type": "string",
            "example": "DRATA",
            "description": "The background check source"
          },
          "reportData": {
            "type": "string",
            "description": "The background check report data"
          },
          "user": {
            "description": "The related background check user",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "outOfScopeReason": {
            "type": "string",
            "example": "abc123",
            "description": "the reason it was marked out of scope"
          },
          "outOfScopeAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "when it was marked out of scope date timestamp"
          },
          "invitationEmail": {
            "type": "string",
            "example": "email@email.com",
            "description": "Invitation email"
          },
          "linkedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report linked to a user date timestamp"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report updated date timestamp"
          }
        },
        "required": [
          "id",
          "userId",
          "status",
          "caseId",
          "caseInvitationId",
          "url",
          "manualCheckDate",
          "manuallyCheckUrl",
          "type",
          "source",
          "reportData",
          "user",
          "outOfScopeReason",
          "outOfScopeAt",
          "invitationEmail",
          "linkedAt",
          "createdAt",
          "updatedAt"
        ]
      },
      "FrameworkResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "123",
            "description": "Framework id"
          },
          "name": {
            "type": "string",
            "example": "SOC2",
            "description": "Framework name"
          },
          "hasLevel": {
            "type": "boolean",
            "example": true,
            "description": "Does the framework have a level"
          },
          "levelLabel": {
            "type": "string",
            "nullable": true,
            "example": true,
            "description": "What is the framework level"
          },
          "selectedLevel": {
            "type": "string",
            "nullable": true,
            "example": "42",
            "description": "id of the level tag"
          },
          "privacy": {
            "type": "boolean",
            "nullable": true,
            "example": true,
            "description": "privacy flag for NIST80053"
          },
          "description": {
            "type": "string",
            "example": "Report on controls at a Service Organization",
            "description": "Framework description"
          },
          "longDescription": {
            "type": "string",
            "example": "",
            "description": "A longer description describing the framework in detail"
          },
          "slug": {
            "type": "string",
            "example": "soc2-slug",
            "description": "Framework Slug used to identify the framework"
          },
          "tag": {
            "type": "string",
            "example": "SOC2",
            "description": "A tag representing the framework"
          },
          "label": {
            "type": "string",
            "example": "SOC 2",
            "description": "A pill name representing the framework"
          },
          "totalEnabledControls": {
            "type": "number",
            "example": "42",
            "description": "The number of associated Drata controls"
          },
          "totalInScopeControls": {
            "type": "number",
            "example": "42",
            "description": "The number of associated Drata controls"
          },
          "numInScopeRequirements": {
            "type": "number",
            "example": "42",
            "description": "The number of associated Drata requirements that are in scope"
          },
          "numReadyInScopeRequirements": {
            "type": "number",
            "example": "42",
            "description": "The number of associated Drata requirements that are \"ready\""
          },
          "enabledAt": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "example": true,
            "description": "State of the framework for the tenant"
          },
          "frameworkEnabled": {
            "type": "boolean",
            "example": true,
            "description": "State of the framework for the tenant"
          },
          "controlsEnabled": {
            "type": "boolean",
            "example": true,
            "description": "State of the controls for this framework for the tenant"
          },
          "color": {
            "type": "string",
            "example": "#174880",
            "description": "The font color assigned for this framework"
          },
          "bgColor": {
            "type": "string",
            "example": "#174880",
            "description": "The background color assigned for this framework"
          },
          "activeLogo": {
            "type": "string",
            "example": "https://drata.com",
            "description": "The URL of the active logo"
          },
          "inactiveLogo": {
            "type": "string",
            "example": "https://drata.com",
            "description": "The URL of the inactive logo"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Account created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Account updated date timestamp"
          },
          "isReady": {
            "type": "boolean",
            "example": true,
            "description": "Is the framework ready"
          },
          "productFrameworkEnabled": {
            "type": "boolean",
            "example": true,
            "description": "State of the framework for the product"
          },
          "customFrameworkId": {
            "type": "string",
            "example": "00000000-0000-0000-0000-000000000000",
            "description": "Custom framework id"
          },
          "type": {
            "type": "string",
            "example": "CUSTOM",
            "description": "The type of the auditor framework"
          }
        },
        "required": [
          "id",
          "name",
          "hasLevel",
          "levelLabel",
          "selectedLevel",
          "privacy",
          "description",
          "longDescription",
          "slug",
          "tag",
          "label",
          "totalEnabledControls",
          "totalInScopeControls",
          "numInScopeRequirements",
          "numReadyInScopeRequirements",
          "enabledAt",
          "frameworkEnabled",
          "controlsEnabled",
          "color",
          "bgColor",
          "activeLogo",
          "inactiveLogo",
          "createdAt",
          "updatedAt",
          "isReady",
          "customFrameworkId",
          "type"
        ]
      },
      "WorkspaceResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Product ID"
          },
          "name": {
            "type": "string",
            "example": "Drata Automation",
            "description": "Product name"
          },
          "description": {
            "type": "string",
            "example": "Drata automates SOC 2 compliance",
            "description": "Product description"
          },
          "howItWorks": {
            "type": "string",
            "example": "Connect your systems to the Drata Autopilot system and sit back and relax!",
            "description": "How does the Product Work?"
          },
          "url": {
            "type": "string",
            "example": "https://drata.com",
            "description": "Product URL"
          },
          "logo": {
            "type": "string",
            "example": "https://cdn-prod.imgpilot.com/logo.png",
            "description": "Product Logo URL"
          },
          "primary": {
            "type": "boolean",
            "example": false,
            "description": "Primary Product"
          },
          "frameworks": {
            "example": "FrameworkResponseDto[]",
            "description": "Frameworks associated to the product.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FrameworkResponsePublicDto"
            }
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "howItWorks",
          "url",
          "logo",
          "primary"
        ]
      },
      "ConnectionProviderTypeResponsePublicDto": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "example": "VERSION_CONTROL",
            "description": "The provider type"
          },
          "isEnabled": {
            "type": "boolean",
            "example": true,
            "description": "Provider type status"
          }
        },
        "required": [
          "value",
          "isEnabled"
        ]
      },
      "ConnectionResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "1",
            "description": "The connection id"
          },
          "clientType": {
            "type": "string",
            "example": "GOOGLE",
            "description": "The client type"
          },
          "state": {
            "type": "string",
            "example": "ACTIVE",
            "description": "The state of the connection"
          },
          "providerType": {
            "type": "string",
            "example": "IDENTITY",
            "description": "The provider type"
          },
          "connected": {
            "type": "boolean",
            "example": false,
            "description": "Connection status"
          },
          "connectedAt": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this connection was succesfully established"
          },
          "failedAt": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this connection failed"
          },
          "key": {
            "type": "string",
            "example": "johnsmith@admin.com",
            "description": "The connection key"
          },
          "companyId": {
            "type": "number",
            "example": "12341234",
            "description": "The associated external company id. Specific to the gusto connection"
          },
          "assignmentId": {
            "type": "string",
            "example": "FLk12AsS",
            "description": "The associated external assignment id. Specific to the curricula connection"
          },
          "user": {
            "description": "The user that established the connection",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "accountId": {
            "type": "string",
            "description": "The related accound id to that connection"
          },
          "clientId": {
            "type": "string",
            "example": "drata.com",
            "description": "The client id from the external system associated to this connection"
          },
          "clientAlias": {
            "type": "string",
            "example": "My-connection-alias-1",
            "description": "Alias for the connection"
          },
          "manuallyUpdatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Connection manuallyUpdatedAts timestamp"
          },
          "aliasUpdatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Connection alias updated-at timestamp for manually updated aliases"
          },
          "deletedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Connection deletedAt timestamp"
          },
          "requestorId": {
            "type": "number",
            "example": "328d3016-71f3-4485-af20-06ce8044da18",
            "description": "Goodhire RequestorId value"
          },
          "product": {
            "type": "object",
            "example": "",
            "description": "product background check"
          },
          "writeAccessEnabled": {
            "type": "boolean",
            "example": false,
            "description": "Write scope is enabled on the connection"
          },
          "sourcePreference": {
            "type": "string",
            "example": "LABEL",
            "description": "User source preference for Jira"
          },
          "securityLabel": {
            "type": "string",
            "example": "Jira Security Label",
            "description": "Used in Jira to categorize tickets as security issues."
          },
          "jqlQuery": {
            "type": "string",
            "example": "project = IT AND type = “Offboarding”",
            "description": "Query used in Jira to categorize tickets"
          },
          "authorized": {
            "type": "boolean",
            "example": true,
            "description": "account authorized flag for Checkr"
          },
          "workspaces": {
            "example": [
              {
                "id": 1,
                "name": "Drata",
                "description": "Platform to track SOC 2 compliance within the organization",
                "howItWorks": null,
                "url": "https://app.drata.com",
                "logo": "https://cdn.drata.com/icon/icon_fwhite_bblue_256.png",
                "primary": true
              }
            ],
            "description": "Workspaces related to the connection",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WorkspaceResponsePublicDto"
            }
          },
          "providerTypes": {
            "example": [
              5
            ],
            "description": "Provider types associated with this connection",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ConnectionProviderTypeResponsePublicDto"
            }
          },
          "code": {
            "nullable": true,
            "enum": [
              "UNDEFINED",
              "HEALTH_CHECK",
              "INTERNAL_SERVER_ERROR",
              "VALIDATION",
              "ORM_VALIDATION",
              "COMPANY_EXISTS",
              "ENTRY_EXISTS",
              "JWT_EMPTY_ENTRY",
              "JWT_EMPTY_SITE_ADMIN",
              "JWT_EMPTY_ACCOUNT",
              "JWT_EMPTY_PAYLOAD",
              "JWT_EMPTY_PAYLOAD_DATA",
              "JWT_EMPTY_AUTHORIZATION",
              "JWT_INVALID_SIGNATURE",
              "JWT_MISSING_USER",
              "JWT_MISSING_ROLES",
              "JWT_MISSING_PRODUCT_ROLE",
              "JWT_MISSING_ACCOUNT",
              "JWT_MISSING_SITE_ADMIN",
              "ENTITY_NOT_FOUND",
              "MONITOR_TEST_NOT_FOUND",
              "BAD_CODE",
              "BAD_ACCESS_TOKEN",
              "CONFLICT_SELF",
              "CONFLICT_PERSONNEL_OK",
              "VERSION_NOT_FOUND",
              "CONFLICT_DEPENDENCY",
              "AGENT_MISSING_BODY",
              "AGENT_MISSING_FIELDS",
              "AGENT_EMPTY_ACCOUNT",
              "ACCOUNT_NOT_FOUND",
              "ACCOUNT_PENDING",
              "ACCOUNT_MAINTENANCE",
              "ACCOUNT_NON_PAYMENT",
              "ACCOUNT_ADMIN_DISABLED",
              "ACCOUNT_USER_DELETED",
              "ACCOUNT_UNKNOWN_STATUS",
              "ACCOUNT_CREATION_FAILED",
              "CONNECTION_NOT_FOUND",
              "USER_NOT_FOUND",
              "USER_ROLES_NOT_FOUND",
              "PERSONNEL_NOT_FOUND",
              "PERSONNEL_IS_FORMER_SPECIAL",
              "PERSONNEL_NOT_ACTIVE",
              "PERSONNEL_IS_FORMER",
              "PERSONNEL_IS_OUT_OF_SCOPE",
              "PERSONNEL_SELF_STATUS_TO_FORMER_STATUS",
              "PERSONNEL_ALREADY_HAS_SAME_STATUS",
              "CONFLICT_SEPARATION_DATE_WITH_UNKNOWN_STATUS",
              "CONFLICT_UNKNOWN_STATUS_AND_HRIS",
              "PERSONNEL_IS_ON_HRIS",
              "SEPARATION_DATE_IS_REQUIRED",
              "INVALID_SEPARATION_DATE_FOR_CURRENT_DATE",
              "TOKEN_EXPIRED",
              "DRATA_TERMS_NOT_AGREED_TO",
              "BACKGROUND_CHECK_ALREADY_STARTED",
              "BACKGROUND_CHECK_MISSING_PACKAGES",
              "BACKGROUND_CHECK_UNAUTHORIZED",
              "CONFLICT_MONITOR_CHECK_STATUS",
              "CONFLICT_USER_IDENTITY_VERSION_CONTROL_LINK",
              "CONFLICT_USER_INFRASTRUCTURE_CONTROL_LINK",
              "PUBLISH_FRAMEWORK_MISSING_ELEMENT",
              "CONFLICT_DUPLICATE_PROVIDER_CONNECTION",
              "CONFLICT_MISMATCHED_EMAIL_DOMAIN",
              "CONFLICT_COMMENT_AUTHOR",
              "NONEXISTENT_COMMENT_THREAD",
              "CONFLICT_COMMENT_EXISTS",
              "SECURITY_REPORT_NOT_SHAREABLE",
              "SECURITY_REPORT_SHARE_TOKEN_MISMATCH",
              "RIPPLING_SERVICE_ERROR",
              "ONBOARDING_STEP_LOCKED",
              "ONBOARDING_NOT_COMPLETE",
              "POLICY_NAME_UNAVAILABLE",
              "MERGEDEV_LINK_TOKEN_FAILED",
              "MERGEDEV_ACCESS_TOKEN_FAILED",
              "REFRESH_TOKEN_NOT_FOUND",
              "MAGIC_TOKEN_NOT_FOUND",
              "POLICY_VERSION_TOO_LOW",
              "POLICY_ALREADY_APPROVED",
              "POLICY_NOT_FOUND",
              "NO_ENABLED_FRAMEWORKS_FOR_POLICY",
              "JWT_EMPTY_AUDITOR",
              "JWT_MISSING_AUDITOR",
              "AUDITOR_CLIENT_FORBIDDEN",
              "JWT_AUDITOR_MISSING_CLIENT",
              "CONFLICT_DUPLICATE_CLIENT_ID_CONNECTION",
              "CONFLICT_CONNECTION_CLIENTID",
              "CONFLICT_CONNECTION_CLIENT_ALIAS",
              "CONFLICT_CONNECTION_AUTOPOPULATED_CLIENTID",
              "CONFLICT_CONNECTION_AUTOPOPULATED_CLIENT_ALIAS",
              "CONFLICT_CONNECTION_MULTIPLE_PROVIDER_TYPE",
              "AUTHENTICATION_ERROR_WORK_OS",
              "AUTHENTICATION_ERROR_SOCKET",
              "AUTHENTICATION_ERROR_WORK_OS_MISSING_PROFILE",
              "AUTHENTICATION_ERROR_WORK_OS_MISSING_EMAIL",
              "PAYMENT_REQUIRED",
              "NO_CONTROLS_FOUND",
              "CONFLICT_CONTROL_NEEDS_REQUIREMENT",
              "INVALID_DOMAIN",
              "CONFLICT_DUPLICATED_AUDITOR",
              "CONFLICT_MISMATCH_DATA",
              "EMPLOYEE_AUDITOR_CONFLICT",
              "API_KEY_NOT_FOUND",
              "CUSTOMER_UNAUTHORIZED",
              "INVALID_CODE_PREFIX",
              "DUPLICATE_CONTROL_CODE",
              "REQUIREMENT_DOES_NOT_EXIST",
              "NO_REQUIREMENTS_FOUND",
              "SSO_ENFORCED",
              "IDP_ENFORCED",
              "SETTING_NOT_FOUND",
              "CANNOT_CHANGE_DCF_CONTROL_CODE",
              "CANNOT_CHANGE_OTHER_USER_SETTING",
              "DUPLICATED_FRAMEWORK",
              "FRAMEWORK_NOT_RELATED",
              "POLICY_VERSION_NOT_FOUND",
              "FRAMEWORK_NOT_FOUND",
              "FRAMEWORK_DISABLED",
              "FRAMEWORKS_NOT_PROVISIONED",
              "INVALID_FILE_NAME",
              "JWT_MISSING_TOKEN",
              "CONFLICT_DUPLICATE_CLIENT_CONNECTION",
              "DIFFERENT_DEVICE_OWNER",
              "CONFLICT_DEVICE_ALREADY_IN_USE",
              "CANNOT_ENABLE_ACCOUNT_FEATURE",
              "CANNOT_DISABLE_ACCOUNT_FEATURE",
              "ACCOUNT_FEATURE_TOGGLE_INVALID_FEATURE_TYPE",
              "TRUST_CENTER_CNAME",
              "TRUST_CENTER_POLICY_NOT_FOUND",
              "TRUST_CENTER_SECURITY_REPORT_NOT_FOUND",
              "TRUST_CENTER_NDA_NOT_FOUND",
              "TRUST_CENTER_NDA_DOWNLOAD",
              "TRUST_CENTER_REQUEST_FILES_DOWNLOAD",
              "TRUST_CENTER_REQUEST_NOT_FOUND",
              "TRUST_CENTER_REQUEST_DOCUMENT_NOT_FOUND",
              "TRUST_CENTER_REQUEST_INVALID",
              "TRUST_CENTER_REQUEST_ZIP_NOT_FOUND",
              "TRUST_CENTER_COMPANY_INFO_NOT_FOUND",
              "TRUST_CENTER_EMAIL_DOMAIN_NOT_FOUND",
              "FEATURE_ANNOUNCEMENT_DISMISSAL_DUPLICATED",
              "CONFLICT_CROSS_TENANT_ENTRY",
              "CONFLICT_CROSS_ENTRY_EMAIL",
              "TRUST_CENTER_FORBIDDEN",
              "TRUST_CENTER_SUB_PROCESSORS_INFO_NOT_FOUND",
              "MULTIPLE_PRODUCT_SUPPORT_PRODUCT_NOT_FOUND",
              "CONFLICT_USER_OBSERVABILITY_CONTROL_LINK",
              "NOTIFICATION_CONNECTION_NOT_AVAILABLE",
              "NOTIFICATIONS_NOT_FOUND",
              "CUSTOM_FRAMEWORK_NOT_SAVED",
              "CUSTOM_REQUIREMENT_NOT_SAVED",
              "CONFLICT_DUPLICATE_REQUIREMENT_CODE",
              "CONFLICT_REQUIREMENT_ALREADY_EXISTS",
              "CONFLICT_INVALID_REQUIREMENT",
              "CREATE_TICKET_DATATYPE_NOT_SUPPORTED",
              "CREATE_TICKET_FIELD_NOT_VALID",
              "TICKET_STRUCTURE_NOT_SUPPORTED",
              "TICKET_NOT_FOUND",
              "CONNECTION_WITH_WRITE_ACCESS_NOT_FOUND",
              "SDLC_INVALID_QUERY",
              "SDLC_SERVICE_UNAVAILABLE",
              "CONFLICT_AUDITOR_LOGIN",
              "CONFLICT_MULTI_DOMAIN_DISABLED",
              "BEARER_TOKEN_NOT_FOUND",
              "PUBLIC_API_KEY_NOT_FOUND",
              "PUBLIC_API_KEY_ACCOUNT_NOT_FOUND",
              "PUBLIC_API_KEY_FORBIDDEN",
              "MERGEDEV_ACCOUNT_NEEDS_RELINK",
              "ENDPOINT_NOT_FOUND",
              "DATADOG_LOGS_READ_ARCHIVES_PERMISSION",
              "DATADOG_USAGE_READ_PERMISSION",
              "DATADOG_SECURITY_NOTIFICATION_PERMISSION",
              "DATADOG_CONNECTION_REQUEST_INVALID",
              "WORKSPACE_NAME_ALREADY_EXISTS",
              "GOOGLE_IDP_ACCESS_DENIED",
              "GOOGLE_IDP_INVALID_GRANT",
              "GITHUB_ORGANIZATION_NOT_FOUND",
              "AWS_CONNECTION_ACCESS_DENIED",
              "MICROSOFT_365_INVALID_DOMAIN",
              "MICROSOFT_365_ACCESS_DENIED",
              "GCP_INVALID_GRANT",
              "GCP_ACCESS_DENIED",
              "AZURE_ACCESS_DENIED",
              "OKTA_ACCESS_DENIED",
              "CLOUDFLARE_ACCESS_DENIED",
              "CLOUDFLARE_NO_ACCOUNTS",
              "GITLAB_ACCESS_DENIED",
              "GITLAB_NOT_FOUND",
              "BITBUCKET_ACCESS_DENIED",
              "DOCUSIGN_BAD_CLIENT_ID",
              "SITE_ADMIN_MISSING_ADMIN_ROLE",
              "AUDITOR_INVALID_DATA",
              "TICKET_MONITORING_NOT_FOUND",
              "AUTOMATE_TICKETING_CONNECTION_NOT_FOUND",
              "TICKET_MONITORING_FIELD_NOT_FOUND",
              "FIELDS_NOT_FOUND",
              "PRODUCT_NOT_FOUND",
              "TICKET_STRUCTURE_MISSING_SUMMARY",
              "MTLS_CLIENT_CERT_MISSING",
              "MTLS_UNAUTHORIZED_CN",
              "MTLS_NOT_ENABLED",
              "MTLS_ACCOUNT_HEADER_MISSING",
              "ROLE_PERMISSION_FORBIDDEN",
              "MDM_UNAUTHORIZED",
              "SERVICE_PROVIDER_DUPLICATED",
              "SERVICE_PROVIDER_NOT_ALLOWED_DOMAIN",
              "SERVICE_GROUP_DUPLICATED_DOMAIN",
              "JWT_MISSING_SERVICE_USER",
              "JWT_EMPTY_SERVICE_USER",
              "AUDITOR_EXISTS",
              "SERVICE_USER_NOT_FOUND"
            ],
            "type": "string",
            "example": "ACCOUNT_ADMIN_DISABLED",
            "description": "ErrorCode"
          },
          "groupLabel": {
            "type": "string",
            "nullable": true,
            "example": "Everyone",
            "description": "Used by some IDPs to only sync users from a specific group"
          }
        },
        "required": [
          "id",
          "clientType",
          "state",
          "providerType",
          "connected",
          "connectedAt",
          "failedAt",
          "key",
          "companyId",
          "assignmentId",
          "user",
          "accountId",
          "clientId",
          "clientAlias",
          "manuallyUpdatedAt",
          "aliasUpdatedAt",
          "deletedAt",
          "requestorId",
          "product",
          "writeAccessEnabled",
          "sourcePreference",
          "securityLabel",
          "jqlQuery",
          "authorized",
          "workspaces",
          "code",
          "groupLabel"
        ]
      },
      "UserIdentityResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "User identity ID"
          },
          "identityId": {
            "type": "string",
            "example": "1a2b3c",
            "description": "External service unique id"
          },
          "username": {
            "type": "string",
            "example": "Username",
            "description": "External service username"
          },
          "connectedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was linked to an application user"
          },
          "disconnectedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was unlinked to an application user"
          },
          "hasMfa": {
            "type": "boolean",
            "example": true,
            "description": "Indicates the external user MFA status"
          },
          "user": {
            "description": "The linked system user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "connection": {
            "description": "ConnectionResponsePublicDto",
            "allOf": [
              {
                "$ref": "#/components/schemas/ConnectionResponsePublicDto"
              }
            ]
          },
          "hasIdp": {
            "type": "boolean",
            "example": true,
            "description": "Indicates if user is connected with Idp"
          }
        },
        "required": [
          "id",
          "identityId",
          "username",
          "connectedAt",
          "disconnectedAt",
          "hasMfa",
          "user",
          "connection",
          "hasIdp"
        ]
      },
      "UserResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "User ID"
          },
          "email": {
            "type": "string",
            "example": "email@email.com",
            "description": "User email"
          },
          "firstName": {
            "type": "string",
            "example": "Sally",
            "description": "User first name"
          },
          "lastName": {
            "type": "string",
            "example": "Smith",
            "description": "User last name"
          },
          "jobTitle": {
            "type": "string",
            "example": "CEO",
            "description": "User job title"
          },
          "avatarUrl": {
            "type": "string",
            "example": "https://cdn-prod.imgpilot.com/avatar.png",
            "description": "User avatar URL"
          },
          "drataTermsAgreedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User agreed to the Drata terms date timestamp"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User updated date timestamp"
          },
          "roles": {
            "example": [
              "ROLE",
              "ANOTHER_ROLE"
            ],
            "description": "User roles",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "backgroundChecks": {
            "description": "The Background Checks array DTO",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BackgroundCheckResponsePublicDto"
            }
          },
          "identities": {
            "description": "User identities",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserIdentityResponsePublicDto"
            }
          }
        },
        "required": [
          "id",
          "email",
          "firstName",
          "lastName",
          "jobTitle",
          "avatarUrl",
          "drataTermsAgreedAt",
          "createdAt",
          "updatedAt",
          "roles",
          "backgroundChecks",
          "identities"
        ]
      },
      "DeviceComplianceCheckResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Device compliance check ID"
          },
          "compliant": {
            "type": "boolean",
            "example": true,
            "description": "Denotes actual compliance"
          },
          "type": {
            "type": "string",
            "example": "PASSWORD_MANAGER",
            "description": "The compliance type"
          },
          "expiresAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this compliance is due for a re-verification"
          },
          "checkFrequency": {
            "type": "string",
            "example": "DAILY",
            "description": "How often should this check be run for compliance"
          },
          "lastCheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Compliance check last checked timestamp"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Compliance check creation timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Compliance check updated timestamp"
          }
        },
        "required": [
          "id",
          "compliant",
          "type",
          "expiresAt",
          "checkFrequency",
          "lastCheckedAt",
          "createdAt",
          "updatedAt"
        ]
      },
      "DeviceIdentifierResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Device identifier Id"
          },
          "type": {
            "type": "string",
            "example": "SERIAL_NUMBER",
            "description": "The identifier type"
          },
          "identifier": {
            "type": "string",
            "example": "C02CG123DC79",
            "description": "The identifier value"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Identifier createdAt timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Identifier updatedAt timestamp"
          }
        },
        "required": [
          "id",
          "type",
          "identifier",
          "createdAt",
          "updatedAt"
        ]
      },
      "DeviceDocumentResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Device document ID"
          },
          "type": {
            "type": "string",
            "example": "PASSWORD_MANAGER_EVIDENCE",
            "description": "The device document type"
          },
          "name": {
            "type": "string",
            "example": "Password Manager Evidence",
            "description": "The document name"
          },
          "fileUrl": {
            "type": "string",
            "nullable": true,
            "example": "http://localhost:5000/download/device-documents/1",
            "description": "The secure URL to the device document"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Device document created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Device document updated date timestamp"
          }
        },
        "required": [
          "id",
          "type",
          "name",
          "fileUrl",
          "createdAt",
          "updatedAt"
        ]
      },
      "DeviceResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Device Id"
          },
          "osVersion": {
            "type": "string",
            "example": "MacOS 10.15.6",
            "description": "The device operating system version"
          },
          "serialNumber": {
            "type": "string",
            "example": "C02T6CDJGTFL",
            "description": "The device serial number"
          },
          "model": {
            "type": "string",
            "example": "MacBook Pro",
            "description": "The device model"
          },
          "screenLockTime": {
            "type": "number",
            "example": "60",
            "description": "The number of seconds the lock screen must be enabled before this device is prompted to enter a password"
          },
          "agentVersion": {
            "type": "string",
            "example": "1.0",
            "description": "The agent version this device uses"
          },
          "macAddress": {
            "type": "string",
            "example": "65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E",
            "description": "The device MAC address"
          },
          "admins": {
            "type": "string",
            "example": "Admin A",
            "description": "The device admins"
          },
          "processor": {
            "type": "string",
            "example": "Intel(R) Core(TM) i7-6700HQ CPU @ 2.60GHz",
            "description": "The device processor"
          },
          "memory": {
            "type": "string",
            "example": "17179869184",
            "description": "The device total physical memory in bytes"
          },
          "hddSize": {
            "type": "string",
            "example": "1TB",
            "description": "The device HDD size"
          },
          "graphics": {
            "type": "string",
            "example": "RTX 3080",
            "description": "The device graphics card"
          },
          "encryptionEnabled": {
            "type": "boolean",
            "example": false,
            "description": "Denotes device actual encryption status"
          },
          "firewallEnabled": {
            "type": "boolean",
            "example": true,
            "description": "Denotes device actual firewall status"
          },
          "gateKeeperEnabled": {
            "type": "boolean",
            "example": false,
            "description": "Denotes device actual gate keeper status"
          },
          "lastCheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Last time device data checked by the source"
          },
          "sourceType": {
            "type": "string",
            "example": "AGENT",
            "description": "The device source type"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "The device created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "The device updated date timestamp"
          },
          "deletedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "The device deleted date timestamp"
          },
          "appsCount": {
            "type": "number",
            "example": 20,
            "description": "The number of applications installed"
          },
          "complianceChecks": {
            "example": [],
            "description": "The device compliance checks list",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeviceComplianceCheckResponsePublicDto"
            }
          },
          "identifiers": {
            "example": [],
            "description": "The device identifiers list",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeviceIdentifierResponsePublicDto"
            }
          },
          "documents": {
            "example": [],
            "description": "The device documents list",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeviceDocumentResponsePublicDto"
            }
          },
          "isDeviceCompliant": {
            "type": "boolean",
            "example": false,
            "description": "Is device compliant"
          }
        },
        "required": [
          "id",
          "osVersion",
          "serialNumber",
          "model",
          "screenLockTime",
          "agentVersion",
          "macAddress",
          "admins",
          "processor",
          "memory",
          "hddSize",
          "graphics",
          "encryptionEnabled",
          "firewallEnabled",
          "gateKeeperEnabled",
          "lastCheckedAt",
          "sourceType",
          "createdAt",
          "updatedAt",
          "deletedAt",
          "appsCount",
          "complianceChecks",
          "identifiers",
          "documents",
          "isDeviceCompliant"
        ]
      },
      "AssetResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Assessment ID"
          },
          "name": {
            "type": "string",
            "example": "MacbookPro 13",
            "description": "The name of the asset"
          },
          "description": {
            "type": "string",
            "example": "MacbookPro 13",
            "description": "The description of the asset"
          },
          "assetType": {
            "type": "string",
            "example": "PHYSICAL",
            "description": "The asset type"
          },
          "assetProvider": {
            "type": "string",
            "example": "AGENT",
            "description": "The asset source provider"
          },
          "approvedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When the asset was approved (if applicable)"
          },
          "removedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When the asset stopped being tracked"
          },
          "assetClassTypes": {
            "example": "AssetClassTypeResponseDto[]",
            "description": "Asset class types associated to this asset",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetClassTypeResponsePublicDto"
            }
          },
          "company": {
            "type": "string",
            "example": "Acme, Inc",
            "description": "The owning company of the asset"
          },
          "owner": {
            "description": "The user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "employmentStatus": {
            "type": "string",
            "example": "CURRENT_EMPLOYEE",
            "description": "The employment status of the personnel"
          },
          "notes": {
            "type": "string",
            "description": "The asset notes"
          },
          "assetReferenceType": {
            "type": "string",
            "example": "PERSONNEL",
            "description": "The asset reference type"
          },
          "uniqueId": {
            "type": "string",
            "example": "C02T6CDJGTFL",
            "description": "Unique Id associated with this asset"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "asset created timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "asset update timestamp"
          },
          "device": {
            "description": "The device response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/DeviceResponsePublicDto"
              }
            ]
          },
          "externalId": {
            "type": "string",
            "example": "i-0c844e3b433e4e3f",
            "description": "An externally sourced unique identifier for a virtual asset"
          },
          "externalOwnerId": {
            "type": "string",
            "example": "account-353",
            "description": "Used to track the source of virtual assets, typically an account id."
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "assetType",
          "assetProvider",
          "approvedAt",
          "removedAt",
          "assetClassTypes",
          "company",
          "owner",
          "notes",
          "assetReferenceType",
          "uniqueId",
          "createdAt",
          "updatedAt",
          "device",
          "externalId"
        ]
      },
      "AssetsResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "AssetRequestPublicDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 191,
            "example": "Asset name",
            "description": "The asset name"
          },
          "description": {
            "type": "string",
            "maxLength": 30000,
            "example": "This is a description",
            "description": "The asset description"
          },
          "notes": {
            "type": "string",
            "maxLength": 191,
            "example": "This is a note",
            "description": "The asset notes"
          },
          "assetClassTypes": {
            "items": {
              "type": "array"
            },
            "example": [
              "HARDWARE",
              "PERSONNEL"
            ],
            "description": "The asset class types",
            "type": "array"
          },
          "assetType": {
            "enum": [
              "PHYSICAL",
              "VIRTUAL"
            ],
            "type": "string",
            "example": "PHYSICAL",
            "description": "The asset type"
          },
          "ownerId": {
            "type": "number",
            "example": 1,
            "description": "The owner id"
          },
          "uniqueId": {
            "type": "string",
            "example": "C02T6CDJGTFL",
            "description": "Unique Id associated with this asset"
          },
          "removedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date the asset was removed"
          },
          "externalId": {
            "type": "string",
            "example": "i-0c844e3b433e4e3f",
            "description": "An externally sourced unique identifier for a virtual asset"
          },
          "externalOwnerId": {
            "type": "string",
            "example": "account-353",
            "description": "Used to track the source of virtual assets, typically an account id"
          }
        },
        "required": [
          "name",
          "description",
          "assetClassTypes",
          "assetType",
          "ownerId"
        ]
      },
      "ExceptionResponsePublicDto": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "number"
          },
          "message": {
            "type": "object"
          },
          "code": {
            "type": "number"
          }
        },
        "required": [
          "statusCode",
          "message",
          "code"
        ]
      },
      "ConnectionsResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "WorkspacesResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [
              {
                "id": 1,
                "name": "Drata",
                "description": "Platform to track SOC 2 compliance within the organization",
                "howItWorks": null,
                "url": "https://app.drata.com",
                "logo": "https://cdn.drata.com/icon/icon_fwhite_bblue_256.png",
                "primary": true
              }
            ],
            "description": "Products related to the connection",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WorkspaceResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "ControlMonitorResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "123",
            "description": "Control id"
          },
          "name": {
            "type": "string",
            "example": "Databases Monitored and Alarmed",
            "description": "Control name"
          },
          "code": {
            "type": "string",
            "example": "DCF-1002",
            "description": "Control code"
          },
          "description": {
            "type": "string",
            "example": "Drata has implemented tools to monitor Drata's databases and notify appropriate personnel of any events or incidents based on predetermined criteria. Incidents are escalated per policy.",
            "description": "Control description"
          },
          "question": {
            "type": "string",
            "example": "Does the organization implement tools to monitor its databases and notify appropriate personnel of incidents based on predetermined criteria?",
            "description": "Control question"
          },
          "activity": {
            "type": "string",
            "example": "1. Ensure tools are implemented to monitor databases             2. Ensure notifications based on specific criteria are sent to the appropriate personnel             3. Escalate incidents appropriately",
            "description": "Control activity"
          },
          "slug": {
            "type": "string",
            "example": "databases-monitored-and-alarmed",
            "description": "Control slug"
          },
          "archivedAt": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date control was archived at or NULL"
          }
        },
        "required": [
          "id",
          "name",
          "code",
          "description",
          "question",
          "activity",
          "slug",
          "archivedAt"
        ]
      },
      "ReportResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Report ID"
          },
          "name": {
            "type": "string",
            "example": "2020 SOC 2 Type I Report",
            "description": "The name of the report"
          },
          "type": {
            "type": "string",
            "example": "SOC2_TYPE_I",
            "description": "The type of report"
          },
          "fileUrl": {
            "type": "string",
            "example": "http://localhost:5000/download/reports/1",
            "description": "The secure URL to the report"
          },
          "description": {
            "type": "string",
            "nullable": true,
            "example": "We passed with flying colors",
            "description": "The description of the report"
          },
          "filedAt": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date in which the report was originally filed/created"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report updated date timestamp"
          },
          "user": {
            "description": "The user that uploaded the report",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "controls": {
            "description": "Array of controls mapped to this report",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlMonitorResponsePublicDto"
            }
          },
          "renewalDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "Report renewal date"
          },
          "renewalScheduleType": {
            "type": "string",
            "example": "ONE_YEAR",
            "description": "The renewal date schedule type of report"
          },
          "isExpired": {
            "type": "boolean",
            "example": false,
            "description": "The report is expired; passed its renewal date"
          }
        },
        "required": [
          "id",
          "name",
          "type",
          "fileUrl",
          "filedAt",
          "createdAt",
          "updatedAt",
          "user",
          "controls",
          "renewalDate",
          "renewalScheduleType",
          "isExpired"
        ]
      },
      "ReportsResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReportResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "CreateReportRequestPublicDto": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "format": "binary"
          },
          "name": {
            "type": "string",
            "maxLength": 191,
            "example": "2020 SOC 2 Type I Report",
            "description": "The name of the report"
          },
          "type": {
            "enum": [
              "SOC1",
              "SOC2_TYPE_I",
              "SOC2_TYPE_II",
              "SOC3",
              "RISK",
              "REMEDIATION",
              "VULNERABILITY",
              "PEN_TEST",
              "DR",
              "ARCH",
              "NETWORK",
              "AOC",
              "CERTIFICATE",
              "NOTES",
              "INCIDENT",
              "QUESTIONNAIRE",
              "DATA_FLOW",
              "OTHER",
              "INTERNAL_AUDIT",
              "CORRECTIVE_ACTION",
              "MANAGEMENT_REVIEW",
              "EVENT_LOGS",
              "MONITORING",
              "MEASUREMENTS",
              "BUSINESS_IMPACT_ANALYSIS",
              "ISMS_PLAN"
            ],
            "type": "string",
            "example": "SOC2_TYPE_I",
            "description": "The type of report"
          },
          "filedAt": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date in which the report was originally filed/created"
          },
          "description": {
            "type": "string",
            "maxLength": 30000,
            "example": "We passed with flying colors",
            "description": "The description of the report"
          },
          "ownerId": {
            "type": "number",
            "example": 1,
            "description": "Owner id"
          },
          "renewalDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "Report renewal date"
          },
          "renewalScheduleType": {
            "enum": [
              "ONE_MONTH",
              "TWO_MONTHS",
              "THREE_MONTHS",
              "SIX_MONTHS",
              "ONE_YEAR",
              "CUSTOM"
            ],
            "type": "string",
            "example": "ONE_YEAR",
            "description": "The renewal date schedule type of report"
          }
        },
        "required": [
          "file",
          "name",
          "type",
          "filedAt",
          "ownerId",
          "renewalDate",
          "renewalScheduleType"
        ]
      },
      "UpdateReportRequestPublicDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 191,
            "example": "2020 SOC 2 Type I Report",
            "description": "The name of the report"
          },
          "type": {
            "enum": [
              "SOC1",
              "SOC2_TYPE_I",
              "SOC2_TYPE_II",
              "SOC3",
              "RISK",
              "REMEDIATION",
              "VULNERABILITY",
              "PEN_TEST",
              "DR",
              "ARCH",
              "NETWORK",
              "AOC",
              "CERTIFICATE",
              "NOTES",
              "INCIDENT",
              "QUESTIONNAIRE",
              "DATA_FLOW",
              "OTHER",
              "INTERNAL_AUDIT",
              "CORRECTIVE_ACTION",
              "MANAGEMENT_REVIEW",
              "EVENT_LOGS",
              "MONITORING",
              "MEASUREMENTS",
              "BUSINESS_IMPACT_ANALYSIS",
              "ISMS_PLAN"
            ],
            "type": "string",
            "example": "SOC2_TYPE_I",
            "description": "The type of report"
          },
          "filedAt": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date in which the report was originally filed/created"
          },
          "description": {
            "type": "string",
            "maxLength": 30000,
            "example": "We passed with flying colors",
            "description": "The description of the report"
          },
          "ownerId": {
            "type": "number",
            "example": 1,
            "description": "Owner id"
          },
          "renewalDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "Report renewal date"
          },
          "renewalScheduleType": {
            "enum": [
              "ONE_MONTH",
              "TWO_MONTHS",
              "THREE_MONTHS",
              "SIX_MONTHS",
              "ONE_YEAR",
              "CUSTOM"
            ],
            "type": "string",
            "example": "ONE_YEAR",
            "description": "The renewal date schedule type of report"
          }
        },
        "required": [
          "name",
          "type",
          "filedAt",
          "ownerId",
          "renewalDate",
          "renewalScheduleType"
        ]
      },
      "ControlPaginatedResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlPaginatedResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "MappedExternalEvidencePaginatedResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "SignedUrlResponsePublicDto": {
        "type": "object",
        "properties": {
          "signedUrl": {
            "type": "string",
            "example": "https://somedomain.com/filename.pdf?Signature=ABC123",
            "description": "The short lived signed URL to link directly to the private file"
          }
        },
        "required": [
          "signedUrl"
        ]
      },
      "UploadEvidencePublicDto": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "example": "-F 'file=<<Your-Relative-File-Path>>'",
            "format": "binary"
          },
          "url": {
            "type": "string",
            "maxLength": 768,
            "example": "https://url.com",
            "description": "The url to the evidence"
          },
          "filename": {
            "type": "string",
            "maxLength": 191,
            "example": "Screenshot ExternalEvidence",
            "description": "The name of the evidence"
          },
          "base64File": {
            "type": "object",
            "example": {
              "base64String": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg",
              "filename": "excellent-filename"
            },
            "description": "External evidence in Base64 format"
          },
          "description": {
            "type": "string",
            "maxLength": 30000,
            "example": "A screenshot of a computer screen",
            "description": "The description of the evidence"
          },
          "creationDate": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Creation date"
          },
          "renewalDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "Report renewal date"
          },
          "renewalScheduleType": {
            "enum": [
              "ONE_MONTH",
              "TWO_MONTHS",
              "THREE_MONTHS",
              "SIX_MONTHS",
              "ONE_YEAR",
              "CUSTOM"
            ],
            "type": "string",
            "example": "ONE_YEAR",
            "description": "The renewal date schedule type of report"
          }
        },
        "required": [
          "creationDate",
          "renewalDate",
          "renewalScheduleType"
        ]
      },
      "ExternalEvidenceResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "123",
            "description": "ExternalEvidence id"
          },
          "name": {
            "type": "string",
            "example": "Compelling ExternalEvidence",
            "description": "ExternalEvidence name"
          },
          "description": {
            "type": "string",
            "example": "This is very good evidence",
            "description": "ExternalEvidence description"
          },
          "file": {
            "type": "string",
            "example": "/path/to/file.pdf",
            "description": "Path to file"
          },
          "url": {
            "type": "string",
            "example": "https://url.com",
            "description": "Url path"
          },
          "createdAt": {
            "type": "string",
            "example": "2021-06-02",
            "description": "ExternalEvidence createdAt date"
          },
          "renewalDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "Report renewal date"
          },
          "renewalScheduleType": {
            "type": "string",
            "example": "ONE_YEAR",
            "description": "The renewal date schedule type of report"
          },
          "isExpired": {
            "type": "boolean",
            "example": false,
            "description": "The report is expired; passed its renewal date"
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "file",
          "url",
          "createdAt",
          "renewalDate",
          "renewalScheduleType",
          "isExpired"
        ]
      },
      "MappedExternalEvidenceResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "123",
            "description": "Control id"
          },
          "slug": {
            "type": "string",
            "example": "databases-monitored-and-alarmed",
            "description": "Control slug"
          },
          "externalEvidence": {
            "example": "ExternalEvidenceResponseDto[]",
            "description": "ExternalEvidences array",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExternalEvidenceResponsePublicDto"
            }
          }
        },
        "required": [
          "id",
          "slug",
          "externalEvidence"
        ]
      },
      "UserCardResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "User ID"
          },
          "email": {
            "type": "string",
            "example": "email@email.com",
            "description": "User email"
          },
          "firstName": {
            "type": "string",
            "example": "Sally",
            "description": "User first name"
          },
          "lastName": {
            "type": "string",
            "example": "Smith",
            "description": "User last name"
          },
          "jobTitle": {
            "type": "string",
            "example": "CEO",
            "description": "User job title"
          },
          "avatarUrl": {
            "type": "string",
            "example": "https://cdn-prod.imgpilot.com/avatar.png",
            "description": "User avatar URL"
          },
          "drataTermsAgreedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User agreed to the Drata terms date timestamp"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User updated date timestamp"
          }
        },
        "required": [
          "id",
          "email",
          "firstName",
          "lastName",
          "jobTitle",
          "avatarUrl",
          "drataTermsAgreedAt",
          "createdAt",
          "updatedAt"
        ]
      },
      "ControlShortResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "123",
            "description": "Control id"
          },
          "name": {
            "type": "string",
            "example": "Databases Monitored and Alarmed",
            "description": "Control name"
          },
          "code": {
            "type": "string",
            "example": "DCF-1002",
            "description": "Control code"
          },
          "description": {
            "type": "string",
            "example": "Drata has implemented tools to monitor Drata's databases and notify appropriate personnel of any events or incidents based on predetermined criteria. Incidents are escalated per policy.",
            "description": "Control description"
          },
          "question": {
            "type": "string",
            "example": "Does the organization implement tools to monitor its databases and notify appropriate personnel of incidents based on predetermined criteria?",
            "description": "Control question"
          },
          "activity": {
            "type": "string",
            "example": "1. Ensure tools are implemented to monitor databases",
            "description": "Control activity"
          },
          "slug": {
            "type": "string",
            "example": "databases-monitored-and-alarmed",
            "description": "Control slug"
          },
          "archivedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date control was archived at or NULL"
          },
          "lastUpdatedBy": {
            "example": "User",
            "description": "Last user to update the control",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCardResponsePublicDto"
              }
            ]
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date control was last updated"
          },
          "fk_control_template_id": {
            "type": "number",
            "example": "123",
            "description": "Control template id, used to determine if control is custom"
          },
          "hasEvidence": {
            "type": "boolean",
            "example": true,
            "description": "Boolean if control has any linked polices, reports, externalEvidence, or controlTests"
          },
          "isReady": {
            "type": "boolean",
            "example": "true",
            "description": "Is control \"ready\""
          },
          "hasTicket": {
            "type": "boolean",
            "example": "true",
            "description": "This Control is associated to a Task Management Ticket"
          }
        },
        "required": [
          "id",
          "name",
          "code",
          "description",
          "question",
          "activity",
          "slug",
          "archivedAt",
          "lastUpdatedBy",
          "updatedAt",
          "fk_control_template_id",
          "hasEvidence",
          "isReady",
          "hasTicket"
        ]
      },
      "RequirementPaginatedResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "ControlOwnersResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "CreateControlRequestPublicDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 191,
            "example": "Good Control Name",
            "description": "The name of the control"
          },
          "description": {
            "type": "string",
            "maxLength": 30000,
            "example": "A very good description",
            "description": "The description of the control"
          },
          "question": {
            "type": "string",
            "maxLength": 768,
            "example": "A very good question",
            "description": "The question of the control"
          },
          "code": {
            "type": "string",
            "maxLength": 20,
            "example": "DRA-69",
            "description": "The control code"
          },
          "activity": {
            "type": "string",
            "maxLength": 768,
            "example": "A very good activity",
            "description": "The activity of the control"
          },
          "externalEvidenceMetadata": {
            "example": [
              {
                "originalFile": "old-filename.pdf",
                "filename": "excellent-filename.pdf",
                "description": "This is a very good file that everyone likes.",
                "creationDate": "2020-07-06 12:00:00.000000",
                "name": "Evidence Name",
                "renewalDate": "2020-07-06",
                "renewalScheduleType": "ONE_YEAR"
              }
            ],
            "description": "Metadata of uploaded evidence",
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "reportIds": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of report ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "policyIds": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of policy ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "requirementIds": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of requirement ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "owners": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of owner ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "testIds": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of control test ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "externalEvidence": {
            "description": "External evidence files",
            "example": "-F 'file=<<Your-Relative-File-Path>>'",
            "type": "array",
            "items": {
              "type": "string",
              "format": "binary"
            }
          },
          "base64Files": {
            "example": [
              {
                "base64String": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg",
                "filename": "excellent-filename"
              }
            ],
            "description": "External evidence in Base64 format",
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        },
        "required": [
          "name",
          "description",
          "code"
        ]
      },
      "WeekTimeFrameSLAResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Week time frame SLA ID"
          },
          "policyWeekTimeFrameSLAId": {
            "type": "number",
            "example": 1,
            "description": "The corresponding policy week time frame SLA ID this value is for"
          },
          "timeFrame": {
            "type": "string",
            "example": "ONE_DAY",
            "description": "The week time frame value"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Updated date timestamp"
          }
        },
        "required": [
          "id",
          "policyWeekTimeFrameSLAId",
          "timeFrame",
          "createdAt",
          "updatedAt"
        ]
      },
      "P3MatrixSLAResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Week time frame SLA ID"
          },
          "policyP3MatrixSLAId": {
            "type": "number",
            "example": 1,
            "description": "The corresponding P3 matrix SLA ID this value is for"
          },
          "definition": {
            "type": "string",
            "example": "Vulnerabilities that cause a privilege escalation on the platform from unprivileged...",
            "description": "The description for this matrix item"
          },
          "severity": {
            "type": "string",
            "example": "LOW",
            "description": "The severity level"
          },
          "timeFrame": {
            "type": "string",
            "example": "ONE_DAY",
            "description": "The time frame value"
          },
          "examples": {
            "type": "string",
            "example": "Vulnerabilities that result in compromising the system such as Sql injection...",
            "description": "Examples of when this SLA is relevant"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Updated date timestamp"
          }
        },
        "required": [
          "id",
          "policyP3MatrixSLAId",
          "definition",
          "severity",
          "timeFrame",
          "examples",
          "createdAt",
          "updatedAt"
        ]
      },
      "GracePeriodSLAResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Grace period SLA ID"
          },
          "policyGracePeriodSLAId": {
            "type": "number",
            "example": 1,
            "description": "The corresponding policy grace period SLA ID this value is for"
          },
          "gracePeriod": {
            "type": "string",
            "example": "SEVEN_DAYS",
            "description": "The grace period value"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Updated date timestamp"
          }
        },
        "required": [
          "id",
          "policyGracePeriodSLAId",
          "gracePeriod",
          "createdAt",
          "updatedAt"
        ]
      },
      "PolicyVersionResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Policy version ID"
          },
          "version": {
            "type": "number",
            "example": 1,
            "description": "The policy version"
          },
          "current": {
            "type": "boolean",
            "example": true,
            "description": "Is this the current policy (last uploaded/created)"
          },
          "type": {
            "type": "string",
            "example": "UPLOADED",
            "description": "The policy version type"
          },
          "fileUrl": {
            "type": "string",
            "nullable": true,
            "example": "http://localhost:5000/download/policies/1",
            "description": "The secure URL to the policy version"
          },
          "docViewer": {
            "type": "string",
            "example": "NATIVE",
            "description": "The type of document viewer to use"
          },
          "description": {
            "type": "string",
            "nullable": true,
            "example": "This policy defines how you do XYZ",
            "description": "The policy version description"
          },
          "html": {
            "type": "string",
            "nullable": true,
            "example": "<html><body>Text</body></html>",
            "description": "The policy version description html"
          },
          "weekTimeFrameSLAs": {
            "example": "WeekTimeFrameSLAResponsePublicDto[]",
            "description": "The set of week timeframe SLA values for this policy version",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WeekTimeFrameSLAResponsePublicDto"
            }
          },
          "p3MatrixSLAs": {
            "example": "P3MatrixSLAsResponsePublicDto[]",
            "description": "The set of P3 Matrix SLA values for this policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/P3MatrixSLAResponsePublicDto"
            }
          },
          "gracePeriodSLAs": {
            "example": "GracePeriodSLAResponsePublicDto[]",
            "description": "The set of grace period SLA values for this policy version",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GracePeriodSLAResponsePublicDto"
            }
          },
          "approvedAt": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "example": "2020-07-06 12:00:00.000000",
            "description": "Policy version approved at date timestamp"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Policy version created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Policy version last updated date timestamp"
          },
          "owner": {
            "nullable": true,
            "description": "The user that is assigned as the owner of this policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserResponsePublicDto"
            }
          },
          "changesExplanation": {
            "type": "string",
            "nullable": true,
            "example": "- This is what changes in the new version. - And this is another change.",
            "description": "The description of the changes done in the update"
          }
        },
        "required": [
          "id",
          "version",
          "current",
          "type",
          "fileUrl",
          "docViewer",
          "description",
          "html",
          "approvedAt",
          "createdAt",
          "updatedAt",
          "owner",
          "changesExplanation"
        ]
      },
      "PolicyWeekTimeFrameSLAResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "SLA Id"
          },
          "label": {
            "type": "string",
            "example": "Policy SLA",
            "description": "The label for this SLA"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "SLA created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "SLA updated date timestamp"
          }
        },
        "required": [
          "id",
          "label",
          "createdAt",
          "updatedAt"
        ]
      },
      "PolicyGracePeriodSLAResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "SLA Id"
          },
          "label": {
            "type": "string",
            "example": "Policy SLA",
            "description": "The label for this SLA"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "SLA created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "SLA updated date timestamp"
          }
        },
        "required": [
          "id",
          "label",
          "createdAt",
          "updatedAt"
        ]
      },
      "PolicyP3MatrixSLAResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "SLA Id"
          },
          "label": {
            "type": "string",
            "example": "Policy SLA",
            "description": "The label for this SLA"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "SLA created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "SLA updated date timestamp"
          }
        },
        "required": [
          "id",
          "label",
          "createdAt",
          "updatedAt"
        ]
      },
      "GroupResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Group ID"
          },
          "name": {
            "type": "string",
            "example": "Operations",
            "description": "The group name"
          },
          "description": {
            "type": "string",
            "example": "This is an example",
            "description": "The group description"
          },
          "email": {
            "type": "string",
            "example": "email@email.com",
            "description": "Owner email"
          },
          "externalId": {
            "type": "string",
            "example": "23kemoi23em",
            "description": "External ID"
          },
          "source": {
            "type": "string",
            "example": "GOOGLE",
            "description": "The string enum source"
          },
          "domain": {
            "type": "string",
            "example": "email.com",
            "description": "Domain of the group"
          },
          "type": {
            "type": "string",
            "example": "GROUP",
            "description": "Group type"
          },
          "orgUnitPath": {
            "type": "string",
            "example": "asdas/qweqwe/asdasd",
            "description": "Org unit path"
          },
          "membersCount": {
            "type": "number",
            "example": 10,
            "description": "Members count"
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "email",
          "externalId",
          "source",
          "domain",
          "type",
          "orgUnitPath",
          "membersCount"
        ]
      },
      "ReminderResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Reminder ID"
          },
          "completedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date of reminder completion"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Reminder created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Reminder updated date timestamp"
          },
          "deletedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Reminder deleted date timestamp"
          }
        },
        "required": [
          "id",
          "completedAt",
          "createdAt",
          "updatedAt",
          "deletedAt"
        ]
      },
      "PolicyResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Policy ID"
          },
          "templateId": {
            "type": "number",
            "nullable": true,
            "example": 1,
            "description": "The template id used to create this policy, null for custom policies"
          },
          "name": {
            "type": "string",
            "example": "Acceptable Use Policy",
            "description": "The policy name"
          },
          "currentDescription": {
            "type": "string",
            "example": "This policy defines how you do XYZ",
            "description": "The current version's policy description"
          },
          "affidavitMessage": {
            "type": "string",
            "example": "This policy contains information about security",
            "description": "An affadavit swearing the document contains some information"
          },
          "htmlLastUpdated": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Last time the html was saved to the DB"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Policy created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Policy last updated date timestamp"
          },
          "currentOwner": {
            "description": "The user that is assigned as the owner of this policy",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "versions": {
            "example": "PolicyVersionResponsePublicDto[]",
            "description": "The versions of the policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyVersionResponsePublicDto"
            }
          },
          "policyWeekTimeFrameSLAs": {
            "example": "PolicyWeekTimeFrameSLAResponsePublicDto[]",
            "description": "The set of policy week timeframe SLAs for this policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyWeekTimeFrameSLAResponsePublicDto"
            }
          },
          "policyGracePeriodSLAs": {
            "example": "PolicyGracePeriodSLAResponsePublicDto[]",
            "description": "The set of policy grace period SLAs for this policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyGracePeriodSLAResponsePublicDto"
            }
          },
          "policyP3MatrixSLAs": {
            "example": "PolicyP3MatrixSLAResponsePublicDto[]",
            "description": "The set of policy week timeframe SLAs for this policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyP3MatrixSLAResponsePublicDto"
            }
          },
          "groups": {
            "description": "The identity groups assigned to the policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupResponsePublicDto"
            }
          },
          "assignedTo": {
            "type": "string",
            "example": "ALL",
            "description": "The type of policy scope"
          },
          "notifyGroups": {
            "type": "boolean",
            "example": false,
            "description": "Indicates if a notification to a group is send on the policy"
          },
          "reminders": {
            "example": "ReminderResponsePublicDto[]",
            "description": "The set of incomplete reminders for this policy",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReminderResponsePublicDto"
            }
          },
          "policyStatus": {
            "type": "string",
            "example": "ACTIVE",
            "description": "The current status of the policy (ACTIVE, ARCHIVED, REPLACED)"
          }
        },
        "required": [
          "id",
          "templateId",
          "name",
          "currentDescription",
          "affidavitMessage",
          "htmlLastUpdated",
          "createdAt",
          "updatedAt",
          "currentOwner",
          "versions",
          "groups",
          "assignedTo",
          "notifyGroups",
          "reminders",
          "policyStatus"
        ]
      },
      "ReportControlResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Report ID"
          },
          "name": {
            "type": "string",
            "example": "2020 SOC 2 Type I Report",
            "description": "The name of the report"
          },
          "type": {
            "type": "string",
            "example": "SOC2_TYPE_I",
            "description": "The type of report"
          },
          "fileUrl": {
            "type": "string",
            "example": "http://localhost:5000/download/reports/1",
            "description": "The secure URL to the report"
          },
          "description": {
            "type": "string",
            "nullable": true,
            "example": "We passed with flying colors",
            "description": "The description of the report"
          },
          "filedAt": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date in which the report was originally filed/created"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report updated date timestamp"
          },
          "renewalDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "Report renewal date"
          },
          "renewalScheduleType": {
            "type": "string",
            "example": "ONE_YEAR",
            "description": "The renewal date schedule type of report"
          },
          "isExpired": {
            "type": "boolean",
            "example": false,
            "description": "The report is expired; passed its renewal date"
          }
        },
        "required": [
          "id",
          "name",
          "type",
          "fileUrl",
          "filedAt",
          "createdAt",
          "updatedAt",
          "renewalDate",
          "renewalScheduleType",
          "isExpired"
        ]
      },
      "MonitorInstanceCheckTypeResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Monitor instance chek type ID"
          },
          "checkType": {
            "type": "string",
            "example": "AGENT",
            "description": "The check type"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Monitor instance check type creation timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Monitor instance check type updated timestamp"
          }
        },
        "required": [
          "id",
          "checkType",
          "createdAt",
          "updatedAt"
        ]
      },
      "MonitorMetadataDataResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "123",
            "description": "The metadata data id"
          },
          "name": {
            "type": "string",
            "example": "Risk Assessment Report",
            "description": "The name of the data"
          },
          "displayName": {
            "type": "string",
            "example": "The Risk Assessment Report",
            "description": "The display name of the data"
          },
          "email": {
            "type": "string",
            "example": "joe@google.com",
            "description": "The email of the data"
          },
          "avatarUrl": {
            "type": "string",
            "example": "https://avatar.url",
            "description": "The avatar of the data"
          },
          "url": {
            "type": "string",
            "example": "https://tracking.com/issues/420"
          },
          "groups": {
            "example": "[\"group1\", \"group2\"]",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "id",
          "name",
          "displayName",
          "email",
          "avatarUrl",
          "url"
        ]
      },
      "MonitorMetadataExclusionResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "1",
            "description": "The id of the exclusion"
          },
          "targetId": {
            "type": "string",
            "example": "sg-12345",
            "description": "The id of the target exclusion"
          },
          "targetName": {
            "type": "string",
            "example": "Drata Default Security Group",
            "description": "The name of the target exclusion"
          },
          "exclusionReason": {
            "type": "string",
            "example": "An excluded resource",
            "description": "The reason for the excluded resource"
          },
          "exclusionDesignator": {
            "description": "The exclusion designatore",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "connection": {
            "description": "The associated connection if this exclusion has one",
            "allOf": [
              {
                "$ref": "#/components/schemas/ConnectionResponsePublicDto"
              }
            ]
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Exclusion created timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Exclusion update timestamp"
          }
        },
        "required": [
          "id",
          "targetId",
          "targetName",
          "exclusionReason",
          "exclusionDesignator",
          "connection",
          "createdAt",
          "updatedAt"
        ]
      },
      "MonitorInstanceMetadataResponsePublicDto": {
        "type": "object",
        "properties": {
          "checkResultStatus": {
            "type": "string",
            "example": "PASSED",
            "description": "Denotes monitor check pass/fail/issue"
          },
          "type": {
            "type": "string",
            "example": "LIST",
            "description": "The monitor data type"
          },
          "source": {
            "type": "string",
            "example": "AWS",
            "description": "The monitor data source"
          },
          "connectionId": {
            "type": "number",
            "example": "1",
            "description": "The source connection id"
          },
          "clientId": {
            "type": "string",
            "example": "drata-acme",
            "description": "The source connection client id"
          },
          "clientAlias": {
            "type": "string",
            "example": "my-connection-alias",
            "description": "The alias of the connection."
          },
          "clientType": {
            "type": "string",
            "example": "AWS",
            "description": "The source connection client type string representation"
          },
          "pass": {
            "description": "A list of of passed MonitorMetadataDataResponseDto",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorMetadataDataResponsePublicDto"
            }
          },
          "fail": {
            "description": "A list of of failed MonitorMetadataDataResponseDto",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorMetadataDataResponsePublicDto"
            }
          },
          "exclusions": {
            "description": "A list of of MonitorMetadataExclusionsResponseDto",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorMetadataExclusionResponsePublicDto"
            }
          },
          "message": {
            "type": "string",
            "description": "The metadata message string"
          },
          "policyScope": {
            "type": "string",
            "description": "The Policy Scope of the monitor if required"
          },
          "policyName": {
            "type": "string",
            "description": "The Policy Name of the monitor if required"
          },
          "groups": {
            "description": "The Policy group of the monitor if required",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "checkResultStatus",
          "type",
          "source",
          "connectionId",
          "clientId",
          "clientAlias",
          "clientType",
          "pass",
          "fail",
          "exclusions",
          "message",
          "policyScope",
          "policyName",
          "groups"
        ]
      },
      "MonitorInstanceResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Monitor instance id"
          },
          "checkResultStatus": {
            "type": "string",
            "example": "PASSED",
            "description": "Denotes monitor check pass/fail/issue"
          },
          "checkFrequency": {
            "type": "string",
            "example": "DAILY",
            "description": "How often should this monitor instance be running"
          },
          "monitorInstanceCheckTypes": {
            "description": "The monitor instance associated check types",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorInstanceCheckTypeResponsePublicDto"
            }
          },
          "autopilotTaskType": {
            "type": "string",
            "example": "IDENTITY_PROVIDER_MFA_ENABLED",
            "description": "The autopilot task type"
          },
          "failedTestDescription": {
            "type": "string",
            "example": "This test fails when the SSL certificate cannot be verified",
            "description": "The description of why this monitor instance would fail"
          },
          "evidenceCollectionDescription": {
            "type": "string",
            "example": "Curl call to the website",
            "description": "The description of the means to gather evidence"
          },
          "remedyDescription": {
            "type": "string",
            "example": "Enable SSL on your company website",
            "description": "The description of how to remedy this monitor instance"
          },
          "metadata": {
            "description": "A map of MonitorInstanceMetadataResponseDto objects mapped to their connection ids",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorInstanceMetadataResponsePublicDto"
            }
          },
          "enabled": {
            "type": "boolean",
            "example": true,
            "description": "Controls whether this monitor instance is on/off"
          },
          "url": {
            "type": "string",
            "example": "https://help.drata.com",
            "description": "The Help Desk URL for this monitor"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Monitor instance creation timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Monitor instance updated timestamp"
          }
        },
        "required": [
          "id",
          "checkResultStatus",
          "checkFrequency",
          "monitorInstanceCheckTypes",
          "autopilotTaskType",
          "failedTestDescription",
          "evidenceCollectionDescription",
          "remedyDescription",
          "metadata",
          "enabled",
          "url",
          "createdAt",
          "updatedAt"
        ]
      },
      "ControlTestResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Control Test Instance ID"
          },
          "name": {
            "type": "string",
            "example": "A Version Control System is being Used",
            "description": "Name of control test instance"
          },
          "description": {
            "type": "string",
            "example": "Inspected Drata's version control system...",
            "description": "The description of the control test instance"
          },
          "checkResultStatus": {
            "type": "string",
            "example": "PASSED",
            "description": "The compliance status of this control test instance"
          },
          "lastCheck": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Timestamp since this control test has been evaluated for complaince"
          },
          "checkStatus": {
            "type": "string",
            "example": "ENABLED",
            "description": "The system status of this control test instance"
          },
          "disabledMessage": {
            "type": "string",
            "example": "Disabled since it is not applicable to the company",
            "description": "Description regarding why this control test instance is disabled"
          },
          "priority": {
            "type": "string",
            "example": "NORMAL",
            "description": "The priority of this control test instance relative to the rest"
          },
          "autoEnabledAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Control test instance auto enabled timestamp"
          },
          "testId": {
            "type": "number",
            "example": "42",
            "description": "A unique identifier for the control test instance"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Control test instance created timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Control test instance update timestamp"
          },
          "monitorInstances": {
            "example": "MonitorInstanceResponseDto[]",
            "description": "Monitor instances associated to this control test instance",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorInstanceResponsePublicDto"
            }
          },
          "disablingUser": {
            "description": "The user who has disbled this control test instance, if any",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "controls": {
            "example": "ControlMonitorResponseDto[]",
            "description": "Controls associated to this control test instance - usually at least one",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlMonitorResponsePublicDto"
            }
          },
          "monitorInstanceExclusions": {
            "example": "ExclusionDto[]",
            "description": "Monitor instance exclusions for this control test instance",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorMetadataExclusionResponsePublicDto"
            }
          },
          "graph": {
            "type": "object",
            "example": "ControlTestInstanceHistoryType",
            "description": "Graph of control test. history"
          },
          "eventTypes": {
            "items": {
              "type": "array"
            },
            "example": "EventType[]",
            "description": "Control event type array from all monitors",
            "type": "array"
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "checkResultStatus",
          "lastCheck",
          "checkStatus",
          "disabledMessage",
          "priority",
          "autoEnabledAt",
          "testId",
          "createdAt",
          "updatedAt",
          "monitorInstances",
          "disablingUser",
          "controls",
          "monitorInstanceExclusions",
          "graph",
          "eventTypes"
        ]
      },
      "RequirementDetailResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "1213123",
            "description": "Requirement id"
          },
          "name": {
            "type": "string",
            "example": "CC1.1",
            "description": "Requirement name"
          },
          "description": {
            "type": "string",
            "example": "The entity demonstrates a commitment to integrity and ethical values.",
            "description": "Requirement description"
          },
          "longDescription": {
            "type": "string",
            "example": "The entity demonstrates a commitment to integrity and ethical values.",
            "description": "Requirement long description"
          },
          "additionalInfo": {
            "type": "string",
            "example": "The entity demonstrates a commitment to integrity and ethical values.",
            "description": "Additional info surrounding requirement"
          },
          "additionalInfo2": {
            "type": "string",
            "example": "The entity demonstrates a commitment to integrity and ethical values 2.",
            "description": "Additional info surrounding requirement 2"
          },
          "additionalInfo3": {
            "type": "string",
            "example": "The entity demonstrates a commitment to integrity and ethical values 3.",
            "description": "Additional info surrounding requirement 3"
          },
          "isReady": {
            "type": "boolean",
            "example": "true",
            "description": "Is requirement \"ready\""
          },
          "rationale": {
            "type": "string",
            "example": "This requirement is not needed.",
            "description": "Requirement rationale for out of scope."
          },
          "archivedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06",
            "description": "Date the requirement was marked out of scope"
          },
          "frameworkName": {
            "type": "string",
            "example": "SOC 2",
            "description": "The framework name this requirement is associated to"
          },
          "controls": {
            "example": "",
            "description": "Necessary control properties mapped to this requirement, sorted by isReady and then controlNumber",
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "totalInScopeControls": {
            "type": "number",
            "example": "12",
            "description": "Total in scope controls mapped to this requirement"
          },
          "topic": {
            "type": "string",
            "example": "",
            "description": ""
          },
          "category": {
            "type": "string",
            "example": "",
            "description": ""
          },
          "subCategory": {
            "type": "string",
            "example": "",
            "description": ""
          },
          "customFrameworkId": {
            "type": "number",
            "example": "123e4567-e89b-12d3-a456-426614174000",
            "description": "Custom Framework ID"
          },
          "customCategory": {
            "type": "string",
            "example": "",
            "description": ""
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "longDescription",
          "additionalInfo",
          "additionalInfo2",
          "additionalInfo3",
          "isReady",
          "frameworkName",
          "controls",
          "totalInScopeControls",
          "topic",
          "category",
          "subCategory"
        ]
      },
      "FrameworkRequirementsResponsePublicDto": {
        "type": "object",
        "properties": {
          "frameworkTag": {
            "type": "string",
            "example": "HIPAA",
            "description": "The framework tag this requirement is associated to"
          },
          "requirements": {
            "example": "PaginationResponseDto<ControlListRequirement>",
            "description": "A list of requirements associated to this framework",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RequirementDetailResponsePublicDto"
            }
          }
        },
        "required": [
          "frameworkTag",
          "requirements"
        ]
      },
      "ControlResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "123",
            "description": "Control id"
          },
          "name": {
            "type": "string",
            "example": "Databases Monitored and Alarmed",
            "description": "Control name"
          },
          "code": {
            "type": "string",
            "example": "DCF-1002",
            "description": "Control code"
          },
          "description": {
            "type": "string",
            "example": "Drata has implemented tools to monitor Drata's databases and notify appropriate personnel of any events or incidents based on predetermined criteria. Incidents are escalated per policy.",
            "description": "Control description"
          },
          "question": {
            "type": "string",
            "example": "Does the organization implement tools to monitor its databases and notify appropriate personnel of incidents based on predetermined criteria?",
            "description": "Control question"
          },
          "activity": {
            "type": "string",
            "example": "1. Ensure tools are implemented to monitor databases             2. Ensure notifications based on specific criteria are sent to the appropriate personnel             3. Escalate incidents appropriately",
            "description": "Control activity"
          },
          "slug": {
            "type": "string",
            "example": "databases-monitored-and-alarmed",
            "description": "Control slug"
          },
          "archivedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date control was archived at or NULL"
          },
          "frameworkTags": {
            "example": [
              "SOC_2"
            ],
            "description": "Framework tags associated with the control",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "hasEvidence": {
            "type": "boolean",
            "example": false,
            "description": "Indicates if the control has evidence"
          },
          "isMonitored": {
            "type": "boolean",
            "example": false,
            "description": "Indicates if the control has a test"
          },
          "hasOwner": {
            "type": "boolean",
            "example": false,
            "description": "Indicates if the control has at least one owner"
          },
          "policies": {
            "example": "PolicyResponsePublicDto[]",
            "description": "Policies array, limited to id, name, createdAt, file",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyResponsePublicDto"
            }
          },
          "reports": {
            "example": "ReportControlResponsePublicDto[]",
            "description": "Control reports",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReportControlResponsePublicDto"
            }
          },
          "externalEvidence": {
            "example": "ExternalEvidenceResponsePublicDto[]",
            "description": "ExternalEvidences array",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExternalEvidenceResponsePublicDto"
            }
          },
          "controlTests": {
            "example": "ControlTestResponsePublicDto[]",
            "description": "Control tests array",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlTestResponsePublicDto"
            }
          },
          "frameworkRequirements": {
            "example": "FrameworkRequirementsResponsePublicDto[]",
            "description": "A list of associated requirements grouped by frameworks",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FrameworkRequirementsResponsePublicDto"
            }
          },
          "lastUpdatedBy": {
            "example": "User",
            "description": "Last user to update the control",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCardResponsePublicDto"
              }
            ]
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date control was last updated"
          },
          "fk_control_template_id": {
            "type": "number",
            "example": "123",
            "description": "Control template id, used to determine if control is custom"
          },
          "owners": {
            "example": "UserCardResponsePublicDto[]",
            "description": "owners of the control",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserCardResponsePublicDto"
            }
          }
        },
        "required": [
          "id",
          "name",
          "code",
          "description",
          "question",
          "activity",
          "slug",
          "archivedAt",
          "frameworkTags",
          "hasEvidence",
          "isMonitored",
          "hasOwner",
          "policies",
          "reports",
          "externalEvidence",
          "controlTests",
          "frameworkRequirements",
          "lastUpdatedBy",
          "updatedAt",
          "fk_control_template_id",
          "owners"
        ]
      },
      "EditControlRequestPublicDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 191,
            "example": "Good Control Name",
            "description": "The name of the control"
          },
          "description": {
            "type": "string",
            "maxLength": 30000,
            "example": "A very good description",
            "description": "The description of the control"
          },
          "question": {
            "type": "string",
            "maxLength": 768,
            "example": "A very good question",
            "description": "The question of the control"
          },
          "code": {
            "type": "string",
            "maxLength": 20,
            "example": "DRA-69",
            "description": "The control code"
          },
          "activity": {
            "type": "string",
            "maxLength": 768,
            "example": "A very good activity",
            "description": "The activity of the control"
          }
        },
        "required": [
          "name",
          "description"
        ]
      },
      "ControlOwnerBulkRequestPublicDto": {
        "type": "object",
        "properties": {
          "ownerIds": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of owner ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "controlIds": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of control ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          }
        },
        "required": [
          "ownerIds",
          "controlIds"
        ]
      },
      "ControlOwnerRequestPublicDto": {
        "type": "object",
        "properties": {
          "ownerIds": {
            "example": [
              1,
              2,
              3
            ],
            "description": "Array of owner ids",
            "type": "array",
            "items": {
              "type": "number"
            }
          }
        },
        "required": [
          "ownerIds"
        ]
      },
      "ControlTestsPaginatedResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "ControlTestInstanceResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Control Test Instance ID"
          },
          "name": {
            "type": "string",
            "example": "A Version Control System is being Used",
            "description": "Name of control test instance"
          },
          "description": {
            "type": "string",
            "example": "Inspected Drata's version control system...",
            "description": "The description of the control test instance"
          },
          "checkResultStatus": {
            "type": "string",
            "example": "PASSED",
            "description": "The compliance status of this control test instance"
          },
          "lastCheck": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Timestamp since this control test has been evaluated for compliance"
          },
          "checkStatus": {
            "type": "string",
            "example": "ENABLED",
            "description": "The system status of this control test instance"
          },
          "disabledMessage": {
            "type": "string",
            "example": "Disabled since it is not applicable to the company",
            "description": "Description regarding why this control test instance is disabled"
          },
          "priority": {
            "type": "string",
            "example": "NORMAL",
            "description": "The priority of this control test instance relative to the rest"
          },
          "autoEnabledAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Control test instance auto enabled timestamp"
          },
          "testId": {
            "type": "number",
            "example": "42",
            "description": "A unique identifier for the control test instance"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Control test instance created timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Control test instance update timestamp"
          },
          "monitorInstances": {
            "example": "MonitorInstanceResponseDto[]",
            "description": "Monitor instances associated to this control test instance",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorInstanceResponsePublicDto"
            }
          },
          "disablingUser": {
            "description": "The user who has disabled this control test instance, if any",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "controls": {
            "example": "ControlMonitorResponseDto[]",
            "description": "Controls associated to this control test instance - usually at least one",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlMonitorResponsePublicDto"
            }
          },
          "monitorInstanceExclusions": {
            "example": "ExclusionDto[]",
            "description": "Monitor instance exclusions for this control test instance",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorMetadataExclusionResponsePublicDto"
            }
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "checkResultStatus",
          "lastCheck",
          "checkStatus",
          "disabledMessage",
          "priority",
          "autoEnabledAt",
          "testId",
          "createdAt",
          "updatedAt",
          "monitorInstances",
          "disablingUser",
          "controls",
          "monitorInstanceExclusions"
        ]
      },
      "EventResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
            "description": "Event UUID"
          },
          "type": {
            "type": "string",
            "example": "COMPANY_DATA_UPDATED",
            "description": "The type of event"
          },
          "category": {
            "type": "string",
            "example": "COMPANY",
            "description": "The type of event"
          },
          "source": {
            "type": "string",
            "example": "APP",
            "description": "The source of the event (APP or AUTOPILOT)"
          },
          "description": {
            "type": "string",
            "example": "Wile E. Coyote updated the company info.",
            "description": "The description of the event"
          },
          "metadata": {
            "type": "object",
            "example": "EventMetadataType",
            "description": "The event metadata in JSON"
          },
          "status": {
            "type": "string",
            "nullable": true,
            "example": "PASSED",
            "description": "The result of the test if the event type is an Autopilot test, otherwise null"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Report created date timestamp"
          },
          "user": {
            "description": "The user that uploaded the report",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "connection": {
            "type": "object",
            "description": "The associated connection if this event has one"
          },
          "requestDescription": {
            "type": "string",
            "nullable": true,
            "example": "Data was fetched from https://xyz.com/api/v1/data",
            "description": "The human readable explanation of the workings of the associated AP test"
          }
        },
        "required": [
          "id",
          "type",
          "category",
          "source",
          "description",
          "metadata",
          "status",
          "createdAt",
          "user",
          "connection",
          "requestDescription"
        ]
      },
      "EventsResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EventResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "UserIdentitiesInfrastructureResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "UserIdentityInfrastructureConnectRequestPublicDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "number",
            "nullable": true,
            "example": 1,
            "description": "The desired user id to link or null to unlink"
          }
        },
        "required": [
          "userId"
        ]
      },
      "UserIdentityInfrastructureResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "User identity ID"
          },
          "identityId": {
            "type": "string",
            "example": "1a2b3c",
            "description": "External service unique id"
          },
          "username": {
            "type": "string",
            "example": "Username",
            "description": "External service username"
          },
          "email": {
            "type": "string",
            "example": "email@email.com",
            "description": "External service email"
          },
          "connectedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was linked to an application user"
          },
          "disconnectedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was unlinked to an application user"
          },
          "serviceAccount": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was marked a service account"
          },
          "serviceAccountReason": {
            "type": "string",
            "example": "This user is used to deploy code",
            "description": "Description of why this was marked as a service account"
          },
          "user": {
            "description": "The linked system user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "serviceAccountDesignator": {
            "description": "The service account designator user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "hasMfa": {
            "type": "boolean",
            "example": true,
            "description": "Indicates the external user MFA status"
          },
          "connection": {
            "description": "ConnectionResponsePublicDto",
            "allOf": [
              {
                "$ref": "#/components/schemas/ConnectionResponsePublicDto"
              }
            ]
          },
          "lastCheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "The last time the user identity was last checked by the syncing service"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "updated date timestamp"
          },
          "adminAccess": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Indicates external user admin access ability"
          },
          "dbAccess": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Indicates external user production database access ability"
          }
        },
        "required": [
          "id",
          "identityId",
          "username",
          "email",
          "connectedAt",
          "disconnectedAt",
          "serviceAccount",
          "serviceAccountReason",
          "user",
          "serviceAccountDesignator",
          "hasMfa",
          "connection",
          "lastCheckedAt",
          "createdAt",
          "updatedAt",
          "adminAccess",
          "dbAccess"
        ]
      },
      "UserIdentityInfrastructureToggleRequestPublicDto": {
        "type": "object",
        "properties": {
          "toggle": {
            "type": "boolean",
            "example": true,
            "description": "Toggle value for the setting"
          },
          "toggleField": {
            "enum": [
              "INFRASTRUCTURE_ADMIN_ACCESS",
              "INFRASTRUCTURE_DB_ACCESS"
            ],
            "type": "string",
            "example": "INFRASTRUCTURE_ADMIN_ACCESS",
            "description": "The toggle field type to update"
          }
        },
        "required": [
          "toggle"
        ]
      },
      "UserIdentityInfrastructureServiceStatusRequestPublicDto": {
        "type": "object",
        "properties": {
          "serviceAccount": {
            "type": "boolean",
            "example": true,
            "description": "Determines service account state"
          },
          "serviceAccountReason": {
            "type": "string",
            "maxLength": 30000,
            "example": "This account is used to deploy",
            "description": "Reason why this account is being marked as a service account"
          }
        },
        "required": [
          "serviceAccount",
          "serviceAccountReason"
        ]
      },
      "UserIdentitiesVersionControlResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "UserIdentityVersionControlConnectRequestPublicDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "number",
            "nullable": true,
            "example": 1,
            "description": "The desired user id to link or null to unlink"
          }
        },
        "required": [
          "userId"
        ]
      },
      "UserIdentityVersionControlResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "User identity ID"
          },
          "identityId": {
            "type": "string",
            "example": "1a2b3c",
            "description": "External service unique id"
          },
          "username": {
            "type": "string",
            "example": "Username",
            "description": "External service username"
          },
          "email": {
            "type": "string",
            "example": "email@email.com",
            "description": "External service email"
          },
          "connectedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was linked to an application user"
          },
          "disconnectedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was unlinked to an application user"
          },
          "serviceAccount": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this external user was marked a service account"
          },
          "serviceAccountReason": {
            "type": "string",
            "example": "This user is used to deploy code",
            "description": "Description of why this was marked as a service account"
          },
          "user": {
            "description": "The linked system user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "serviceAccountDesignator": {
            "description": "The service account designator user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "hasMfa": {
            "type": "boolean",
            "example": true,
            "description": "Indicates the external user MFA status"
          },
          "connection": {
            "description": "ConnectionResponsePublicDto",
            "allOf": [
              {
                "$ref": "#/components/schemas/ConnectionResponsePublicDto"
              }
            ]
          },
          "lastCheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "The last time the user identity was last checked by the syncing service"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "updated date timestamp"
          },
          "writeAccess": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Indicates external user write access ability"
          },
          "pushProductionCodeAccess": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Indicates external user production code access ability"
          }
        },
        "required": [
          "id",
          "identityId",
          "username",
          "email",
          "connectedAt",
          "disconnectedAt",
          "serviceAccount",
          "serviceAccountReason",
          "user",
          "serviceAccountDesignator",
          "hasMfa",
          "connection",
          "lastCheckedAt",
          "createdAt",
          "updatedAt",
          "writeAccess",
          "pushProductionCodeAccess"
        ]
      },
      "UserIdentityVersionControlToggleRequestPublicDto": {
        "type": "object",
        "properties": {
          "toggle": {
            "type": "boolean",
            "example": true,
            "description": "Toggle value for the setting"
          },
          "toggleField": {
            "enum": [
              "VERSION_CONTROL_WRITE_ACCESS",
              "VERSION_CONTROL_PUSH_PROD_CODE_ACCESS"
            ],
            "type": "string",
            "example": "VERSION_CONTROL_WRITE_ACCESS",
            "description": "The target toggle to update"
          }
        },
        "required": [
          "toggle"
        ]
      },
      "UserIdentityVersionControlServiceStatusRequestPublicDto": {
        "type": "object",
        "properties": {
          "serviceAccount": {
            "type": "boolean",
            "example": true,
            "description": "Determines service account state"
          },
          "serviceAccountReason": {
            "type": "string",
            "maxLength": 30000,
            "example": "This account is used to deploy",
            "description": "Reason why this account is being marked as a service account"
          }
        },
        "required": [
          "serviceAccount",
          "serviceAccountReason"
        ]
      },
      "UserDocumentRequestPublicDto": {
        "type": "object",
        "properties": {
          "type": {
            "enum": [
              "MFA_EVIDENCE",
              "SEC_TRAINING",
              "HIPAA_TRAINING_EVIDENCE",
              "OFFBOARDING_EVIDENCE"
            ],
            "type": "string",
            "example": "SEC_TRAINING",
            "description": "The user document type"
          },
          "file": {
            "type": "string",
            "format": "binary"
          },
          "base64File": {
            "type": "object",
            "example": {
              "base64String": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg",
              "filename": "excellent-filename"
            },
            "description": "External evidence in Base64 format"
          }
        },
        "required": [
          "type",
          "file"
        ]
      },
      "UserDocumentResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "User document ID"
          },
          "name": {
            "type": "string",
            "example": "Security Training",
            "description": "The name the file"
          },
          "type": {
            "type": "string",
            "example": "SEC_TRAINING",
            "description": "The user docment type"
          },
          "fileUrl": {
            "type": "string",
            "nullable": true,
            "example": "http://localhost:5000/download/documents/1",
            "description": "The secure URL to the user document"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User Document created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User Document updated date timestamp"
          }
        },
        "required": [
          "id",
          "name",
          "type",
          "fileUrl",
          "createdAt",
          "updatedAt"
        ]
      },
      "UserAllDocumentsResponsePublicDto": {
        "type": "object",
        "properties": {
          "documents": {
            "description": "Full list of user documents",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserDocumentResponsePublicDto"
            }
          }
        },
        "required": [
          "documents"
        ]
      },
      "ComplianceCheckResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Compliance check ID"
          },
          "compliant": {
            "type": "boolean",
            "example": true,
            "description": "Denotes actual compliance"
          },
          "type": {
            "type": "string",
            "example": "ACCEPTED_POLICIES",
            "description": "The compliance type"
          },
          "expiresAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "When this compliance is due for a re-verification"
          },
          "checkFrequency": {
            "type": "string",
            "example": "DAILY",
            "description": "How often should this check be run for compliance"
          },
          "lastCheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Compliance check last checked timestamp"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Compliance check creation timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Compliance check updated timestamp"
          }
        },
        "required": [
          "id",
          "compliant",
          "type",
          "expiresAt",
          "checkFrequency",
          "lastCheckedAt",
          "createdAt",
          "updatedAt"
        ]
      },
      "ComplianceTestResponsePublicDto": {
        "type": "object",
        "properties": {
          "monitorId": {
            "type": "number",
            "example": 1,
            "description": "Monitor ID"
          },
          "autopilotTaskType": {
            "type": "string",
            "example": "AGENT_AUTO_UPDATES_ENABLED",
            "description": "Autopilot Task Type"
          },
          "controlTestInstanceId": {
            "type": "number",
            "example": 43,
            "description": "Control Test Instance ID"
          },
          "testId": {
            "type": "number",
            "example": 43,
            "description": "Test ID"
          },
          "name": {
            "type": "string",
            "example": "MFA on Identity Provider",
            "description": "Test name"
          },
          "checkStatus": {
            "type": "string",
            "example": "ENABLED",
            "description": "Check Status"
          },
          "checkResultStatus": {
            "type": "string",
            "example": "PASSED",
            "description": "Check Result Status"
          },
          "lastCheck": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Last tested timestamp"
          }
        },
        "required": [
          "monitorId",
          "autopilotTaskType",
          "controlTestInstanceId",
          "testId",
          "name",
          "checkStatus",
          "checkResultStatus",
          "lastCheck"
        ]
      },
      "PersonnelDataResponsePublicDto": {
        "type": "object",
        "properties": {
          "osVersion": {
            "type": "string",
            "example": "MacOS 10.15.6",
            "description": "The Operating System version this personnel uses"
          },
          "serialNumber": {
            "type": "string",
            "example": "C02T6CDJGTFL",
            "description": "Workstation Serial Number this personnel uses"
          },
          "screenLockTime": {
            "type": "number",
            "example": "60",
            "description": "The number of seconds the lock screen must be enabled before this personnel is prompted to enter a password"
          },
          "agentVersion": {
            "type": "string",
            "example": "1.0",
            "description": "The Agent version this personnel uses"
          },
          "macAddress": {
            "type": "string",
            "example": "65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E",
            "description": "The MAC addresses of the machine this personnel uses"
          },
          "processor": {
            "type": "string",
            "example": "Intel(R) Core(TM) i7-6700HQ CPU @ 2.60GHz",
            "description": "The process of the machine this personnel uses"
          },
          "memory": {
            "type": "string",
            "example": "17179869184",
            "description": "The total physical memory in bytes of the machine this personnel uses"
          },
          "hddSize": {
            "type": "string",
            "example": "1TB",
            "description": "The HDD size of the machine this personnel uses"
          },
          "graphics": {
            "type": "string",
            "example": "RTX 3080",
            "description": "The Graphics card of the machine this personnel uses"
          },
          "lastcheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Personnel data last checked by agent timestamp"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Personnel created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Personnel updated date timestamp"
          }
        },
        "required": [
          "osVersion",
          "serialNumber",
          "screenLockTime",
          "agentVersion",
          "macAddress",
          "processor",
          "memory",
          "hddSize",
          "graphics",
          "lastcheckedAt",
          "createdAt",
          "updatedAt"
        ]
      },
      "PersonnelDetailsTableResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Personnel Id"
          },
          "employmentStatus": {
            "type": "string",
            "example": "CURRENT_EMPLOYEE",
            "description": "The employment status of the personnel"
          },
          "notHumanReason": {
            "type": "string",
            "example": "This is not a real personnel, but a placeholder for anyone in charge of X",
            "description": "Reason description why this personnel employment status is set to OUT_OF_SCOPE"
          },
          "osVersion": {
            "type": "string",
            "example": "Windows 3.1",
            "description": "The OS version this personnel uses"
          },
          "serialNumber": {
            "type": "string",
            "example": "1A2B3C4D",
            "description": "The serial number of the machine this personnel uses"
          },
          "user": {
            "description": "The user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "reasonProvider": {
            "description": "The user who provided the reason why this personnel was marked as OUT_OF_SCOPE",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "complianceChecks": {
            "example": "[]",
            "description": "Company products",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComplianceCheckResponsePublicDto"
            }
          },
          "complianceTests": {
            "example": "[]",
            "description": "Compliance Tests",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComplianceTestResponsePublicDto"
            }
          },
          "appsCount": {
            "type": "number",
            "example": 20,
            "description": "The number of applications this personnel runs on their machine"
          },
          "appsCountLastCheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "The last time the personnel apps count was audited"
          },
          "startDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date when this personnel was onboarded onto the company system"
          },
          "separationDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date when this personnel was separated from the company system"
          },
          "statusUpdatedAt": {
            "format": "date-time",
            "type": "string",
            "description": "The date when this personnel was manually updated"
          },
          "data": {
            "description": "The Personnel Data DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/PersonnelDataResponsePublicDto"
              }
            ]
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Personnel created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Personnel updated date timestamp"
          },
          "devices": {
            "example": "[]",
            "description": "A list of the devices registered to the personnel",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeviceResponsePublicDto"
            }
          },
          "backgroundCheckExcluded": {
            "type": "boolean",
            "example": false,
            "description": "Background Check was excluded"
          },
          "backgroundCheckExcludedReason": {
            "type": "string",
            "example": "Background check excluded",
            "description": "The reason of the background exclusion."
          },
          "agentEnabled": {
            "type": "boolean",
            "example": false,
            "description": "The agent status (ON/OFF)"
          },
          "manualUploadEnabled": {
            "type": "boolean",
            "example": false,
            "description": "Manual evidence upload status (ON/OFF)"
          },
          "devicesCount": {
            "type": "number",
            "description": "Number of devices associated to the personnel"
          },
          "devicesFailingComplianceCount": {
            "type": "number",
            "description": "Number of devices that are not in compliance associated to the personnel"
          }
        },
        "required": [
          "id",
          "employmentStatus",
          "notHumanReason",
          "osVersion",
          "serialNumber",
          "user",
          "reasonProvider",
          "complianceChecks",
          "complianceTests",
          "appsCount",
          "appsCountLastCheckedAt",
          "startDate",
          "separationDate",
          "statusUpdatedAt",
          "data",
          "createdAt",
          "updatedAt",
          "devices",
          "backgroundCheckExcluded",
          "backgroundCheckExcludedReason",
          "agentEnabled",
          "manualUploadEnabled"
        ]
      },
      "PersonnelTableResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PersonnelDetailsTableResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          },
          "dataAll": {
            "type": "object",
            "example": {},
            "description": "Object containing properties that apply to the whole no paginated set of data"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total",
          "dataAll"
        ]
      },
      "PersonnelDetailsResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Personnel Id"
          },
          "employmentStatus": {
            "type": "string",
            "example": "CURRENT_EMPLOYEE",
            "description": "The employment status of the personnel"
          },
          "notHumanReason": {
            "type": "string",
            "example": "This is not a real personnel, but a placeholder for anyone in charge of X",
            "description": "Reason description why this personnel employment status is set to OUT_OF_SCOPE"
          },
          "osVersion": {
            "type": "string",
            "example": "Windows 3.1",
            "description": "The OS version this personnel uses"
          },
          "serialNumber": {
            "type": "string",
            "example": "1A2B3C4D",
            "description": "The serial number of the machine this personnel uses"
          },
          "user": {
            "description": "The user response DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "reasonProvider": {
            "description": "The user who provided the reason why this personnel was marked as OUT_OF_SCOPE",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "complianceChecks": {
            "example": "[]",
            "description": "Company products",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComplianceCheckResponsePublicDto"
            }
          },
          "complianceTests": {
            "example": "[]",
            "description": "Compliance Tests",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComplianceTestResponsePublicDto"
            }
          },
          "appsCount": {
            "type": "number",
            "example": 20,
            "description": "The number of applications this personnel runs on their machine"
          },
          "appsCountLastCheckedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "The last time the personnel apps count was audited"
          },
          "startDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date when this personnel was onboarded onto the company system"
          },
          "separationDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date when this personnel was separated from the company system"
          },
          "statusUpdatedAt": {
            "format": "date-time",
            "type": "string",
            "description": "The date when this personnel was manually updated"
          },
          "data": {
            "description": "The Personnel Data DTO",
            "allOf": [
              {
                "$ref": "#/components/schemas/PersonnelDataResponsePublicDto"
              }
            ]
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Personnel created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Personnel updated date timestamp"
          },
          "devices": {
            "example": "[]",
            "description": "A list of the devices registered to the personnel",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeviceResponsePublicDto"
            }
          },
          "backgroundCheckExcluded": {
            "type": "boolean",
            "example": false,
            "description": "Background Check was excluded"
          },
          "backgroundCheckExcludedReason": {
            "type": "string",
            "example": "Background check excluded",
            "description": "The reason of the background exclusion."
          }
        },
        "required": [
          "id",
          "employmentStatus",
          "notHumanReason",
          "osVersion",
          "serialNumber",
          "user",
          "reasonProvider",
          "complianceChecks",
          "appsCount",
          "appsCountLastCheckedAt",
          "startDate",
          "separationDate",
          "statusUpdatedAt",
          "data",
          "createdAt",
          "updatedAt",
          "devices",
          "backgroundCheckExcluded",
          "backgroundCheckExcludedReason"
        ]
      },
      "PersonnelContractDateRequestPublicDto": {
        "type": "object",
        "properties": {
          "startDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date when this person started working on the company"
          },
          "separationDate": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date when this person was separated from the company system"
          }
        },
        "required": [
          "startDate",
          "separationDate"
        ]
      },
      "VendorDocumentResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor document ID"
          },
          "name": {
            "type": "string",
            "example": "AWS SOC 2 2018",
            "description": "The name the file"
          },
          "fileUrl": {
            "type": "string",
            "nullable": true,
            "example": "http://localhost:5000/download/vendors/1",
            "description": "The secure URL to the vendor document"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Vendor Document created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Vendor Document updated date timestamp"
          }
        },
        "required": [
          "id",
          "name",
          "fileUrl",
          "createdAt",
          "updatedAt"
        ]
      },
      "VendorReviewTrustServiceCategoryMapResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor review trust service category ID"
          },
          "category": {
            "type": "number",
            "nullable": true,
            "example": "AVAILABILITY",
            "description": "Vendor review trust service category"
          }
        },
        "required": [
          "id",
          "category"
        ]
      },
      "VendorReviewUserControlResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor review user control ID"
          },
          "name": {
            "type": "string",
            "example": "End User Control 1",
            "description": "Vendor review user control name"
          },
          "inPlace": {
            "type": "boolean",
            "example": true,
            "description": "Vendor review user control in place"
          }
        },
        "required": [
          "id",
          "name",
          "inPlace"
        ]
      },
      "VendorReviewServiceResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor review service ID"
          },
          "name": {
            "type": "string",
            "example": "Service 1",
            "description": "Vendor review service name"
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "VendorReviewLocationResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor review location ID"
          },
          "city": {
            "type": "string",
            "example": "San Diego",
            "description": "Vendor review location city"
          },
          "stateCountry": {
            "type": "string",
            "example": "CA",
            "description": "Vendor review location state"
          }
        },
        "required": [
          "id",
          "city",
          "stateCountry"
        ]
      },
      "VendorReviewFindingResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor review finding ID"
          },
          "description": {
            "type": "string",
            "example": "Finding 1",
            "description": "Vendor review finding description"
          }
        },
        "required": [
          "id",
          "description"
        ]
      },
      "VendorReviewResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor Review ID"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2023-03-31",
            "description": "Review last updated date"
          },
          "reviewer": {
            "type": "string",
            "example": "John Doe",
            "description": "Reviewer name"
          },
          "reviewDate": {
            "format": "date-time",
            "type": "string",
            "example": "2023-03-31",
            "description": "Review date"
          },
          "reportIssueDate": {
            "format": "date-time",
            "type": "string",
            "example": "2023-03-31",
            "description": "Report issue date"
          },
          "socReport": {
            "enum": [
              "SOC_1",
              "SOC_2",
              "SOC_3"
            ],
            "type": "string",
            "example": "SOC_1",
            "description": "SOC report type"
          },
          "socReportType1": {
            "type": "boolean",
            "example": true,
            "description": "Flag that indicates the SOC report type applies to type 1"
          },
          "socReportType2": {
            "type": "boolean",
            "example": true,
            "description": "Flag that indicates the SOC report type applies to type 2"
          },
          "socType1StartDate": {
            "format": "date-time",
            "type": "string",
            "example": "2023-03-31",
            "description": "Start date for SOC report type 1"
          },
          "socType1EndDate": {
            "format": "date-time",
            "type": "string",
            "example": "2023-03-31",
            "description": "End date for SOC report type 1"
          },
          "socType2StartDate": {
            "format": "date-time",
            "type": "string",
            "example": "2023-03-31",
            "description": "Start date for SOC report type 2"
          },
          "socType2EndDate": {
            "format": "date-time",
            "type": "string",
            "example": "2023-03-31",
            "description": "End date for SOC report type 2"
          },
          "reportOpinion": {
            "enum": [
              "UNQUALIFIED",
              "QUALIFIED",
              "ADVERSE",
              "DISCLAIMER"
            ],
            "type": "string",
            "example": "UNQUALIFIED",
            "description": "Vendor report opinion"
          },
          "encompassBusinessNeeds": {
            "type": "boolean",
            "example": true,
            "description": "Do control objectives or trust principles encompass business needs?"
          },
          "followUpActivity": {
            "type": "string",
            "example": "User must proceed to...",
            "description": "Follow up activity if report opinion is qualified"
          },
          "hasMaterialImpact": {
            "type": "boolean",
            "example": true,
            "description": "Do the findings have any material impact on your control environment?"
          },
          "cpaFirm": {
            "type": "string",
            "example": "CPA firm name",
            "description": "CPA firm that performed the audit"
          },
          "cpaProcedurePerformed": {
            "type": "string",
            "example": "The following procedures were performed...",
            "description": "Procedures Performed to Assess Reputation of CPA Firm"
          },
          "subserviceOrganization": {
            "type": "string",
            "example": "Subservice Inc.",
            "description": "Subservice Organizations In Report"
          },
          "subserviceOrganizationUsingInclusiveMethod": {
            "type": "boolean",
            "example": true,
            "description": "Are Subservice Organizations Presented in the Report Using the Inclusive Method?"
          },
          "subserviceOrganizationProcedurePerformed": {
            "type": "string",
            "example": "The following procedures were performed...",
            "description": "Procedures Performed to Assess Subservice Organizations"
          },
          "trustServiceCategories": {
            "nullable": true,
            "description": "Procedures Performed to Assess Subservice Organizations",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorReviewTrustServiceCategoryMapResponsePublicDto"
            }
          },
          "userControls": {
            "nullable": true,
            "description": "Procedures Performed to Assess Subservice Organizations",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorReviewUserControlResponsePublicDto"
            }
          },
          "services": {
            "nullable": true,
            "description": "Procedures Performed to Assess Subservice Organizations",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorReviewServiceResponsePublicDto"
            }
          },
          "locations": {
            "nullable": true,
            "description": "Procedures Performed to Assess Subservice Organizations",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorReviewLocationResponsePublicDto"
            }
          },
          "findings": {
            "nullable": true,
            "description": "Procedures Performed to Assess Subservice Organizations",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorReviewFindingResponsePublicDto"
            }
          }
        },
        "required": [
          "id",
          "updatedAt",
          "reviewer",
          "reviewDate",
          "socReport",
          "socReportType1",
          "socReportType2",
          "reportOpinion",
          "encompassBusinessNeeds",
          "hasMaterialImpact",
          "findings"
        ]
      },
      "VendorResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Vendor ID"
          },
          "name": {
            "type": "string",
            "example": "Acme",
            "description": "The name of a vendor"
          },
          "category": {
            "type": "string",
            "example": "ENGINEERING",
            "description": "The type of vendor"
          },
          "risk": {
            "type": "string",
            "example": "MODERATE",
            "description": "The vendor risk type"
          },
          "critical": {
            "type": "boolean",
            "example": false,
            "description": "Does the vendor is considered critical or not"
          },
          "location": {
            "type": "string",
            "example": "USA",
            "description": "Vendor location"
          },
          "url": {
            "type": "string",
            "example": "https://acme.com",
            "description": "Vendor URL"
          },
          "privacyUrl": {
            "type": "string",
            "example": "https://acme.com/privacy",
            "description": "Vendor Privacy Policy URL"
          },
          "termsUrl": {
            "type": "string",
            "example": "https://acme.com/terms",
            "description": "Vendor Terms of Use URL"
          },
          "servicesProvided": {
            "type": "string",
            "example": "Perform security scans once a month",
            "description": "Describe vendor services"
          },
          "dataStored": {
            "type": "string",
            "example": "resulting reports of security scans",
            "description": "What type of data the vendor stores"
          },
          "hasPii": {
            "type": "boolean",
            "example": true,
            "description": "Does this vendor store any type of PII"
          },
          "passwordPolicy": {
            "type": "string",
            "example": "USERNAME_PASSWORD",
            "description": "The vendor password policy"
          },
          "passwordRequiresMinLength": {
            "type": "boolean",
            "example": true,
            "description": "Is there a minimum length for user passwords"
          },
          "passwordMinLength": {
            "type": "number",
            "example": 8,
            "description": "Minimum character length for a password"
          },
          "passwordRequiresNumber": {
            "type": "boolean",
            "example": true,
            "description": "Does a password require numbers"
          },
          "passwordRequiresSymbol": {
            "type": "boolean",
            "example": true,
            "description": "Does a password require non-alpha-numeric characters"
          },
          "passwordMfaEnabled": {
            "type": "boolean",
            "example": true,
            "description": "Is mult-factor authentication enabled for this vendor"
          },
          "accountManagerName": {
            "type": "string",
            "example": "John Doe",
            "description": "The name of the corresponding account manager for this vendor"
          },
          "accountManagerEmail": {
            "type": "string",
            "example": "jdoe@company.com",
            "description": "The email of the corresponding account manager for this vendor"
          },
          "notes": {
            "type": "string",
            "example": "Meeting once a month to adjust contract",
            "description": "Additional notes for vendor"
          },
          "logoUrl": {
            "type": "string",
            "example": "https://cdn-prod.imgpilot.com/logo.png",
            "description": "Vendor logo URL"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Vendor created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Vendor updated date timestamp"
          },
          "user": {
            "description": "The user that is responsible for the compliance of this vendor",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserResponsePublicDto"
              }
            ]
          },
          "documents": {
            "description": "A list of vendor documents",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorDocumentResponsePublicDto"
            }
          },
          "lastQuestionnaire": {
            "type": "object",
            "description": "The last questionnaire associated with the vendor"
          },
          "isSubProcessor": {
            "type": "boolean",
            "example": false,
            "description": "Does this vendor is a Sub-processor"
          },
          "isSubProcessorActive": {
            "type": "boolean",
            "example": false,
            "description": "Is this vendor an active Sub-processor?"
          },
          "archivedAt": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "example": null,
            "description": "Timestap when the status of the vendor changed"
          },
          "renewalDate": {
            "type": "string",
            "nullable": true,
            "example": "2023-03-31",
            "description": "Vendor renewal date"
          },
          "renewalScheduleType": {
            "type": "string",
            "nullable": true,
            "example": "ONE_YEAR",
            "description": "Vendor renewal schedule type"
          },
          "renewalDateStatus": {
            "type": "string",
            "nullable": true,
            "example": "COMPLETED",
            "description": "Vendor renewal status based on how close it is to the renewal due date"
          },
          "confirmedAt": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "example": "Fri Mar 31 2023",
            "description": "Timestamp when the vendor details were confirmed"
          },
          "reviews": {
            "description": "Vendor Reviews",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorReviewResponsePublicDto"
            }
          },
          "isComplianceReviewRequired": {
            "type": "boolean",
            "example": false,
            "description": "Does the vendor required compliance report review"
          }
        },
        "required": [
          "id",
          "name",
          "category",
          "risk",
          "critical",
          "location",
          "url",
          "privacyUrl",
          "termsUrl",
          "servicesProvided",
          "dataStored",
          "hasPii",
          "passwordPolicy",
          "passwordRequiresMinLength",
          "passwordMinLength",
          "passwordRequiresNumber",
          "passwordRequiresSymbol",
          "passwordMfaEnabled",
          "accountManagerName",
          "accountManagerEmail",
          "notes",
          "logoUrl",
          "createdAt",
          "updatedAt",
          "user",
          "documents",
          "lastQuestionnaire",
          "isSubProcessor",
          "isSubProcessorActive",
          "archivedAt",
          "reviews",
          "isComplianceReviewRequired"
        ]
      },
      "VendorsResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "VendorRequestPublicDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 191,
            "example": "Acme",
            "description": "The name of a vendor"
          },
          "category": {
            "enum": [
              "ENGINEERING",
              "PRODUCT",
              "MARKETING",
              "CS",
              "SALES",
              "FINANCE",
              "HR",
              "ADMINISTRATIVE",
              "SECURITY"
            ],
            "type": "string",
            "example": "ENGINEERING",
            "description": "The type of vendor"
          },
          "risk": {
            "enum": [
              "NONE",
              "LOW",
              "MODERATE",
              "HIGH"
            ],
            "type": "string",
            "example": "MODERATE",
            "description": "The level of risk for customer data"
          },
          "critical": {
            "type": "boolean",
            "example": false,
            "description": "Does this vendor is considered as critical"
          },
          "isSubProcessor": {
            "type": "boolean",
            "example": false,
            "description": "Does this vendor is considered as sub-processor"
          },
          "isSubProcessorActive": {
            "type": "boolean",
            "example": false,
            "description": "Does this subprocessor is active"
          },
          "userId": {
            "type": "number",
            "maximum": 1000000000,
            "example": 1,
            "description": "The user ID of the person responsible for the compliance of this vendor"
          },
          "url": {
            "type": "string",
            "maxLength": 191,
            "example": "https://acme.com",
            "description": "Vendor URL"
          },
          "privacyUrl": {
            "type": "string",
            "maxLength": 191,
            "example": "https://acme.com/privacy",
            "description": "Vendor Privacy Policy URL"
          },
          "termsUrl": {
            "type": "string",
            "maxLength": 191,
            "example": "https://acme.com/terms",
            "description": "Vendor Terms of Use URL"
          },
          "servicesProvided": {
            "type": "string",
            "maxLength": 30000,
            "example": "Perform security scans once a month",
            "description": "Describe vendor services"
          },
          "dataStored": {
            "type": "string",
            "maxLength": 30000,
            "example": "resulting reports of security scans",
            "description": "What type of data the vendor stores"
          },
          "location": {
            "type": "string",
            "maxLength": 30000,
            "example": "San Diego",
            "description": "Location of the vendor services"
          },
          "hasPii": {
            "type": "boolean",
            "example": true,
            "description": "Does this vendor store any type of PII"
          },
          "passwordPolicy": {
            "enum": [
              "USERNAME_PASSWORD",
              "SSO",
              "LDAP"
            ],
            "type": "string",
            "example": "USERNAME_PASSWORD",
            "description": "The vendor password policy"
          },
          "passwordRequiresMinLength": {
            "type": "boolean",
            "example": true,
            "description": "Is there a minimum length for user passwords"
          },
          "passwordMinLength": {
            "type": "number",
            "minimum": 6,
            "maximum": 12,
            "example": 8,
            "description": "Minimum character length for a password"
          },
          "passwordRequiresNumber": {
            "type": "boolean",
            "example": true,
            "description": "Does a password require numbers"
          },
          "passwordRequiresSymbol": {
            "type": "boolean",
            "example": true,
            "description": "Does a password require non-alpha-numeric characters"
          },
          "passwordMfaEnabled": {
            "type": "boolean",
            "example": true,
            "description": "Is mult-factor authentication enabled for this vendor"
          },
          "accountManagerName": {
            "type": "string",
            "maxLength": 191,
            "example": "John Doe",
            "description": "The name of the corresponding account manager for this vendor"
          },
          "accountManagerEmail": {
            "type": "string",
            "maxLength": 191,
            "example": "jdoe@company.com",
            "description": "The email of the corresponding account manager for this vendor"
          },
          "notes": {
            "type": "string",
            "maxLength": 30000,
            "example": "Meeting once a month to adjust contract",
            "description": "Additional notes for vendor"
          },
          "renewalDate": {
            "type": "string",
            "nullable": true,
            "example": "2023-03-31",
            "description": "Vendor renewal date"
          },
          "renewalScheduleType": {
            "nullable": true,
            "enum": [
              "ONE_MONTH",
              "TWO_MONTHS",
              "THREE_MONTHS",
              "SIX_MONTHS",
              "ONE_YEAR",
              "CUSTOM"
            ],
            "type": "string",
            "example": "ONE_YEAR",
            "description": "Vendor renewal schedule type"
          },
          "confirmed": {
            "type": "boolean",
            "nullable": true,
            "example": true,
            "description": "Is all vendor data confirmed?"
          },
          "isComplianceReviewRequired": {
            "type": "boolean",
            "example": true,
            "description": "Is vendor compliance report review required?"
          }
        },
        "required": [
          "name",
          "category",
          "risk",
          "critical",
          "isSubProcessor",
          "isSubProcessorActive",
          "userId",
          "url",
          "servicesProvided",
          "dataStored",
          "hasPii",
          "passwordPolicy",
          "passwordRequiresMinLength",
          "passwordRequiresNumber",
          "passwordRequiresSymbol",
          "passwordMfaEnabled",
          "isComplianceReviewRequired"
        ]
      },
      "VendorDocumentRequestPublicDto": {
        "type": "object",
        "properties": {
          "type": {
            "nullable": true,
            "enum": [
              "COMPLIANCE_REPORT",
              "COMPLIANCE_REPORT_REVIEW",
              "BRIDGE_LETTER",
              "UPLOADED_COMPLIANCE_REPORT_REVIEW"
            ],
            "type": "string",
            "example": "COMPLIANCE_REPORT",
            "description": "Vendor document type"
          },
          "file": {
            "type": "string",
            "format": "binary"
          }
        },
        "required": [
          "file"
        ]
      },
      "QuestionnaireSentResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Questionnaire ID"
          },
          "completedBy": {
            "type": "string",
            "nullable": true,
            "example": "Acme",
            "description": "Who answer the questionnaire"
          },
          "recipientEmail": {
            "type": "string",
            "maxLength": 191,
            "example": "wc@drata.com",
            "description": "The email address to receive the questionnaire"
          },
          "isCompleted": {
            "type": "boolean",
            "example": "true",
            "description": "The status of the questionnaire"
          },
          "dateSent": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Date when the questionnaire was sent"
          },
          "isManualUpload": {
            "type": "boolean",
            "example": "true",
            "description": "Flag to know if the file is a manual uploaded questionnaire"
          },
          "responseId": {
            "type": "number",
            "nullable": true,
            "example": 1,
            "description": "The questionnaire response id to the questionnaire data file"
          }
        },
        "required": [
          "id",
          "completedBy",
          "recipientEmail",
          "isCompleted",
          "dateSent",
          "isManualUpload",
          "responseId"
        ]
      },
      "QuestionnairesSentResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuestionnaireSentResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "QuestionnaireSentRequestPublicDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "maxLength": 191,
            "example": "wc@drata.com",
            "description": "The email address to receive the questionnaire"
          },
          "questionnaireId": {
            "type": "number",
            "example": 1,
            "description": "Vendor questionnaire ID"
          }
        },
        "required": [
          "email",
          "questionnaireId"
        ]
      },
      "TicketsCreateFieldRequestPublicDto": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "maxLength": 191,
            "example": "summary",
            "description": "Field name"
          },
          "type": {
            "type": "string",
            "maxLength": 191,
            "example": "string",
            "description": "Type of the incoming data, used for validation"
          },
          "value": {
            "type": "string",
            "maxLength": 191,
            "example": "My Ticket",
            "description": "Value for the incoming issue field"
          }
        },
        "required": [
          "field",
          "type",
          "value"
        ]
      },
      "TicketsCreateRequestPublicDto": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "number",
            "example": 10000,
            "description": "Project id"
          },
          "issueTypeId": {
            "type": "number",
            "example": 10001,
            "description": "IssueType Id"
          },
          "fields": {
            "description": "The value keys used to fill out the expected Jira Schema",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TicketsCreateFieldRequestPublicDto"
            }
          },
          "monitorInstanceId": {
            "type": "number",
            "example": 1,
            "description": "Monitor Instance id this task is associated to"
          },
          "controlId": {
            "type": "number",
            "example": 1,
            "description": "Control Id this task is associated to"
          }
        },
        "required": [
          "projectId",
          "issueTypeId",
          "fields",
          "monitorInstanceId",
          "controlId"
        ]
      },
      "TicketCreateResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": "42210",
            "description": "Issue Id"
          },
          "key": {
            "type": "string",
            "example": "SF-332",
            "description": "Issue key"
          },
          "self": {
            "type": "string",
            "example": "https://api.atlassian.com/ex/jira/97b4114f-0065-4a2b-a9e0-8a37cae80ddd/rest/api/3/issue/42210",
            "description": "Issue self"
          },
          "transition": {
            "type": "object",
            "nullable": true,
            "example": null,
            "description": "Issue transition"
          }
        },
        "required": [
          "id",
          "key",
          "self",
          "transition"
        ]
      },
      "MonitoringControlsResponsePublicDto": {
        "type": "object",
        "properties": {
          "isSLADisplayed": {
            "type": "boolean",
            "description": "SLA is or not displayed"
          },
          "slaTime": {
            "type": "number",
            "description": "Time of compliance"
          },
          "controls": {
            "type": "object",
            "description": "Controls of the tenant"
          }
        },
        "required": [
          "isSLADisplayed",
          "slaTime",
          "controls"
        ]
      },
      "TrustCenterRequestStatusPublicDto": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status",
            "enum": [
              "PROCESS_ERROR",
              "APPROVED",
              "DENIED",
              "NDA_SENT",
              "NDA_SIGNED",
              "FILES_SENT",
              "EXPIRED",
              "PENDING"
            ],
            "example": "APPROVED"
          },
          "source": {
            "type": "string",
            "description": "Status creation source",
            "enum": [
              "SELF",
              "DOCUSIGN"
            ],
            "example": "SELF"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "description": "Date of status creation",
            "example": "2020-07-06 12:00:00.000000"
          },
          "user": {
            "type": "string",
            "description": "Status creation user name",
            "example": "John Doe"
          }
        },
        "required": [
          "status",
          "source",
          "createdAt"
        ]
      },
      "TrustCenterRequestDocumentWithNameResponsePublicDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Requester Email",
            "example": "example@drata.com"
          },
          "firstName": {
            "type": "string",
            "description": "Requester first name",
            "example": "Alondra"
          },
          "lastName": {
            "type": "string",
            "description": "Requester last name",
            "example": "Ramos"
          },
          "company": {
            "type": "string",
            "description": "Requester company",
            "example": "Acme"
          },
          "requestId": {
            "type": "string",
            "description": "Request ID",
            "example": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd"
          },
          "approvedAt": {
            "format": "date-time",
            "type": "string",
            "description": "Date of approval",
            "example": "2020-07-06 12:00:00.000000"
          },
          "deniedAt": {
            "format": "date-time",
            "type": "string",
            "description": "Date of denial",
            "example": "2020-07-06 12:00:00.000000"
          },
          "managedBy": {
            "type": "string",
            "description": "Admin account",
            "example": "Brayan Perez"
          },
          "documents": {
            "description": "Request documents",
            "example": "[{\n            id: 5, \n            name: Report 5,\n            approvedAt: 2020-07-06 12:00:00.000000, \n            deniedAt: 2020-07-06 12:00:00.000000\n        }]",
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "statuses": {
            "description": "Request statuses",
            "example": "[{\n            status: 'APPROVED',\n            source: 'SELF',\n            createdAt: 2020-07-06 12:00:00.000000,\n            user: 'John Doe',\n        }]",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrustCenterRequestStatusPublicDto"
            }
          },
          "ndaUrl": {
            "type": "string",
            "description": "DocuSign NDA URL",
            "example": "https://acme.com"
          },
          "flowType": {
            "type": "string",
            "example": "SELF",
            "description": "Private flow type"
          },
          "autoApproveType": {
            "type": "string",
            "nullable": true,
            "example": "SELF",
            "description": "Auto approved type"
          }
        },
        "required": [
          "email",
          "firstName",
          "lastName",
          "company",
          "requestId",
          "approvedAt",
          "deniedAt",
          "managedBy",
          "documents",
          "statuses",
          "flowType",
          "autoApproveType"
        ]
      },
      "TrustCenterRequestApproveResponsePublicDto": {
        "type": "object",
        "properties": {
          "isApproved": {
            "type": "boolean",
            "description": "Access request approved",
            "example": true
          },
          "trackingId": {
            "type": "string",
            "description": "Digital Signature Request tracking ID",
            "example": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd"
          }
        },
        "required": [
          "isApproved"
        ]
      },
      "TrustCenterRequestDeniedResponsePublicDto": {
        "type": "object",
        "properties": {
          "isDenied": {
            "type": "boolean",
            "description": "Access request denied"
          }
        },
        "required": [
          "isDenied"
        ]
      },
      "TrustCenterPreapprovedEmailDomainResponsePublicDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "drata.com",
            "description": "Preapproved email domain name"
          }
        },
        "required": [
          "name"
        ]
      },
      "TrustCenterPrivateAccessResponsePublicDto": {
        "type": "object",
        "properties": {
          "flowType": {
            "type": "string",
            "example": "SELF",
            "description": "Private flow type"
          },
          "preapprovedEmailDomains": {
            "example": [
              {
                "id": 1,
                "name": "drata.com",
                "createdAt": "2020-07-06",
                "deletedAt": null
              }
            ],
            "description": "List of preapproved email domains",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrustCenterPreapprovedEmailDomainResponsePublicDto"
            }
          }
        },
        "required": [
          "flowType",
          "preapprovedEmailDomains"
        ]
      },
      "CompanyInfoPrivateAccessRequestPublicDto": {
        "type": "object",
        "properties": {
          "securityEmail": {
            "type": "string",
            "maxLength": 191,
            "example": "security@drata.com",
            "description": "Company's security/compliance email"
          },
          "removeNda": {
            "type": "boolean",
            "example": true,
            "description": "Remove the current NDA?"
          },
          "preapprovedEmailDomains": {
            "example": "domain.com",
            "description": "List of preapproved email domains",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "CompanyInfoResponsePublicDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "Drata",
            "description": "Company's common name"
          },
          "securityEmail": {
            "type": "string",
            "example": "security@drata.com",
            "description": "Company's security/compliance email"
          },
          "about": {
            "type": "string",
            "example": "We are a startup ...",
            "description": "About the company"
          },
          "privacyUrl": {
            "type": "string",
            "example": "https://drata.com/privacy",
            "description": "Company's privacy url"
          },
          "privacyDescription": {
            "type": "string",
            "example": "Drata Inc is a company ...",
            "description": "Company's privacy description"
          },
          "headerTemplate": {
            "type": "string",
            "example": "<header>Drata</header>",
            "description": "Header template in HTML format"
          },
          "favicon": {
            "type": "object",
            "example": {
              "name": "Favicon",
              "file": "https://drata.com/favicon.ico"
            },
            "description": "Favicon URL for Trust Page"
          },
          "nda": {
            "type": "object",
            "example": {
              "name": "NDA",
              "file": "https://drata.com/nda.pdf"
            },
            "description": "NDA for Trust Page"
          },
          "contactUrl": {
            "type": "string",
            "example": "https://acme.drata.net/contactus",
            "description": "Company's contact url"
          },
          "aboutUpdatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "About updated at timestamp"
          },
          "privacyUpdatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Privacy updated at timestamp"
          }
        },
        "required": [
          "name",
          "securityEmail",
          "about",
          "privacyDescription",
          "headerTemplate",
          "favicon",
          "nda",
          "aboutUpdatedAt",
          "privacyUpdatedAt"
        ]
      },
      "TrustCenterAllPrivateDocumentsResponsePublicDto": {
        "type": "object",
        "properties": {
          "privateDocuments": {
            "description": "Policies, Compliance and Security Reports private documents",
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        },
        "required": [
          "privateDocuments"
        ]
      },
      "TrustCenterRequestDocumentTypePublicDto": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "number",
            "description": "The private document id",
            "example": 1
          },
          "type": {
            "enum": [
              "COMPLIANCE",
              "POLICY",
              "SECURITY_REPORT"
            ],
            "type": "string",
            "description": "The private document type",
            "example": "SECURITY_REPORT"
          }
        },
        "required": [
          "documentId",
          "type"
        ]
      },
      "TrustCenterRequestRequestPublicDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "example": "example@email.com",
            "description": "Email of requester"
          },
          "name": {
            "type": "string",
            "example": "FirstName",
            "description": "First name of requester"
          },
          "lastname": {
            "type": "string",
            "example": "LastName",
            "description": "Last name of requester"
          },
          "company": {
            "type": "string",
            "example": "Company",
            "description": "Company of requester"
          },
          "acceptTerms": {
            "type": "boolean",
            "example": true,
            "description": "Accept the NDA terms and conditions"
          },
          "documents": {
            "example": [
              {
                "documentId": 1,
                "type": "POLICY"
              },
              {
                "documentId": 2,
                "type": "SECURITY_REPORT"
              }
            ],
            "description": "Private documents to request access",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrustCenterRequestDocumentTypePublicDto"
            }
          },
          "flowType": {
            "enum": [
              "SELF",
              "DIGITAL_SIGNATURE"
            ],
            "type": "string",
            "example": "SELF",
            "description": "Type of private flow"
          }
        },
        "required": [
          "email",
          "name",
          "lastname",
          "company",
          "acceptTerms",
          "documents",
          "flowType"
        ]
      },
      "ManualBackgroundCheckRequestPublicDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 768,
            "example": "https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
            "description": "The URL of the background check"
          },
          "filedAt": {
            "type": "string",
            "example": "2020-07-06",
            "description": "The date when this background check data was uploaded to Drata"
          }
        },
        "required": [
          "url",
          "filedAt"
        ]
      },
      "DeviceDocumentRequestPublicDto": {
        "type": "object",
        "properties": {
          "type": {
            "enum": [
              "PASSWORD_MANAGER_EVIDENCE",
              "AUTO_UPDATES_EVIDENCE",
              "HARD_DRIVE_ENCRYPTION_EVIDENCE",
              "ANTIVIRUS_EVIDENCE",
              "LOCK_SCREEN_EVIDENCE"
            ],
            "type": "string",
            "example": "PASSWORD_MANAGER_EVIDENCE",
            "description": "The device document type"
          },
          "file": {
            "type": "string",
            "format": "binary"
          },
          "base64File": {
            "type": "object",
            "example": {
              "base64String": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg",
              "filename": "excellent-filename"
            },
            "description": "External evidence in Base64 format"
          }
        },
        "required": [
          "type",
          "file"
        ]
      },
      "DeviceDocumentsResponsePublicDto": {
        "type": "object",
        "properties": {
          "documents": {
            "description": "Full list of device documents",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeviceDocumentResponsePublicDto"
            }
          }
        },
        "required": [
          "documents"
        ]
      },
      "RiskControlResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 23,
            "description": "Control Id"
          },
          "code": {
            "type": "string",
            "example": "DCF-01",
            "description": "Control code"
          },
          "name": {
            "type": "string",
            "example": "Hello",
            "description": "Control name"
          },
          "description": {
            "type": "string",
            "example": "this is a description",
            "description": "Control description"
          },
          "isReady": {
            "type": "boolean",
            "example": true,
            "description": "Control ready or not"
          },
          "controlNumber": {
            "type": "number",
            "example": 1,
            "description": "Control number"
          },
          "archivedAt": {
            "format": "date-time",
            "type": "string",
            "example": 1,
            "description": "Control out of scope"
          }
        },
        "required": [
          "id",
          "code",
          "name",
          "description",
          "isReady",
          "controlNumber",
          "archivedAt"
        ]
      },
      "RiskCategoryResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Risk Category ID"
          },
          "name": {
            "type": "string",
            "example": "Governance",
            "description": "Risk Category Name"
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "RiskUserResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "User ID"
          },
          "email": {
            "type": "string",
            "example": "email@email.com",
            "description": "User email"
          },
          "firstName": {
            "type": "string",
            "example": "Sally",
            "description": "User first name"
          },
          "lastName": {
            "type": "string",
            "example": "Smith",
            "description": "User last name"
          },
          "jobTitle": {
            "type": "string",
            "example": "CEO",
            "description": "User job title"
          },
          "avatarUrl": {
            "type": "string",
            "example": "https://cdn-prod.imgpilot.com/avatar.png",
            "description": "User avatar URL"
          }
        },
        "required": [
          "id",
          "email",
          "firstName",
          "lastName",
          "jobTitle",
          "avatarUrl"
        ]
      },
      "DocumentResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Document ID"
          },
          "name": {
            "type": "string",
            "example": "Security Training",
            "description": "The name the file"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "User Document created date timestamp"
          }
        },
        "required": [
          "id",
          "name",
          "createdAt"
        ]
      },
      "NoteResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Note ID"
          },
          "comment": {
            "type": "string",
            "example": "Good comment",
            "description": "The comment of the note"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Note created date timestamp"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Note updated date timestamp"
          },
          "owner": {
            "description": "The user that created the note",
            "allOf": [
              {
                "$ref": "#/components/schemas/UserCardResponsePublicDto"
              }
            ]
          }
        },
        "required": [
          "id",
          "comment",
          "createdAt",
          "updatedAt",
          "owner"
        ]
      },
      "RiskResponsePublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "Risk Id"
          },
          "riskId": {
            "type": "string",
            "example": "AC-04",
            "description": "Human readable risk id"
          },
          "title": {
            "type": "string",
            "example": "Password Management - Password Cracking",
            "description": "Title of the risk"
          },
          "description": {
            "type": "string",
            "example": "An attacker attempts to gain access to organizational information by guessing of passwords.",
            "description": "Description of the risk"
          },
          "treatmentPlan": {
            "type": "string",
            "example": "NEEDS_TREATMENT",
            "description": "The risk treatment plan"
          },
          "treatmentDetails": {
            "type": "string",
            "example": "Building doors can be open and an unauthorized person can walk in.",
            "description": "The risk treatment details"
          },
          "anticipatedCompletionDate": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Anticipated Completion Date."
          },
          "completionDate": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Completion Date."
          },
          "impact": {
            "type": "number",
            "example": 5,
            "description": "The risk impact"
          },
          "likelihood": {
            "type": "number",
            "example": 5,
            "description": "The risk likelihood"
          },
          "score": {
            "type": "number",
            "example": 5,
            "description": "The risk score"
          },
          "residualImpact": {
            "type": "number",
            "example": 5,
            "description": "The risk residual impact"
          },
          "residualLikelihood": {
            "type": "number",
            "example": 5,
            "description": "The risk residual likelihood"
          },
          "residualScore": {
            "type": "number",
            "example": 5,
            "description": "The risk residual score"
          },
          "applicable": {
            "type": "boolean",
            "example": true,
            "description": "Risk applicable or not"
          },
          "controls": {
            "description": "Controls attached to the risk",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskControlResponsePublicDto"
            }
          },
          "categories": {
            "description": "Categories attached to the risk",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskCategoryResponsePublicDto"
            }
          },
          "owners": {
            "description": "List of owners for the risk",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskUserResponsePublicDto"
            }
          },
          "reviewers": {
            "description": "List of reviewers for the risk",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskUserResponsePublicDto"
            }
          },
          "documents": {
            "description": "List of documents",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DocumentResponsePublicDto"
            }
          },
          "notes": {
            "description": "List of notes",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NoteResponsePublicDto"
            }
          }
        },
        "required": [
          "id",
          "riskId",
          "title",
          "description",
          "treatmentPlan",
          "treatmentDetails",
          "anticipatedCompletionDate",
          "completionDate",
          "impact",
          "likelihood",
          "score",
          "residualImpact",
          "residualLikelihood",
          "residualScore",
          "applicable",
          "controls",
          "categories",
          "owners",
          "reviewers",
          "documents",
          "notes"
        ]
      },
      "RisksPaginatedResponsePublicDto": {
        "type": "object",
        "properties": {
          "data": {
            "example": [],
            "description": "Data set based on the pagination limits",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskResponsePublicDto"
            }
          },
          "page": {
            "type": "number",
            "example": 1,
            "description": "Which page of data are you requesting"
          },
          "limit": {
            "type": "number",
            "example": 10,
            "description": "How many items are your requesting"
          },
          "total": {
            "type": "number",
            "example": 100,
            "description": "How many items are in the overall set"
          }
        },
        "required": [
          "data",
          "page",
          "limit",
          "total"
        ]
      },
      "CategoryRequestPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "ID"
          }
        },
        "required": [
          "id"
        ]
      },
      "DocumentRequestPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "ID"
          }
        },
        "required": [
          "id"
        ]
      },
      "ReviewerRequestPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "ID"
          }
        },
        "required": [
          "id"
        ]
      },
      "OwnerRequestPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "ID"
          }
        },
        "required": [
          "id"
        ]
      },
      "ControlRequestPublicDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 1,
            "description": "ID"
          }
        },
        "required": [
          "id"
        ]
      },
      "RiskRequestPublicDto": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 191,
            "example": "Door locks",
            "description": "Describes the title of a risk"
          },
          "description": {
            "type": "string",
            "maxLength": 768,
            "example": "Building doors can be open and an unauthorized person can walk in.",
            "description": "Describes the problem"
          },
          "impact": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 3,
            "description": "Describes the impact"
          },
          "likelihood": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 1,
            "description": "Describes the likelihood"
          },
          "score": {
            "type": "number",
            "minimum": 1,
            "maximum": 25,
            "example": 3,
            "description": "Assessment score"
          },
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CategoryRequestPublicDto"
            }
          },
          "documents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DocumentRequestPublicDto"
            }
          },
          "treatmentPlan": {
            "enum": [
              "NEEDS_TREATMENT",
              "ACCEPT",
              "TRANSFER",
              "AVOID",
              "MITIGATE"
            ],
            "type": "string",
            "example": "TRANSFER",
            "description": "The risk treatment plan"
          },
          "treatmentDetails": {
            "type": "string",
            "maxLength": 30000,
            "example": "Building doors can be open and an unauthorized person can walk in.",
            "description": "Describes the treatment"
          },
          "anticipatedCompletionDate": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Anticipated Completion Date."
          },
          "completionDate": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Completion Date."
          },
          "reviewers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReviewerRequestPublicDto"
            }
          },
          "owners": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OwnerRequestPublicDto"
            }
          },
          "residualImpact": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 3,
            "description": "Describes the score for impact"
          },
          "residualLikelihood": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 1,
            "description": "Describes the score for likelihood"
          },
          "residualScore": {
            "type": "number",
            "minimum": 1,
            "maximum": 25,
            "example": 3,
            "description": "Assessment residual score"
          },
          "controls": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlRequestPublicDto"
            }
          },
          "applicable": {
            "type": "boolean",
            "description": "Mark if risk is applicable or not"
          }
        },
        "required": [
          "title",
          "description",
          "treatmentPlan"
        ]
      },
      "RiskRequestOptionalPublicDto": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 191,
            "example": "Door locks",
            "description": "Describes the title of a risk"
          },
          "description": {
            "type": "string",
            "maxLength": 768,
            "example": "Building doors can be open and an unauthorized person can walk in.",
            "description": "Describes the problem"
          },
          "impact": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 3,
            "description": "Describes the impact"
          },
          "likelihood": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 1,
            "description": "Describes the likelihood"
          },
          "score": {
            "type": "number",
            "minimum": 1,
            "maximum": 25,
            "example": 3,
            "description": "Assessment score"
          },
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CategoryRequestPublicDto"
            }
          },
          "documents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DocumentRequestPublicDto"
            }
          },
          "treatmentPlan": {
            "enum": [
              "NEEDS_TREATMENT",
              "ACCEPT",
              "TRANSFER",
              "AVOID",
              "MITIGATE"
            ],
            "type": "string",
            "example": "TRANSFER",
            "description": "The risk treatment plan"
          },
          "treatmentDetails": {
            "type": "string",
            "maxLength": 30000,
            "example": "Building doors can be open and an unauthorized person can walk in.",
            "description": "Describes the treatment"
          },
          "anticipatedCompletionDate": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Anticipated Completion Date."
          },
          "completionDate": {
            "format": "date-time",
            "type": "string",
            "example": "2020-07-06 12:00:00.000000",
            "description": "Completion Date."
          },
          "reviewers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReviewerRequestPublicDto"
            }
          },
          "owners": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OwnerRequestPublicDto"
            }
          },
          "residualImpact": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 3,
            "description": "Describes the score for impact"
          },
          "residualLikelihood": {
            "type": "number",
            "minimum": 1,
            "maximum": 5,
            "example": 1,
            "description": "Describes the score for likelihood"
          },
          "residualScore": {
            "type": "number",
            "minimum": 1,
            "maximum": 25,
            "example": 3,
            "description": "Assessment residual score"
          },
          "controls": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlRequestPublicDto"
            }
          },
          "applicable": {
            "type": "boolean",
            "description": "Mark if risk is applicable or not"
          }
        },
        "required": [
          "title",
          "description",
          "treatmentPlan"
        ]
      }
    }
  }
}