{"componentChunkName":"component---src-templates-redoc-operation-js","path":"/openapi/reference/v2/tag/HRIS-User-Identities/","result":{"data":{"contentItem":{"type":"redoc-operation","link":"/openapi/reference/v2/tag/HRIS-User-Identities/","data":{"redocStoreStr":"{\"menu\":{\"activeItemIdx\":-1},\"definition\":{\"data\":{\"openapi\":\"3.0.0\",\"info\":{\"title\":\"Drata API – Beta 🧪\",\"description\":\"### Beta Status\\nWe've made API version 2 available for beta testing. We would appreciate [your feedback](https://docs.google.com/forms/d/e/1FAIpQLScDt_FYcc5jDKzjGDxOdopsjgq4AipEVQ18E0c0Ki7em-ubCw/viewform?usp=header).\\n[Drata API version 1 is still available](https://developers.drata.com/openapi/reference/v1/overview/).\\n\\n### What's New in V2\\n- Support for Custom Fields\\n- Get and acknowledge user's assigned policies\\n- Payloads are streamlined to include only the essential information. You can expand related objects and collections using the `expand` query parameter.\\n- Cursor-based pagination for greater efficiency and stability with large datasets\\n\\n### Getting Started\\nPlease visit our help article to learn how to [create an API key](https://help.drata.com/en/articles/6695964).\\n\\n### Upgrading From Version 1\\nAPI V2 is designed to provide a faster an more flexible way of accessing Drata. There are several differences from V1:\\n- The listing endpoints now use **cursor-based pagination**. This provides faster responses and ensures that all records can be retrieved even, if they are changed during the process.\\n\\n```javascript\\nasync function fetchAll() {\\n  // The first request doesn't send a value for the cursor.\\n  let cursor = undefined;\\n  do {\\n    const query = new URLSearchParams({ cursor });\\n    const resp = await fetch(\\n      `https://public-api.drata.com/public/v2/users?${query}`,\\n      {\\n        method: 'GET',\\n        headers: { Authorization: 'Bearer <YOUR_API_KEY_HERE>' }\\n      }\\n    );\\n    const data = await resp.json();\\n    console.log(data);\\n\\n    // If there's a cursor value returned, then there are more results.\\n    // Pass that back as a query parameter to get the next page of data.\\n    cursor = data?.pagination?.cursor;\\n  } while (cursor)\\n}\\nfetchAll();\\n```\\n- You'll notice smaller responses. Most endpoints accept an `expand` query parameter that let's you specify which related objects and collections you want to expand.\\n\",\"version\":\"V2\",\"contact\":{}},\"servers\":[{\"url\":\"https://public-api.drata.com/public/v2\"},{\"url\":\"https://public-api.eu.drata.com/public/v2\"},{\"url\":\"https://public-api.apac.drata.com/public/v2\"}],\"tags\":[{\"name\":\"Company\",\"description\":\"The Company tracks essential information about your organization. The [help docs](https://help.drata.com/en/articles/8283910) have more information on the purpose of each field.\"},{\"name\":\"Assets\",\"description\":\"Assets let you build an inventory of policies, personnel and computer infrastructure. The [help docs](https://help.drata.com/en/collections/10485424) have more information.\"},{\"name\":\"Background Checks\",\"description\":\"Background checks verify a person’s identity, history, and qualifications to ensure they meet legal, regulatory, or policy standards. The [help docs](https://help.drata.com/en/articles/5833999-background-check-management) have more information.\"},{\"name\":\"Controls\",\"description\":\"Controls are a strategic measure or safeguard that an organization puts in place to protect its assets and meet the requirements of specific compliance frameworks.\"},{\"name\":\"Control Notes\",\"description\":\"Control Notes allow you to provide additional information about Controls.\"},{\"name\":\"Control Owners\",\"description\":\"Control Owners are the Users responsible for Controls. They ensure the right evidence is associated, that any automated tests are passing, and help prepare for an audit.\"},{\"name\":\"Custom Connections\",\"description\":\"Custom Connections allow users to integrate external systems with Drata. This includes Custom Data connections for pushing JSON evidence and Custom Device connections for device management and monitoring\"},{\"name\":\"HRIS User Identities\",\"description\":\"HR user identity records for a Custom HRIS connection. Use the batch upsert endpoint to submit employee records keyed by your own `identityId`, then use the update endpoint to reflect employment changes (e.g. set `separatedAt` when an employee leaves). Deleting a record is intended for data submitted in error, not for offboarding. Changes are not applied immediately — they are incorporated the next time identity sync runs, which happens nightly by default. A sync can also be triggered manually from the Personnel page.\"},{\"name\":\"Device Documents\",\"description\":\"Device Documents allow you to provide manual evidence of Devices compliance. Using the Drata Agent or an MDM connection automatically provides this information.\"},{\"name\":\"Devices\",\"description\":\"Devices are computers used by personnel. The data is provided by the Drata Agent or an MDM connection.\"},{\"name\":\"Events\",\"description\":\"Events record the activity of User and automated processes in the Drata platform.\"},{\"name\":\"Evidence Library\",\"description\":\"Drata's Evidence Library serves as a repository for all the evidence you need to collect across your controls. The [help docs](https://help.drata.com/en/articles/8288579-evidence-library-overview) have more information.\"},{\"name\":\"Frameworks\",\"description\":\"Frameworks are collections of controls that are used to assess compliance with specific standards or regulations. The [help docs](https://help.drata.com/en/articles/5329593-frameworks) have more information.\"},{\"name\":\"Monitoring Tests\",\"description\":\"Monitoring Tests are compliance tests used to determine whether a person, system, process, or organization is adhering to standards set by compliance controls within a framework. The [help docs](https://help.drata.com/en/articles/4790546-monitoring) have more information.\"},{\"name\":\"Personnel\",\"description\":\"Personnel are people who work for your organization. The [help docs](https://help.drata.com/en/collections/2653981) have more information.\"},{\"name\":\"Policies\",\"description\":\"A policy is a document that outlines an organization’s commitment to following standards relevant to its operations. The [help docs](https://help.drata.com/en/articles/9202419-policy-center-overview) have more information.\"},{\"name\":\"Risks\",\"description\":\"Risks are potential events that could impact the security, reputation, and financial health of a company.\"},{\"name\":\"Risk Documents\",\"description\":\"Risk Documents are supporting documents, evidence, or other materials that are associated with a risk.\"},{\"name\":\"Risk Library\",\"description\":\"The Risk Library is a collection of Risks that can be copied into a Risk Register. The [help docs](https://help.drata.com/en/articles/13371089-drata-s-risk-library-new-experience) have more information.\"},{\"name\":\"Risk Notes\",\"description\":\"Risk Notes allow you to provide additional information about Risks.\"},{\"name\":\"Risk Registers\",\"description\":\"Risk Registers are a collection of Risks. They are used to organize and manage Risks.\"},{\"name\":\"Users and Roles\",\"description\":\"**Users** are are people with access to the Drata platform.  \\n**Roles** grant permissions to Users. The [help docs](https://help.drata.com/en/collections/5993507) have more information on the default Roles.\"},{\"name\":\"User's Assigned Policies\",\"description\":\"User's Assigned Policies track the acknowledgement of Policy Versions by Users.\"},{\"name\":\"User Documents\",\"description\":\"User Documents allow you to provide manual evidence of User and Personnel compliance.\"},{\"name\":\"Vendors\",\"description\":\"Vendors are third-parties that your organization is working with. Drata allows you to track and review risks associated with these third-parties. The [help docs](https://help.drata.com/en/articles/9676307-start-and-manage-security-reviews-for-your-vendors) have more information.\"},{\"name\":\"Vendor Documents\",\"description\":\"Vendor Documents provide compliance-related documentation, such as bridge letters, questionnaires, and SOC reports.\"},{\"name\":\"Vendor Security Reviews\",\"description\":\"Vendor Security Reviews track the status of security reviews for Vendors. You can create a security review, upload questionnaires, and track the progress of the review. The [help docs](https://help.drata.com/en/articles/9676307-start-and-manage-security-reviews-for-your-vendors) have more information.\"},{\"name\":\"Vendor Types\",\"description\":\"Vendor Types are user-defined classifications used to categorize and organize vendors.\"},{\"name\":\"Workspaces\",\"description\":\"Workspaces allow you to represent different products or business lines that have different compliance requirements. Each Workspace can have its own Frameworks and Controls. The [help docs](https://help.drata.com/en/articles/6598264) have more information on how create and manage Workspaces.\"}],\"paths\":{\"/custom-connections\":{\"get\":{\"description\":\"Find Custom Connections matching the provided filters.\\n\\n🔒 Requires **Custom Connections Data: List Custom Connections** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomConnectionsPublicV2Controller_listCustomConnections\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomConnectionExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomConnectionsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Custom Connections\",\"tags\":[\"Custom Connections\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"custom-connections-get\"],\"x-product-area\":[\"CUSTOM_CONNECTIONS\"]},\"post\":{\"description\":\"Create a new Custom Connection. Supported provider types: MDM, HRIS.\\n\\n🔒 Requires **Custom Connections Data: Create Custom Connection Data** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomConnectionsPublicV2Controller_createCustomConnection\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomConnectionCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomConnectionResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Custom Connection\",\"tags\":[\"Custom Connections\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"custom-connections-data-post\"],\"x-product-area\":[\"CUSTOM_CONNECTIONS\"]}},\"/custom-connections/{connectionId}\":{\"get\":{\"operationId\":\"CustomConnectionsPublicV2Controller_getCustomConnection\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of sub-collections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomConnectionExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomConnectionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Custom Connection\",\"tags\":[\"Custom Connections\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"custom-connections-get\"],\"x-product-area\":[\"CUSTOM_CONNECTIONS\"],\"description\":\"🔒 Requires **Custom Connections Data: List Custom Connections** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\"},\"put\":{\"description\":\"Update Custom Connection details\\n\\n🔒 Requires **Custom Connections Data: Create and Update Custom Connection Data** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomConnectionsPublicV2Controller_updateCustomConnection\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomConnectionUpdateRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomConnectionResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Custom Connection\",\"tags\":[\"Custom Connections\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"custom-connections-data-put\"],\"x-product-area\":[\"CUSTOM_CONNECTIONS\"]},\"delete\":{\"operationId\":\"CustomConnectionsPublicV2Controller_deleteCustomConnection\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Custom Connection\",\"tags\":[\"Custom Connections\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"custom-connections-delete\"],\"x-product-area\":[\"CUSTOM_CONNECTIONS\"],\"description\":\"🔒 Requires **custom-connections-delete** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\"}},\"/assets\":{\"get\":{\"description\":\"Find Assets by search terms and filters.\\n\\n🔒 Requires **Assets: List Assets** permission.\",\"operationId\":\"AssetsPublicV2Controller_listAssets\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/AssetExpandEnum\"}}},{\"name\":\"assetClassType\",\"required\":false,\"in\":\"query\",\"description\":\"Filter assets by class type. This filter is only supported in conjunction with expand[]=assetClassTypes.\",\"schema\":{\"$ref\":\"#/components/schemas/AssetClassTypeEnum\"}},{\"name\":\"assetType\",\"required\":false,\"in\":\"query\",\"description\":\"Filter assets by type\",\"schema\":{\"$ref\":\"#/components/schemas/AssetTypeEnum\"}},{\"name\":\"assetProvider\",\"required\":false,\"in\":\"query\",\"description\":\"Filter assets by provider\",\"schema\":{\"$ref\":\"#/components/schemas/AssetProviderEnum\"}},{\"name\":\"userId\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data by user ID associated to the Assets\",\"schema\":{\"maximum\":1000000000,\"example\":1,\"type\":\"number\"}},{\"name\":\"employmentStatus\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data by personnel of this employment status\",\"schema\":{\"$ref\":\"#/components/schemas/EmploymentStatusEnum\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/AssetsResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Assets\",\"tags\":[\"Assets\"],\"x-drata-permissions\":[\"assets-get\"],\"x-product-area\":[\"ASSETS_PAGE\"]},\"post\":{\"description\":\"Manually add a new Asset to the Account.\\n\\n🔒 Requires **Assets: Create Asset** permission.\",\"operationId\":\"AssetsPublicV2Controller_createAsset\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/AssetCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/AssetResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Asset\",\"tags\":[\"Assets\"],\"x-drata-permissions\":[\"assets-post\"],\"x-product-area\":[\"ASSETS_PAGE\"]}},\"/assets/{assetId}\":{\"get\":{\"operationId\":\"AssetsPublicV2Controller_getAsset\",\"parameters\":[{\"name\":\"assetId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/AssetExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/AssetResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Asset\",\"tags\":[\"Assets\"],\"x-drata-permissions\":[\"assets-get\"],\"x-product-area\":[\"ASSETS_PAGE\"],\"description\":\"🔒 Requires **Assets: List Assets** permission.\"},\"put\":{\"description\":\"Update Asset\\n\\n🔒 Requires **Assets: Update Asset** permission.\",\"operationId\":\"AssetsPublicV2Controller_updateAsset\",\"parameters\":[{\"name\":\"assetId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/AssetModifyRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/AssetResponsePublicV2Dto\"}}}},\"204\":{\"description\":\"No Content\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Asset\",\"tags\":[\"Assets\"],\"x-drata-permissions\":[\"assets-put\"],\"x-product-area\":[\"ASSETS_PAGE\"]},\"delete\":{\"description\":\"Remove a virtual or manually-added Asset. This is an unrecoverable operation.\\n\\n🔒 Requires **Assets: Delete Asset** permission.\",\"operationId\":\"AssetsPublicV2Controller_deleteAsset\",\"parameters\":[{\"name\":\"assetId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Remove Asset\",\"tags\":[\"Assets\"],\"x-drata-permissions\":[\"assets-delete\"],\"x-product-area\":[\"ASSETS_PAGE\"]}},\"/background-checks\":{\"post\":{\"description\":\"Create a Background Check record and mark the user as compliant for Background Check requirements.\\n\\n🔒 Requires **Personnel: Create Background Check** permission.\",\"operationId\":\"BackgroundChecksPublicV2Controller_createBackgroundCheck\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/BackgroundCheckCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PersonCompactResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"409\":{\"description\":\"There is a conflict in the business rules with this request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Manual Background Check\",\"tags\":[\"Background Checks\"],\"x-drata-permissions\":[\"background-check-post\"],\"x-product-area\":[\"BACKGROUND_CHECK_SYNC\"]}},\"/company\":{\"get\":{\"operationId\":\"CompaniesPublicV2Controller_getCompany\",\"parameters\":[],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CompanyResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Company\",\"tags\":[\"Company\"],\"x-drata-permissions\":[\"company-settings-get-info\"],\"x-product-area\":[\"COMPANY_INFO\"],\"description\":\"🔒 Requires **Company Settings: Get Company Settings** permission.\"}},\"/workspaces/{workspaceId}/controls/{controlId}/notes\":{\"get\":{\"description\":\"Find Control Notes matching the provided filters.\\n\\n🔒 Requires **Controls: Get Control Note** permission.\",\"operationId\":\"ControlNotesPublicV2Controller_getControlNotes\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"excludeIds\",\"required\":false,\"in\":\"query\",\"description\":\"Exclude Control Notes by IDs\",\"schema\":{\"example\":[],\"type\":\"array\",\"items\":{\"type\":\"string\"}}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlNotesExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlNotesResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Control Notes\",\"tags\":[\"Control Notes\"],\"x-drata-permissions\":[\"controls-notes-get\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]},\"post\":{\"description\":\"Create a Note for a given Control.\\n\\n🔒 Requires **Controls: Create Control Note** permission.\",\"operationId\":\"ControlNotesPublicV2Controller_createControlNote\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlNoteCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlNoteResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Control Note\",\"tags\":[\"Control Notes\"],\"x-drata-permissions\":[\"controls-notes-post\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/workspaces/{workspaceId}/controls/{controlId}/notes/{noteId}\":{\"get\":{\"description\":\"Get a Note associated with a given Control.\\n\\n🔒 Requires **Controls: Get Control Note** permission.\",\"operationId\":\"ControlNotesPublicV2Controller_getControlNote\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"noteId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"string\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlNotesExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlNoteResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Control Note\",\"tags\":[\"Control Notes\"],\"x-drata-permissions\":[\"controls-notes-get\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]},\"put\":{\"description\":\"Update a Note for a given Control.\\n\\n🔒 Requires **Controls: Update Control Note** permission.\",\"operationId\":\"ControlNotesPublicV2Controller_updateNote\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"noteId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/NoteRequestPublicDto\"}}}},\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlNoteResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Control Note\",\"tags\":[\"Control Notes\"],\"x-drata-permissions\":[\"controls-notes-put\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]},\"delete\":{\"description\":\"Delete a Note for a given Control.\\n\\n🔒 Requires **Controls: Delete Control Note** permission.\",\"operationId\":\"ControlNotesPublicV2Controller_deleteNote\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"noteId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Successful\"},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Control Note\",\"tags\":[\"Control Notes\"],\"x-drata-permissions\":[\"controls-notes-delete\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/workspaces/{workspaceId}/controls/{controlId}/owners\":{\"get\":{\"description\":\"Find Control Owners matching the provided filters.\\n\\n🔒 Requires **Controls: Get Control** permission.\",\"operationId\":\"ControlOwnersPublicV2Controller_getControlOwnersForAControl\",\"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\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"frameworkSlug\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data by Users associated with this Control Requirement Framework slug\",\"schema\":{\"example\":\"soc2\",\"type\":\"string\"}},{\"name\":\"includeUserIds[]\",\"required\":false,\"in\":\"query\",\"description\":\"User IDs of the Control Owners to return\",\"schema\":{\"minItems\":1,\"nullable\":true,\"example\":[1,2,3],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},{\"name\":\"excludeUserIds\",\"required\":false,\"in\":\"query\",\"description\":\"User IDs of the Control Owners to exclude\",\"schema\":{\"example\":[],\"type\":\"array\",\"items\":{\"type\":\"number\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlOwnersResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Control Owners\",\"tags\":[\"Control Owners\"],\"x-drata-permissions\":[\"controls-get-control\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]},\"post\":{\"operationId\":\"ControlOwnersPublicV2Controller_createControlOwner\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlOwnerCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Add Control Owner\",\"tags\":[\"Control Owners\"],\"x-drata-permissions\":[\"controls-put-owners\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"],\"description\":\"🔒 Requires **Controls: Manage Control Owners** permission.\"},\"put\":{\"description\":\"Modify all Owners for a given Control\\n\\n🔒 Requires **Controls: Manage Control Owners** permission.\",\"operationId\":\"ControlOwnersPublicV2Controller_modifyControlOwners\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlOwnerModifyRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlOwnersModifyResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Modify Control Owners\",\"tags\":[\"Control Owners\"],\"x-drata-permissions\":[\"controls-put-owners\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/workspaces/{workspaceId}/controls/{controlId}/owners/{ownerId}\":{\"delete\":{\"operationId\":\"ControlOwnersPublicV2Controller_deleteControlOwner\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"ownerId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlOwnersResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Control Owner\",\"tags\":[\"Control Owners\"],\"x-drata-permissions\":[\"controls-delete-owners\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"],\"description\":\"🔒 Requires **Controls: Manage Control Owners** permission.\"}},\"/workspaces/{workspaceId}/controls\":{\"get\":{\"description\":\"Find Controls matching the provided filters.\\n\\n🔒 Requires **Controls: List Controls** permission.\",\"operationId\":\"ControlsPublicV2Controller_getControls\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlsExpandEnum\"}}},{\"name\":\"isMonitored\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Controls that have or do not have a Monitor\",\"schema\":{\"example\":false,\"type\":\"boolean\"}},{\"name\":\"isReady\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Controls that are or are not ready\",\"schema\":{\"example\":false,\"type\":\"boolean\"}},{\"name\":\"hasEvidence\",\"required\":false,\"in\":\"query\",\"description\":\"Filter to Controls with or without Evidence\",\"schema\":{\"example\":true,\"type\":\"boolean\"}},{\"name\":\"hasPolicy\",\"required\":false,\"in\":\"query\",\"description\":\"Filter to Controls with or without Policy\",\"schema\":{\"example\":true,\"type\":\"boolean\"}},{\"name\":\"hasPassingTest\",\"required\":false,\"in\":\"query\",\"description\":\"Filter to Controls with at least one passing Test\",\"schema\":{\"example\":true,\"type\":\"boolean\"}},{\"name\":\"ticketStatus\",\"required\":false,\"in\":\"query\",\"description\":\"Only include Controls with an associated Task Management Ticket\",\"schema\":{\"example\":0,\"enum\":[\"IN_PROGRESS\",\"ARCHIVED\"],\"type\":\"string\"}},{\"name\":\"policyId\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Controls associated with a specific Policy ID\",\"schema\":{\"example\":123,\"type\":\"number\"}},{\"name\":\"isArchived\",\"required\":false,\"in\":\"query\",\"description\":\"Filter to Controls that are or are not archived\",\"schema\":{\"example\":false,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Controls\",\"tags\":[\"Controls\"],\"x-drata-permissions\":[\"controls-get\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]},\"post\":{\"description\":\"Create a new custom Control\\n\\n🔒 Requires **Controls: Create Control** permission.\",\"operationId\":\"ControlsPublicV2Controller_createControl\",\"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/ControlCreateRequestPublicV2Dto\"}},\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"413\":{\"description\":\"The file was too large to upload\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Control\",\"tags\":[\"Controls\"],\"x-drata-permissions\":[\"controls-post\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/workspaces/{workspaceId}/controls/{controlId}\":{\"get\":{\"description\":\"Get all the information for a specific Control\\n\\n🔒 Requires **Controls: Get Control** permission.\",\"operationId\":\"ControlsPublicV2Controller_getControlById\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Control\",\"tags\":[\"Controls\"],\"x-drata-permissions\":[\"controls-get-control\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]},\"put\":{\"operationId\":\"ControlsPublicV2Controller_modifyControl\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlModifyRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Modify Control\",\"tags\":[\"Controls\"],\"x-drata-permissions\":[\"controls-put\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"],\"description\":\"🔒 Requires **Controls: Update Control** permission.\"}},\"/workspaces/{workspaceId}/controls/{controlId}/requirements\":{\"get\":{\"description\":\"Find Control Requirements matching the provided filters.\\n\\n🔒 Requires **Controls: Get Control** permission.\",\"operationId\":\"ControlsPublicV2Controller_getMappedRequirements\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"frameworkTag\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data by controls associated with these framework tags\",\"schema\":{\"example\":[\"SOC_2\",\"ISO27001\"],\"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\",\"CYBER_ESSENTIALS\",\"ISO270172015\",\"ISO270182019\",\"FEDRAMP\",\"NISTAI\",\"PCI4\",\"NISTCSF2\",\"NIS2\",\"DORA\",\"ISO420012023\",\"DRATA_ESSENTIALS\",\"NIST800171R3\",\"CIS8\",\"CYBER_ESSENTIALS_32\",\"FEDRAMP20X\",\"HITRUST\",\"MSSSPA11\",\"ESSENTIAL_EIGHT\",\"NYDFS\",\"TISAX\",\"ISO270182025\",\"CCPA2026\",\"ISO277012025\",\"CUSTOM\",\"ALL\"]}}},{\"name\":\"excludeIds\",\"required\":false,\"in\":\"query\",\"description\":\"Exclude requirements by array of IDs\",\"schema\":{\"example\":[],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},{\"name\":\"frameworkSlug\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data by controls associated with these framework slugs. This parameter is intended to be used only for custom frameworks\",\"schema\":{\"example\":\"slug\",\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlRequirementsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Requirements for Control\",\"tags\":[\"Controls\"],\"x-drata-permissions\":[\"controls-get-control\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/workspaces/{workspaceId}/controls/action-reset-mappings\":{\"post\":{\"description\":\"Reset multiple controls to their original requirement mappings from control templates. Custom controls cannot be reset. Returns success/failure status for each control.\\n\\n🔒 Requires **Controls: Create Control** permission.\",\"operationId\":\"ControlsPublicV2Controller_resetControlRequirementMappings\",\"parameters\":[{\"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/ControlsResetMappingsRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlsResetMappingsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Reset Control Requirement Mappings\",\"tags\":[\"Controls\"],\"x-drata-permissions\":[\"controls-post\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/workspaces/{workspaceId}/controls-requirement-comparison\":{\"get\":{\"description\":\"Compare requirements for multiple controls between tenant mappings and global template mappings.\\n\\n🔒 Requires **Controls: Get Control** permission.\",\"operationId\":\"ControlsPublicV2Controller_compareControlRequirements\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"controlIds[]\",\"required\":true,\"in\":\"query\",\"description\":\"Array of Control IDs to compare requirements for\",\"schema\":{\"minItems\":1,\"example\":[1,2,3],\"type\":\"array\",\"items\":{\"type\":\"number\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ControlsRequirementComparisonResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Compare Control Requirements\",\"tags\":[\"Controls\"],\"x-drata-permissions\":[\"controls-get-control\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/custom-connections/{connectionId}/hris-user-identities\":{\"get\":{\"description\":\"Returns a cursor-paginated list of all active HR user identities for the specified custom HRIS connection.\\n\\n🧪 **Note:** This endpoint is in beta and may change.\\n\\n🔒 Requires **user-identities-hris-get** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomHrisUserIdentitiesPublicV2Controller_listCustomHrisUserIdentities\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomUserIdentitiesResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List HRIS User Identities 🧪\",\"tags\":[\"HRIS User Identities\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"user-identities-hris-get\"],\"x-product-area\":[\"CUSTOM_FRAMEWORKS\"]},\"post\":{\"description\":\"Submit one or more HR user identities for a custom HRIS connection. Each record is keyed by the customer-defined `identityId`. If a record with that `identityId` already exists for this connection, it is updated; otherwise a new record is created.\\n\\n🧪 **Note:** This endpoint is in beta and may change.\\n\\n🔒 Requires **user-identity-hris-post** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomHrisUserIdentitiesPublicV2Controller_createCustomHrisUserIdentities\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomUserIdentitiesCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomUserIdentityResponsePublicV2Dto\"}}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Batch Upsert HRIS User Identities 🧪\",\"tags\":[\"HRIS User Identities\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"user-identity-hris-post\"],\"x-product-area\":[\"CUSTOM_FRAMEWORKS\"]}},\"/custom-connections/{connectionId}/hris-user-identities/{userIdentityId}\":{\"get\":{\"description\":\"Returns a single HR user identity by the Drata-assigned internal ID.\\n\\n🧪 **Note:** This endpoint is in beta and may change.\\n\\n🔒 Requires **user-identity-hris-get** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomHrisUserIdentitiesPublicV2Controller_getCustomHrisUserIdentity\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"userIdentityId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomUserIdentityResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get HRIS User Identity 🧪\",\"tags\":[\"HRIS User Identities\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"user-identity-hris-get\"],\"x-product-area\":[\"CUSTOM_FRAMEWORKS\"]},\"put\":{\"description\":\"Updates an existing HR user identity. Only fields included in the request body are updated; omitted fields retain their current values.\\n\\n🧪 **Note:** This endpoint is in beta and may change.\\n\\n🔒 Requires **user-identity-hris-put** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomHrisUserIdentitiesPublicV2Controller_updateCustomHrisUserIdentity\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"userIdentityId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomUserIdentityUpdateRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/CustomUserIdentityResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update HRIS User Identity 🧪\",\"tags\":[\"HRIS User Identities\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"user-identity-hris-put\"],\"x-product-area\":[\"CUSTOM_FRAMEWORKS\"]},\"delete\":{\"description\":\"Soft-deletes an HR user identity. This endpoint is intended for removing records submitted in error (e.g. test data, duplicates, or employees who should never have been included). To indicate that an employee has left, use the PUT endpoint to set the `separatedAt` field instead — this preserves employment history and allows identity sync to correctly classify the person as `FORMER_EMPLOYEE` or `FORMER_CONTRACTOR`. If the deleted record was previously matched to a Drata user, that user's employment status will move to `UNKNOWN` at the next identity sync. A deleted record can be restored by re-submitting it via the batch upsert endpoint with the same `identityId`.\\n\\n🧪 **Note:** This endpoint is in beta and may change.\\n\\n🔒 Requires **user-identity-hris-delete** permission.\\n\\n💎 Requires your account have the **Custom Connections and Tests** feature. Contact your CSM for help upgrading.\",\"operationId\":\"CustomHrisUserIdentitiesPublicV2Controller_deleteCustomHrisUserIdentity\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"userIdentityId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete HRIS User Identity 🧪\",\"tags\":[\"HRIS User Identities\"],\"x-drata-entitlement\":[\"CUSTOM_CONNECTIONS_AND_TESTS\"],\"x-drata-permissions\":[\"user-identity-hris-delete\"],\"x-product-area\":[\"CUSTOM_FRAMEWORKS\"]}},\"/devices/{deviceId}/documents\":{\"get\":{\"description\":\"Get a list of Documents for a given Device and Document type.\\n\\n🔒 Requires **Devices: Manage Device Documents** permission.\",\"operationId\":\"DeviceDocumentsPublicV2Controller_getDeviceDocuments\",\"parameters\":[{\"name\":\"deviceId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"type\",\"required\":false,\"in\":\"query\",\"description\":\"Filter documents by their type\",\"schema\":{\"$ref\":\"#/components/schemas/DeviceDocumentTypeEnum\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceDocumentExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceDocumentsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Device Documents\",\"tags\":[\"Device Documents\"],\"x-drata-permissions\":[\"devices-get-documents\"],\"x-product-area\":[\"MDM\"]},\"post\":{\"description\":\"Upload a new Device compliance Document for a given Device.\\n\\n🔒 Requires **Devices: Manage Device Documents** permission.\",\"operationId\":\"DeviceDocumentsPublicV2Controller_uploadDocumentForDevice\",\"parameters\":[{\"name\":\"deviceId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"multipart/form-data\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceDocumentCreateRequestPublicV2Dto\"}},\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceDocumentCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceDocumentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"413\":{\"description\":\"The file was too large to upload\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Upload Device Document\",\"tags\":[\"Device Documents\"],\"x-drata-permissions\":[\"devices-post-document\"],\"x-product-area\":[\"MDM\"]}},\"/devices/{deviceId}/documents/{documentId}\":{\"get\":{\"operationId\":\"DeviceDocumentsPublicV2Controller_getDeviceDocument\",\"parameters\":[{\"name\":\"deviceId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"documentId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceDocumentExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceDocumentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Device Document\",\"tags\":[\"Device Documents\"],\"x-drata-permissions\":[\"devices-get-download-document\"],\"x-product-area\":[\"MDM\"],\"description\":\"🔒 Requires **Devices: Manage Device Documents** permission.\"},\"delete\":{\"description\":\"Removes a specific Device Document using the provided Document ID\\n\\n🔒 Requires **Devices: Manage Device Documents** permission.\",\"operationId\":\"DeviceDocumentsPublicV2Controller_deleteDeviceDocument\",\"parameters\":[{\"name\":\"deviceId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"documentId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Device Document\",\"tags\":[\"Device Documents\"],\"x-drata-permissions\":[\"devices-delete-document\"],\"x-product-area\":[\"MDM\"]}},\"/devices\":{\"get\":{\"operationId\":\"DevicesPublicV2Controller_getDevices\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"externalId\",\"required\":false,\"in\":\"query\",\"description\":\"An externally sourced unique identifier for a device\",\"schema\":{\"maxLength\":191,\"type\":\"string\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceExpandEnum\"}}},{\"name\":\"macAddress\",\"required\":false,\"in\":\"query\",\"description\":\"The device MAC address\",\"schema\":{\"example\":\"65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E\",\"type\":\"string\"}},{\"name\":\"serialNumber\",\"required\":false,\"in\":\"query\",\"description\":\"The device serial number\",\"schema\":{\"example\":\"NKRTSPY456\",\"type\":\"string\"}},{\"name\":\"sourceType\",\"required\":false,\"in\":\"query\",\"description\":\"Device source type\",\"schema\":{\"$ref\":\"#/components/schemas/MobileDeviceManagementSourceTypeEnum\"}},{\"name\":\"personnelId\",\"required\":false,\"in\":\"query\",\"description\":\"Personnel ID\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DevicesResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Devices\",\"tags\":[\"Devices\"],\"x-drata-permissions\":[\"devices-get\"],\"x-product-area\":[\"MDM\"],\"description\":\"🔒 Requires **Devices: List Devices** permission.\"}},\"/personnel/{personnelId}/devices\":{\"get\":{\"operationId\":\"DevicesPublicV2Controller_getDevicesForPersonnel\",\"parameters\":[{\"name\":\"personnelId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"externalId\",\"required\":false,\"in\":\"query\",\"description\":\"An externally sourced unique identifier for a device\",\"schema\":{\"maxLength\":191,\"type\":\"string\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceExpandEnum\"}}},{\"name\":\"macAddress\",\"required\":false,\"in\":\"query\",\"description\":\"The device MAC address\",\"schema\":{\"example\":\"65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E\",\"type\":\"string\"}},{\"name\":\"serialNumber\",\"required\":false,\"in\":\"query\",\"description\":\"The device serial number\",\"schema\":{\"example\":\"NKRTSPY456\",\"type\":\"string\"}},{\"name\":\"sourceType\",\"required\":false,\"in\":\"query\",\"description\":\"Device source type\",\"schema\":{\"$ref\":\"#/components/schemas/MobileDeviceManagementSourceTypeEnum\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DevicesResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Devices for Personnel\",\"tags\":[\"Devices\"],\"x-drata-permissions\":[\"devices-get\"],\"x-product-area\":[\"MDM\"],\"description\":\"🔒 Requires **Devices: List Devices** permission.\"}},\"/devices/{deviceId}\":{\"get\":{\"operationId\":\"DevicesPublicV2Controller_getDevice\",\"parameters\":[{\"name\":\"deviceId\",\"required\":true,\"in\":\"path\",\"description\":\"The device ID\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"example\":\"complianceChecks\",\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"asset\",\"complianceChecks\",\"documents\",\"identifiers\",\"deviceApps\"]}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceResponseIdPublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Device\",\"tags\":[\"Devices\"],\"x-drata-permissions\":[\"devices-get\"],\"x-product-area\":[\"MDM\"],\"description\":\"🔒 Requires **Devices: List Devices** permission.\"}},\"/connections/{connectionId}/devices\":{\"get\":{\"description\":\"Get a list of Devices for a given connection\\n\\n🧪 **Note:** This endpoint is in beta and may change.\\n\\n🔒 Requires **Devices: List Devices** permission.\",\"operationId\":\"DevicesPublicV2Controller_getDevicesForCustomConnection\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"description\":\"\\nThe ID of the connection may be obtained in one of two ways:\\n* Calling GET /connections and noting the `id` of the desired custom device connection in the response.\\n* In the Drata App: \\n    * **New Device Connection** \\n        1. Navigate to *Connections* **>** *MDM*.\\n        2. Select the *Available Connections* tab.\\n        3. Chose *Custom Device Connection*.\\n        \\n        After successfully creating a device connection, the connection ID will be displayed under *Account Information*.\\n    * **Existing Device Connection**\\n        1. Navigate to *Connections* **>** *MDM*.\\n        2. Select the *Active Connections*  tab.\\n        3. View a previously created custom device connection.\\n\\n        The connection ID will be displayed under *Account Information*.\\n\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"externalId\",\"required\":false,\"in\":\"query\",\"description\":\"An externally sourced unique identifier for a device\",\"schema\":{\"maxLength\":191,\"type\":\"string\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceExpandEnum\"}}},{\"name\":\"macAddress\",\"required\":false,\"in\":\"query\",\"description\":\"The device MAC address\",\"schema\":{\"example\":\"65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E\",\"type\":\"string\"}},{\"name\":\"serialNumber\",\"required\":false,\"in\":\"query\",\"description\":\"The device serial number\",\"schema\":{\"example\":\"NKRTSPY456\",\"type\":\"string\"}},{\"name\":\"personnelId\",\"required\":false,\"in\":\"query\",\"description\":\"Personnel Id\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DevicesResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Devices for Connection 🧪\",\"tags\":[\"Devices\",\"Devices\"],\"x-drata-permissions\":[\"devices-get\"],\"x-product-area\":[\"MDM\"]}},\"/devices/{deviceId}/apps\":{\"get\":{\"description\":\"Get a list of Apps associated with a given Device.\\n\\n🔒 Requires **Devices: List Devices** permission.\",\"operationId\":\"DevicesPublicV2Controller_getDeviceApps\",\"parameters\":[{\"name\":\"deviceId\",\"required\":true,\"in\":\"path\",\"description\":\"The device ID\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceAppsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Apps for Device\",\"tags\":[\"Devices\"],\"x-drata-permissions\":[\"devices-get\"],\"x-product-area\":[\"MDM\"]}},\"/custom-connections/{connectionId}/devices\":{\"post\":{\"description\":\"Create a new device or update an existing device for a custom connection.\\n\\nAn existing device is searched for based upon matching one or more of these supplied properties in the request payload:\\n* `serialNumber`\\n* `macAddress`\\n* `externalId`\\n\\nIf an existing device is found, the existing device is updated.\\nOtherwise a new device is created.\\n\\n🧪 **Note:** This endpoint is in beta and may change.\\n\\n🔒 Requires **Devices: Create Device** permission.\",\"operationId\":\"DevicesPublicV2Controller_createDeviceForCustomConnection\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"description\":\"\\nThe ID of the connection may be obtained in one of two ways:\\n* Calling GET /connections and noting the `id` of the desired custom device connection in the response.\\n* In the Drata App: \\n    * **New Device Connection** \\n        1. Navigate to *Connections* **>** *MDM*.\\n        2. Select the *Available Connections* tab.\\n        3. Chose *Custom Device Connection*.\\n        \\n        After successfully creating a device connection, the connection ID will be displayed under *Account Information*.\\n    * **Existing Device Connection**\\n        1. Navigate to *Connections* **>** *MDM*.\\n        2. Select the *Active Connections*  tab.\\n        3. View a previously created custom device connection.\\n\\n        The connection ID will be displayed under *Account Information*.\\n\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DeviceResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"413\":{\"description\":\"The file was too large to upload\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create or update Device for Custom Connection 🧪\",\"tags\":[\"Devices\",\"Devices\"],\"x-drata-permissions\":[\"devices-post\"],\"x-product-area\":[\"MDM\"]}},\"/custom-connections/{connectionId}/devices/{deviceId}\":{\"delete\":{\"description\":\"Delete a Device from a Custom Connection.\\n\\n🔒 Requires **Devices: Delete Device** permission.\",\"operationId\":\"DevicesPublicV2Controller_deleteDeviceFromCustomConnection\",\"parameters\":[{\"name\":\"connectionId\",\"required\":true,\"in\":\"path\",\"description\":\"\\nThe ID of the connection may be obtained in one of two ways:\\n* Calling GET /connections and noting the `id` of the desired custom device connection in the response.\\n* In the Drata App: \\n    * **New Device Connection** \\n        1. Navigate to *Connections* **>** *MDM*.\\n        2. Select the *Available Connections* tab.\\n        3. Chose *Custom Device Connection*.\\n        \\n        After successfully creating a device connection, the connection ID will be displayed under *Account Information*.\\n    * **Existing Device Connection**\\n        1. Navigate to *Connections* **>** *MDM*.\\n        2. Select the *Active Connections*  tab.\\n        3. View a previously created custom device connection.\\n\\n        The connection ID will be displayed under *Account Information*.\\n\",\"schema\":{\"type\":\"number\"}},{\"name\":\"deviceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Device ID\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Device\",\"tags\":[\"Devices\"],\"x-drata-permissions\":[\"devices-delete-from-custom-connection\"],\"x-product-area\":[\"MDM\"]}},\"/events\":{\"get\":{\"description\":\"Find Events matching the provided filters.\\n\\n🔒 Requires **Event Tracking: List Events** permission.\",\"operationId\":\"EventsPublicV2Controller_listEvents\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Events can only be sorted by create date\",\"schema\":{\"$ref\":\"#/components/schemas/EventSortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EventExpandEnum\"}}},{\"name\":\"type\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data to events of this type\",\"schema\":{\"$ref\":\"#/components/schemas/EventTypeEnum\"}},{\"name\":\"source\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data to events of this source\",\"schema\":{\"$ref\":\"#/components/schemas/EventSourceEnum\"}},{\"name\":\"category\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data to events of this category\",\"schema\":{\"$ref\":\"#/components/schemas/EventCategoryEnum\"}},{\"name\":\"connectionId\",\"required\":false,\"in\":\"query\",\"description\":\"The connection to filter events by. A null/blank value will return events without a connection.\",\"schema\":{\"nullable\":true,\"type\":\"number\"}},{\"name\":\"userId\",\"required\":false,\"in\":\"query\",\"description\":\"The user to filter events by. A null/blank value will return events without a user.\",\"schema\":{\"nullable\":true,\"type\":\"number\"}},{\"name\":\"workspaceId\",\"required\":false,\"in\":\"query\",\"description\":\"The workspace to filter events to\",\"schema\":{\"type\":\"number\"}},{\"name\":\"createdAtStartDate\",\"required\":false,\"in\":\"query\",\"description\":\"Filters the events to those with a creation date greater than or equal to this date and time.\",\"schema\":{\"format\":\"date-time\",\"type\":\"string\"}},{\"name\":\"createdAtEndDate\",\"required\":false,\"in\":\"query\",\"description\":\"Filters the events to those with a creation date less than or equal to this date and time\",\"schema\":{\"format\":\"date-time\",\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EventsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Events\",\"tags\":[\"Events\"],\"x-drata-permissions\":[\"event-tracking-get\"],\"x-product-area\":[\"EVENT_TRACKING\"]}},\"/events/{eventId}\":{\"get\":{\"description\":\"Get details for an Event.\\n\\n🔒 Requires **Event Tracking: Get Event** permission.\",\"operationId\":\"EventsPublicV2Controller_getEvent\",\"parameters\":[{\"name\":\"eventId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"string\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EventExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EventResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Event\",\"tags\":[\"Events\"],\"x-drata-permissions\":[\"event-tracking-get-event\"],\"x-product-area\":[\"EVENT_TRACKING\"]}},\"/events/{eventId}/download-jobs\":{\"post\":{\"description\":\"Creates an asynchronous job to generate a PDF for an Event.\\n\\n🔒 Requires **Event Tracking: Get Event** permission.\",\"operationId\":\"EventsPublicV2Controller_createEventDownloadJob\",\"parameters\":[{\"name\":\"eventId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EventDownloadJobResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Event PDF Download Job\",\"tags\":[\"Events\"],\"x-drata-permissions\":[\"event-tracking-get-event\"],\"x-product-area\":[\"EVENT_TRACKING\"]}},\"/events/{eventId}/download-jobs/{jobId}\":{\"get\":{\"description\":\"Retrieves the Event PDF download job.\\n\\n🔒 Requires **Event Tracking: Get Event** permission.\",\"operationId\":\"EventsPublicV2Controller_getEventDownloadJobStatus\",\"parameters\":[{\"name\":\"eventId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"string\"}},{\"name\":\"jobId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EventDownloadJobResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Event PDF Export\",\"tags\":[\"Events\"],\"x-drata-permissions\":[\"event-tracking-get-event\"],\"x-product-area\":[\"EVENT_TRACKING\"]}},\"/workspaces/{workspaceId}/evidence-library\":{\"get\":{\"description\":\"Find Evidence Library Items by search terms and filters.\\n\\n🔒 Requires **Evidence Library: List Evidence** permission.\",\"operationId\":\"EvidenceLibraryPublicV2Controller_listEvidenceLibrary\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EvidenceLibraryExpandEnum\"}}},{\"name\":\"name\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Evidence Library Items by name\",\"schema\":{\"maxLength\":191,\"example\":\"Evidence 1\",\"type\":\"string\"}},{\"name\":\"statuses[]\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Evidence Library Items by statuses\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EvidenceStatusEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryListResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Evidence Library Items\",\"tags\":[\"Evidence Library\"],\"x-drata-permissions\":[\"evidence-get\"],\"x-product-area\":[\"EVIDENCE_LIBRARY\"]},\"post\":{\"description\":\"Create a new Evidence Library Item.\\n\\n🔒 Requires **Evidence Library: Create Evidence** permission.\",\"operationId\":\"EvidenceLibraryPublicV2Controller_createEvidenceLibrary\",\"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/EvidenceLibraryCreateRequestPublicV2Dto\"}},\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryCompactResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Evidence Library Item\",\"tags\":[\"Evidence Library\"],\"x-drata-permissions\":[\"evidence-post\"],\"x-product-area\":[\"EVIDENCE_LIBRARY\"]}},\"/workspaces/{workspaceId}/evidence-library/{evidenceLibraryId}\":{\"get\":{\"description\":\"Get a specific Evidence Library Item by ID.\\n\\n🔒 Requires **Evidence Library: List Evidence** permission.\",\"operationId\":\"EvidenceLibraryPublicV2Controller_getEvidenceLibrary\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"evidenceLibraryId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EvidenceLibraryExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryCompactResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Evidence Library Item\",\"tags\":[\"Evidence Library\"],\"x-drata-permissions\":[\"evidence-get\"],\"x-product-area\":[\"EVIDENCE_LIBRARY\"]},\"put\":{\"description\":\"Update an existing Evidence Library Item.\\n\\n🔒 Requires **Evidence Library: Update Evidence** permission.\",\"operationId\":\"EvidenceLibraryPublicV2Controller_updateEvidenceLibrary\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"evidenceLibraryId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"multipart/form-data\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryModifyRequestPublicV2Dto\"}},\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryModifyRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryCompactResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Evidence Library Item\",\"tags\":[\"Evidence Library\"],\"x-drata-permissions\":[\"evidence-put\"],\"x-product-area\":[\"EVIDENCE_LIBRARY\"]},\"delete\":{\"description\":\"Delete an Evidence Library Item.\\n\\n🔒 Requires **Evidence Library: Delete Evidence** permission.\",\"operationId\":\"EvidenceLibraryPublicV2Controller_deleteEvidenceLibrary\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"evidenceLibraryId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Evidence Library Item\",\"tags\":[\"Evidence Library\"],\"x-drata-permissions\":[\"evidence-delete\"],\"x-product-area\":[\"EVIDENCE_LIBRARY\"]}},\"/workspaces/{workspaceId}/evidence-library/{evidenceLibraryId}/versions/{versionId}\":{\"get\":{\"description\":\"Retrieve Evidence Library Version details.\\n\\n🔒 Requires **Evidence Library: List Evidence** permission.\",\"operationId\":\"EvidenceLibraryPublicV2Controller_getEvidenceLibraryVersion\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"evidenceLibraryId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"versionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EvidenceLibraryVersionExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/EvidenceLibraryVersionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Evidence Library Version\",\"tags\":[\"Evidence Library\"],\"x-drata-permissions\":[\"evidence-get\"],\"x-product-area\":[\"EVIDENCE_LIBRARY\"]}},\"/workspaces/{workspaceId}/frameworks\":{\"get\":{\"description\":\"Find Frameworks matching the provided filters.\\n\\n🔒 Requires **Frameworks: List Frameworks** permission.\",\"operationId\":\"FrameworksPublicV2Controller_getFrameworks\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"name\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Frameworks by name (partial match)\",\"schema\":{\"example\":\"SOC 2\",\"type\":\"string\"}},{\"name\":\"excludeIds\",\"required\":false,\"in\":\"query\",\"description\":\"Array of Framework IDs to exclude from results\",\"schema\":{\"example\":[1,2,3],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},{\"name\":\"isReady\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Frameworks by ready state\",\"schema\":{\"example\":true,\"type\":\"boolean\"}},{\"name\":\"isEnabled\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Frameworks by enabled state\",\"schema\":{\"example\":true,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/FrameworksResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Frameworks\",\"tags\":[\"Frameworks\"],\"x-drata-permissions\":[\"workspaces-get-frameworks\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/workspaces/{workspaceId}/framework-requirements\":{\"get\":{\"description\":\"Find Framework Requirements matching the provided filters. Use `expand[]=controls` to include a limited subcollection of controls for each requirement.\\n\\n🔒 Requires **Frameworks: List Framework Requirements** permission.\",\"operationId\":\"FrameworksPublicV2Controller_getFrameworkRequirements\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/FrameworkRequirementsExpandEnum\"}}},{\"name\":\"isReady\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Requirements that are or are not ready\",\"schema\":{\"example\":false,\"type\":\"boolean\"}},{\"name\":\"isInScope\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Requirements that are or are not in scope (not archived)\",\"schema\":{\"example\":true,\"type\":\"boolean\"}},{\"name\":\"frameworkTag\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data by Requirements associated with these framework tags\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/FrameworkTagEnum\"}}},{\"name\":\"excludeIds\",\"required\":false,\"in\":\"query\",\"description\":\"Exclude Requirements by array of IDs\",\"schema\":{\"example\":[],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},{\"name\":\"frameworkSlug\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data by Requirements associated with these framework slugs. This parameter is intended to be used only for custom frameworks\",\"schema\":{\"example\":\"slug\",\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/FrameworkRequirementsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Framework Requirements\",\"tags\":[\"Frameworks\"],\"x-drata-permissions\":[\"get-frameworks-requirements\"],\"x-product-area\":[\"REQUIREMENTS_FRAMEWORKS\"]}},\"/personnel\":{\"get\":{\"description\":\"Get a paginated list of Personnel records.\\n\\n🔒 Requires **Personnel: List Personnel** permission.\",\"operationId\":\"PersonnelPublicV2Controller_listPersonnel\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PersonnelExpandEnum\"}}},{\"name\":\"employmentStatus[]\",\"required\":false,\"in\":\"query\",\"description\":\"Personnel by employment statuses\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EmploymentStatusEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PersonnelResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Personnel\",\"tags\":[\"Personnel\"],\"x-drata-permissions\":[\"personnel-get\"],\"x-product-area\":[\"PERSONNEL_PAGE\"]}},\"/personnel/{personnelId}\":{\"get\":{\"description\":\"Get a single Personnel record.\\n\\n🔒 Requires **Personnel: Get Personnel** permission.\",\"operationId\":\"PersonnelPublicV2Controller_getPerson\",\"parameters\":[{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PersonnelExpandEnum\"}}},{\"name\":\"personnelId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Personnel ID or User's email address prefixed with `email:`\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Personnel ID\"},{\"type\":\"string\",\"description\":\"Email of the Personnel's User, prefixed with 'email:' e.g. `email:user@example.com`\"}]}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PersonResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Personnel\",\"tags\":[\"Personnel\"],\"x-drata-permissions\":[\"personnel-get-personnel-details\"],\"x-product-area\":[\"PERSONNEL_PAGE\"]},\"put\":{\"description\":\"Update a single Personnel record. Note: Once fields are manually updated, automatic updates from identity providers (IDP) and HRIS systems will be ignored for those fields. Use the resync endpoint to restore automatic updates.\\n\\n🔒 Requires **Personnel: Update Personnel - applies to V2 only** permission.\",\"operationId\":\"PersonnelPublicV2Controller_modifyPerson\",\"parameters\":[{\"name\":\"personnelId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Personnel ID or User's email address prefixed with `email:`\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Personnel ID\"},{\"type\":\"string\",\"description\":\"Email of the Personnel's User, prefixed with 'email:' e.g. `email:user@example.com`\"}]}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PersonnelModifyRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PersonResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Personnel\",\"tags\":[\"Personnel\"],\"x-drata-permissions\":[\"personnel-put\"],\"x-product-area\":[\"PERSONNEL_PAGE\"]}},\"/personnel/actions\":{\"post\":{\"description\":\"Perform actions on Personnel records. Supports `reset-sync` for specific Personnel IDs and `reset-sync-all` for all Personnel.\\n\\n🔒 Requires **Personnel: Reset Personnel's IdP/HRIS Sync Status** permission.\",\"operationId\":\"PersonnelPublicV2Controller_performPersonnelAction\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PersonnelActionsRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Action performed successfully\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PersonnelActionsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Reset Personnel Sync\",\"tags\":[\"Personnel\"],\"x-drata-permissions\":[\"personnel-put-reset-resync\"],\"x-product-area\":[\"PERSONNEL_PAGE\"]}},\"/policies\":{\"get\":{\"description\":\"List published Policies matching the provided filters.\\n\\n🔒 Requires **Policies: List Policies** permission.\",\"operationId\":\"PoliciesPublicV2Controller_listPolicies\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyListExpandEnum\"}}},{\"name\":\"name\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Policies by name (partial match)\",\"schema\":{\"maxLength\":191,\"example\":\"Data Protection Policy\",\"type\":\"string\"}},{\"name\":\"statuses[]\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Policies by one or more statuses\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyStatusEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PoliciesResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicDto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Policies\",\"tags\":[\"Policies\"],\"x-drata-permissions\":[\"policies-get-policies\"],\"x-product-area\":[\"POLICY_CENTER\"]}},\"/policies/{policyId}\":{\"get\":{\"description\":\"Get a specific published Policy.\\n\\n🔒 Requires **Policies: List Policies** permission.\",\"operationId\":\"PoliciesPublicV2Controller_getPolicy\",\"parameters\":[{\"name\":\"policyId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PolicyResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicDto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Policy\",\"tags\":[\"Policies\"],\"x-drata-permissions\":[\"policies-get-policies\"],\"x-product-area\":[\"POLICY_CENTER\"]}},\"/policies/{policyId}/policy-versions\":{\"get\":{\"description\":\"List Policy Versions for a specific Policy matching the provided filters.\\n\\n🔒 Requires **Policies: List Policies** permission.\",\"operationId\":\"PoliciesPublicV2Controller_listPolicyVersions\",\"parameters\":[{\"name\":\"policyId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyVersionExpandEnum\"}}},{\"name\":\"version\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Policy Versions by version number\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"current\",\"required\":false,\"in\":\"query\",\"description\":\"Filter to only current Policy Versions\",\"schema\":{\"type\":\"boolean\"}},{\"name\":\"statuses[]\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Policy Versions by status\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyVersionStatusEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PolicyVersionsResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicDto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Policy Versions\",\"tags\":[\"Policies\"],\"x-drata-permissions\":[\"policies-get-policies\"],\"x-product-area\":[\"POLICY_CENTER\"]}},\"/policies/{policyId}/policy-versions/{policyVersionId}\":{\"get\":{\"description\":\"Get a specific Policy Version. Returns policy version details (default) or policy version HTML content based on Accept header.\\n\\n🔒 Requires **Policies: List Policies** permission.\",\"operationId\":\"PoliciesPublicV2Controller_getPolicyVersion\",\"parameters\":[{\"name\":\"policyId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"policyVersionId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyVersionExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/PolicyVersionResponsePublicV2Dto\"}},\"text/html\":{\"schema\":{\"$ref\":\"#/components/schemas/PolicyVersionHtmlResponsePublicV2Dto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Policy Version\",\"tags\":[\"Policies\"],\"x-drata-permissions\":[\"policies-get-policies\"],\"x-product-area\":[\"POLICY_CENTER\"]}},\"/risk-registers/{riskRegisterId}/risks/{riskId}/documents\":{\"get\":{\"description\":\"Retrieve all Documents associated with a specific Risk.\\n\\n🔒 Requires **Risk Management: Get Risk Documents** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskDocumentsPublicV2Controller_listRiskDocuments\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskDocumentsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Risk Documents\",\"tags\":[\"Risk Documents\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-documents-get\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"post\":{\"description\":\"Upload one or more Documents for a given Risk.\\n\\n🔒 Requires **Risk Management: Upload Risk Document** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskDocumentsPublicV2Controller_uploadRiskDocuments\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}}],\"requestBody\":{\"required\":true,\"description\":\"Upload one or more Documents for the Risk\",\"content\":{\"multipart/form-data\":{\"schema\":{\"type\":\"object\",\"properties\":{\"files\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"format\":\"binary\"},\"description\":\"Document files to upload (max 10 files, 25MB each)\"}},\"required\":[\"files\"]}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskDocumentsUploadResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"413\":{\"description\":\"The file was too large to upload\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Upload Risk Documents\",\"tags\":[\"Risk Documents\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-documents-post\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers/{riskRegisterId}/risks/{riskId}/documents/{documentId}\":{\"get\":{\"description\":\"Retrieve a specific Risk Document by its ID.\\n\\n🔒 Requires **Risk Management: Get Risk Documents** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskDocumentsPublicV2Controller_getRiskDocument\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"documentId\",\"required\":true,\"in\":\"path\",\"description\":\"The Document ID\",\"schema\":{\"example\":123,\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/DocumentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Risk Document\",\"tags\":[\"Risk Documents\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-documents-get\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"delete\":{\"description\":\"Delete a specific Risk Document using the provided Document ID.\\n\\n🔒 Requires **Risk Management: Delete Risk Document** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskDocumentsPublicV2Controller_deleteRiskDocument\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"documentId\",\"required\":true,\"in\":\"path\",\"description\":\"The Document ID\",\"schema\":{\"example\":123,\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"\"},\"204\":{\"description\":\"No Content\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Risk Document\",\"tags\":[\"Risk Documents\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-documents-delete\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-library\":{\"get\":{\"description\":\"Find Library Risks by search terms and filters.\\n\\n🔒 Requires **Risk Management: List Risks** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskLibraryPublicV2Controller_listRiskLibrary\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"riskId\",\"required\":false,\"in\":\"query\",\"description\":\"Filter by Risk ID. Searches for risks whose ID starts with the provided value (e.g., \\\"AA\\\" matches \\\"AA-01\\\", \\\"AA-02\\\").\",\"schema\":{\"example\":\"AA-01\",\"type\":\"string\"}},{\"name\":\"title\",\"required\":false,\"in\":\"query\",\"description\":\"Filter by Title. Searches for risks whose title contains the provided text anywhere in the field (case-insensitive).\",\"schema\":{\"example\":\"Activity Log Evaluation\",\"type\":\"string\"}},{\"name\":\"description\",\"required\":false,\"in\":\"query\",\"description\":\"Filter by Description. Searches for risks whose description contains the provided text anywhere in the field (case-insensitive).\",\"schema\":{\"example\":\"Unauthorized System Access\",\"type\":\"string\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskLibraryExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskLibraryResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Risk Libraries\",\"tags\":[\"Risk Library\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-management-get\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-library/{riskLibraryId}\":{\"get\":{\"description\":\"Get Risk Library\\n\\n🔒 Requires **Risk Management: Get Risk** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskLibraryPublicV2Controller_getRiskLibraryItem\",\"parameters\":[{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskLibraryExpandEnum\"}}},{\"name\":\"riskLibraryId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk Library ID or string Risk Library ID prefixed with `riskId:`\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Integer Risk Library ID\"},{\"type\":\"string\",\"description\":\"String Risk Library ID, prefixed with 'riskId:' e.g. `riskId:AC-10`\"}]}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskLibraryItemResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Risk Library Item by ID.\",\"tags\":[\"Risk Library\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-management-get-risk-details\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-library/action-copy\":{\"post\":{\"description\":\"Copy Risk Library Items to Register\\n\\n🔒 Requires **Risk Management: Create Risk** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskLibraryPublicV2Controller_copyRiskLibrary\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskLibraryCopyRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskLibraryCopyResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Copies Risk Library Items to a Risk Register.\",\"tags\":[\"Risk Library\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-management-post\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers/{riskRegisterId}/risks/{riskId}/notes\":{\"get\":{\"description\":\"Find Risk Notes matching the provided filters.\\n\\n🔒 Requires **Risk Management: Get Risk Note** permission.\",\"operationId\":\"RiskNotesPublicV2Controller_getRiskNotes\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskNotesExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskNotesResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Risk Notes\",\"tags\":[\"Risk Notes\"],\"x-drata-permissions\":[\"risk-notes-get\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"post\":{\"description\":\"Create a new Note for a specific Risk.\\n\\n🔒 Requires **Risk Management: Create Risk Note** permission.\",\"operationId\":\"RiskNotesPublicV2Controller_createRiskNote\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID.\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskNoteWriteRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskNoteResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Risk Note\",\"tags\":[\"Risk Notes\"],\"x-drata-permissions\":[\"risk-notes-post\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers/{riskRegisterId}/risks/{riskId}/notes/{noteId}\":{\"get\":{\"description\":\"Get a Note associated with a given Risk.\\n\\n🔒 Requires **Risk Management: Get Risk Note** permission.\",\"operationId\":\"RiskNotesPublicV2Controller_getRiskNote\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID.\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"noteId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskNotesExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskNoteResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Risk Note\",\"tags\":[\"Risk Notes\"],\"x-drata-permissions\":[\"risk-notes-get\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"put\":{\"description\":\"Update a specific Risk Note using the provided Note ID.\\n\\n🔒 Requires **Risk Management: Update Risk Note** permission.\",\"operationId\":\"RiskNotesPublicV2Controller_updateRiskNote\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"noteId\",\"required\":true,\"in\":\"path\",\"description\":\"The Note ID\",\"schema\":{\"example\":123,\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskNoteWriteRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskNoteResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Risk Note\",\"tags\":[\"Risk Notes\"],\"x-drata-permissions\":[\"risk-notes-put\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"delete\":{\"description\":\"Delete a specific Risk Note using the provided Note ID.\\n\\n🔒 Requires **Risk Management: Delete Risk Note** permission.\",\"operationId\":\"RiskNotesPublicV2Controller_deleteRiskNote\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"noteId\",\"required\":true,\"in\":\"path\",\"description\":\"The Note ID\",\"schema\":{\"example\":123,\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"\"},\"204\":{\"description\":\"No Content\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Risk Note\",\"tags\":[\"Risk Notes\"],\"x-drata-permissions\":[\"risk-notes-delete\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers\":{\"get\":{\"description\":\"Retrieve all Risk Registers associated with the account.\\n\\n🔒 Requires **Risk Management: List Risk Registers** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskRegisterPublicV2Controller_listRiskRegisters\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"name\",\"required\":false,\"in\":\"query\",\"description\":\"Search query for Register name\",\"schema\":{\"maxLength\":191,\"example\":\"security\",\"type\":\"string\"}},{\"name\":\"ownerIds[]\",\"required\":false,\"in\":\"query\",\"description\":\"User IDs of the Register Owners to filter by\",\"schema\":{\"example\":[1,2,3],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},{\"name\":\"workspaceIds[]\",\"required\":false,\"in\":\"query\",\"description\":\"Workspace IDs to filter Risk Registers by\",\"schema\":{\"example\":[1,2],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskRegisterExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskRegistersResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Risk Registers\",\"tags\":[\"Risk Registers\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-registers-list\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"post\":{\"description\":\"Create Risk Register.\\n\\n🔒 Requires **Risk Management: Create Risk Register** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskRegisterPublicV2Controller_createRiskRegister\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskRegisterCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskRegisterResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Risk Register\",\"tags\":[\"Risk Registers\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-registers-post\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers/{riskRegisterId}\":{\"get\":{\"description\":\"Get Risk Register details\\n\\n🔒 Requires **Risk Management: Get Risk Register** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskRegisterPublicV2Controller_getRiskRegister\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskRegisterResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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/ExceptionResponsePublicV2Dto\"}}}},\"404\":{\"description\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Risk Register\",\"tags\":[\"Risk Registers\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-registers-get\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"put\":{\"description\":\"Update the Risk Register details\\n\\n🔒 Requires **Risk Management: Update Risk Register** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskRegisterPublicV2Controller_updateRiskRegister\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskRegisterUpdatePublicV2RequestDto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskRegisterResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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/ExceptionResponsePublicV2Dto\"}}}},\"404\":{\"description\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Risk Register\",\"tags\":[\"Risk Registers\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-registers-put\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"delete\":{\"description\":\"Deletes a Risk Register\\n\\n🔒 Requires **Risk Management: Delete Risk Register** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskRegisterPublicV2Controller_deleteRiskRegister\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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/ExceptionResponsePublicV2Dto\"}}}},\"404\":{\"description\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Risk Register\",\"tags\":[\"Risk Registers\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-registers-delete\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers/{riskRegisterId}/risks\":{\"get\":{\"description\":\"Find Risks matching the provided filters.\\n\\n🔒 Requires **Risk Management: List Risks** permission.\",\"operationId\":\"RiskManagementPublicV2Controller_listRisks\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskExpandV2Enum\"}}},{\"name\":\"title\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Risks by title. Performs a case-insensitive partial match on the Risk title field.\",\"schema\":{\"example\":\"Activity Log Evaluation - Unauthorized System Access\",\"type\":\"string\"}},{\"name\":\"status\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Risks by status\",\"schema\":{\"$ref\":\"#/components/schemas/RiskStatusTypeEnum\"}},{\"name\":\"treatmentPlan\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Risks by their treatment strategy. Treatment plans define how the organization addresses each Risk: ACCEPT (acknowledge and monitor), AVOID (eliminate the Risk source), MITIGATE (reduce impact/likelihood), TRANSFER (shift to third party via insurance/contracts), or UNTREATED (no action taken yet).\",\"schema\":{\"$ref\":\"#/components/schemas/RiskTreatmentPlanEnum\"}},{\"name\":\"minScore\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Risks by minimum calculated Risk score (impact × likelihood). Score range depends on organization settings (1-25 with thresholds 1-4=low, 5-9=medium, 10-16=high, 17-25=critical)\",\"schema\":{\"minimum\":1,\"maximum\":25,\"nullable\":true,\"example\":5,\"type\":\"number\"}},{\"name\":\"maxScore\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Risks by maximum calculated Risk score (impact × likelihood). Score range depends on organization settings (1-25 with thresholds 1-4=low, 5-9=medium, 10-16=high, 17-25=critical)\",\"schema\":{\"minimum\":1,\"maximum\":25,\"nullable\":true,\"example\":16,\"type\":\"number\"}},{\"name\":\"vendorId\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Risks by vendor/third-party provider. Specify the unique vendor identifier to return only Risks associated with that specific vendor, such as Risks related to vendor security assessments, data processing agreements, or third-party service dependencies.\",\"schema\":{\"nullable\":true,\"example\":1,\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RisksResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\"},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Risks\",\"tags\":[\"Risks\"],\"x-drata-permissions\":[\"risk-management-get\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"post\":{\"description\":\"Create a new custom Risk in the Risk Register.\\n\\n🔒 Requires **Risk Management: Create Risk** permission.\",\"operationId\":\"RiskManagementPublicV2Controller_createRisk\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Risk\",\"tags\":[\"Risks\"],\"x-drata-permissions\":[\"risk-management-post\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers/{riskRegisterId}/risks/{riskId}\":{\"get\":{\"description\":\"Get detail for a Risk item.\\n\\n🔒 Requires **Risk Management: Get Risk** permission.\",\"operationId\":\"RiskManagementPublicV2Controller_getRisk\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\"},\"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\":\"Not Found\"},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Risk\",\"tags\":[\"Risks\"],\"x-drata-permissions\":[\"risk-management-get-risk-details\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]},\"put\":{\"description\":\"Update an existing Risk.\\n\\n🔒 Requires **Risk Management: Update Risk** permission.\",\"operationId\":\"RiskManagementPublicV2Controller_updateRisk\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"riskId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Risk ID or string risk identifier (e.g., \\\"RISK-001\\\")\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Risk ID\",\"example\":123},{\"type\":\"string\",\"description\":\"Risk identifier\",\"example\":\"RISK-001\"}]}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskUpdateRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Risk\",\"tags\":[\"Risks\"],\"x-drata-permissions\":[\"risk-management-patch\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/risk-registers/{riskRegisterId}/insights\":{\"get\":{\"description\":\"Retrieve comprehensive analytics and dashboard data for a Risk Register, including risk posture distribution, treatment overview, risk heatmap, category breakdown, scoring progress, and historical trends over time.\\n\\n🔒 Requires **Risk Management: List Insights** permission.\\n\\n💎 Requires your account have the **Risk Management Pro** feature. Contact your CSM for help upgrading.\",\"operationId\":\"RiskManagementPublicV2Controller_getRiskInsights\",\"parameters\":[{\"name\":\"riskRegisterId\",\"required\":true,\"in\":\"path\",\"description\":\"The Risk Register ID\",\"schema\":{\"example\":1,\"type\":\"number\"}},{\"name\":\"ownerIds[]\",\"required\":false,\"in\":\"query\",\"description\":\"Filter insights to only include Risks where the owner matches the specified user IDs\",\"schema\":{\"example\":[1,2,3],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},{\"name\":\"status[]\",\"required\":false,\"in\":\"query\",\"description\":\"Filter insights by Risk Status. ACTIVE includes Risks currently being managed, CLOSED includes Risks that have been resolved or accepted. ARCHIVED includes Risks that are not applicable to your organization.\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskStatusTypeEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RiskDashboardResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"401\":{\"description\":\"Invalid Authorization\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"402\":{\"description\":\"You must upgrade your plan to use this feature\",\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Risk Insights\",\"tags\":[\"Risks\"],\"x-drata-entitlement\":[\"RISK_MANAGEMENT\"],\"x-drata-permissions\":[\"risk-management-get-insights\"],\"x-product-area\":[\"RISK_MANAGEMENT\"]}},\"/roles\":{\"get\":{\"description\":\"Find Roles matching the provided filters.\\n\\n🔒 Requires **Roles: List Roles** permission.\",\"operationId\":\"RolesPublicV2Controller_listRoles\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RoleExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RolesResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Roles\",\"tags\":[\"Users and Roles\"],\"x-drata-permissions\":[\"roles-get\"],\"x-product-area\":[\"RBAC\"]}},\"/roles/{roleId}\":{\"get\":{\"description\":\"Get the full detail of a Role record.\\n\\n🔒 Requires **Roles: Get Role** permission.\",\"operationId\":\"RolesPublicV2Controller_getRole\",\"parameters\":[{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RoleExpandEnum\"}}},{\"name\":\"roleId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Role ID or name prefixed with `role:`\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Role ID\"},{\"type\":\"string\",\"description\":\"Role name, prefixed with 'role:' e.g. `role:ADMIN`\"}]}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/RoleResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Role\",\"tags\":[\"Users and Roles\"],\"x-drata-permissions\":[\"role-get\"],\"x-product-area\":[\"RBAC\"]}},\"/roles/{roleId}/users\":{\"get\":{\"description\":\"List all Users that have a specific Role assigned.\\n\\n🔒 Requires **Users: List Users** permission.\",\"operationId\":\"RolesPublicV2Controller_listUsers\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserExpandEnum\"}}},{\"name\":\"firstName\",\"required\":false,\"in\":\"query\",\"description\":\"User first name\",\"schema\":{\"example\":\"John\",\"type\":\"string\"}},{\"name\":\"lastName\",\"required\":false,\"in\":\"query\",\"description\":\"User last name\",\"schema\":{\"example\":\"Doe\",\"type\":\"string\"}},{\"name\":\"roleId\",\"required\":true,\"in\":\"path\",\"description\":\"An integer Role ID or name prefixed with `role:`\",\"schema\":{\"oneOf\":[{\"type\":\"number\",\"description\":\"Role ID\"},{\"type\":\"string\",\"description\":\"Role name, prefixed with 'role:' e.g. `role:ADMIN`\"}]}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UsersResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Users with Role\",\"tags\":[\"Users and Roles\"],\"x-drata-permissions\":[\"users-get\"],\"x-product-area\":[\"RBAC\"]}},\"/users/{userId}/documents\":{\"get\":{\"description\":\"Find User Documents matching the provided filters.\\n\\n🔒 Requires **Users: List User Documents** permission.\",\"operationId\":\"UserDocumentsPublicV2Controller_listUserDocuments\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserDocumentExpandEnum\"}}},{\"name\":\"name\",\"required\":false,\"in\":\"query\",\"description\":\"Filter documents by name\",\"schema\":{\"example\":\"Security training\",\"type\":\"string\"}},{\"name\":\"type\",\"required\":false,\"in\":\"query\",\"description\":\"Filter documents by their type\",\"schema\":{\"example\":\"SEC_TRAINING\",\"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\",\"NIST_AI_TRAINING_EVIDENCE\"],\"type\":\"string\"}},{\"name\":\"userId\",\"required\":true,\"in\":\"path\",\"description\":\"A Drata integer ID or an email address of the form 'email:value'.\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserDocumentsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List User Documents\",\"tags\":[\"User Documents\"],\"x-drata-permissions\":[\"users-get-documents\"],\"x-product-area\":[\"PERSONNEL_COMPLIANCE\"]},\"post\":{\"description\":\"Upload a User Document.\\n\\n🔒 Requires **Users: Create User Document** permission.\",\"operationId\":\"UserDocumentsPublicV2Controller_uploadUserDocument\",\"parameters\":[{\"name\":\"userId\",\"required\":true,\"in\":\"path\",\"description\":\"A Drata integer ID or an email address of the form 'email:value'.\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"multipart/form-data\":{\"schema\":{\"$ref\":\"#/components/schemas/UserDocumentCreateRequestPublicV2Dto\"}},\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserDocumentCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserDocumentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"413\":{\"description\":\"The file was too large to upload\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Upload User Document\",\"tags\":[\"User Documents\"],\"x-drata-permissions\":[\"users-post-document\"],\"x-product-area\":[\"PERSONNEL_COMPLIANCE\"]}},\"/users/{userId}/documents/{documentId}\":{\"get\":{\"description\":\"Get the full detail of a User Document.\\n\\n🔒 Requires **Users: List User Documents** permission.\",\"operationId\":\"UserDocumentsPublicV2Controller_getUserDocument\",\"parameters\":[{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserDocumentExpandEnum\"}}},{\"name\":\"documentId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"userId\",\"required\":true,\"in\":\"path\",\"description\":\"A Drata integer ID or an email address of the form 'email:value'.\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserDocumentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get User Document\",\"tags\":[\"User Documents\"],\"x-drata-permissions\":[\"users-get-documents\"],\"x-product-area\":[\"PERSONNEL_COMPLIANCE\"]},\"delete\":{\"operationId\":\"UserDocumentsPublicV2Controller_deleteUserDocument\",\"parameters\":[{\"name\":\"documentId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"userId\",\"required\":true,\"in\":\"path\",\"description\":\"A Drata integer ID or an email address of the form 'email:value'\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"Successful\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete User Document\",\"tags\":[\"User Documents\"],\"x-drata-permissions\":[\"users-delete-document\"],\"x-product-area\":[\"PERSONNEL_COMPLIANCE\"],\"description\":\"🔒 Requires **Users: Delete User Document** permission.\"}},\"/users/{userId}/assigned-policies\":{\"get\":{\"operationId\":\"UsersPoliciesPublicV2Controller_getPolicyVersionsForUser\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserPoliciesExpandEnum\"}}},{\"name\":\"userId\",\"required\":true,\"in\":\"path\",\"description\":\"A Drata integer ID or an email address of the form 'email:value'.\",\"schema\":{\"oneOf\":[{\"type\":\"number\"},{\"type\":\"string\"}]}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserPolicyVersionsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get User's Assigned Policy details\",\"tags\":[\"User's Assigned Policies\"],\"x-drata-permissions\":[\"user-policies-get-user-policies\"],\"x-product-area\":[\"POLICY_CENTER\"],\"description\":\"🔒 Requires **User Policies: List User's Assigned Policies** permission.\"}},\"/users/{userId}/assigned-policies/{policyId}/action-acknowledge\":{\"post\":{\"operationId\":\"UsersPoliciesPublicV2Controller_acceptUserPolicyVersion\",\"parameters\":[{\"name\":\"policyId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"userId\",\"required\":true,\"in\":\"path\",\"description\":\"A Drata integer ID or an email address of the form 'email:value'.\",\"schema\":{\"oneOf\":[{\"type\":\"number\"},{\"type\":\"string\"}]}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserPolicyAcceptRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserPolicyVersionResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"409\":{\"description\":\"There is a conflict in the business rules with this request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Acknowledge User's Assigned Policy\",\"tags\":[\"User's Assigned Policies\"],\"x-drata-permissions\":[\"user-policies-acknowledge-policy-version\"],\"x-product-area\":[\"POLICY_CENTER\"],\"description\":\"🔒 Requires **User Policies: Acknowledge User's Assigned Policy** permission.\"}},\"/users\":{\"get\":{\"description\":\"Find Users matching the provided filters.\\n\\n🔒 Requires **Users: List Users** permission.\",\"operationId\":\"UsersPublicV2Controller_listUsers\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserExpandEnum\"}}},{\"name\":\"firstName\",\"required\":false,\"in\":\"query\",\"description\":\"User first name\",\"schema\":{\"example\":\"John\",\"type\":\"string\"}},{\"name\":\"lastName\",\"required\":false,\"in\":\"query\",\"description\":\"User last name\",\"schema\":{\"example\":\"Doe\",\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UsersResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Users\",\"tags\":[\"Users and Roles\"],\"x-drata-permissions\":[\"users-get\"],\"x-product-area\":[\"TBD\"]}},\"/users/{userId}\":{\"get\":{\"description\":\"Get the full detail of a User record.\\n\\n🔒 Requires **Users: Get User** permission.\",\"operationId\":\"UsersPublicV2Controller_getUser\",\"parameters\":[{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserExpandEnum\"}}},{\"name\":\"userId\",\"required\":true,\"in\":\"path\",\"description\":\"A Drata integer ID or an email address of the form 'email:value'.\",\"schema\":{\"oneOf\":[{\"type\":\"number\"},{\"type\":\"string\"}]}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/UserResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get User\",\"tags\":[\"Users and Roles\"],\"x-drata-permissions\":[\"user-get\"],\"x-product-area\":[\"TBD\"]}},\"/workspaces/{workspaceId}/monitoring-tests\":{\"get\":{\"description\":\"Find Monitoring Tests matching the provided filters\\n\\n🔒 Requires **Monitoring: List Monitors** permission.\",\"operationId\":\"MonitorsPublicV2Controller_listMonitors\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/MonitorExpandEnum\"}}},{\"name\":\"checkResultStatus\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Monitors by result status\",\"schema\":{\"$ref\":\"#/components/schemas/CheckResultStatusEnum\"}},{\"name\":\"checkStatus\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Monitors by system status\",\"schema\":{\"$ref\":\"#/components/schemas/CheckStatusEnum\"}},{\"name\":\"type\",\"required\":false,\"in\":\"query\",\"description\":\"Filter Monitors by check type (associated monitor instances)\",\"schema\":{\"$ref\":\"#/components/schemas/CheckTypeEnum\"}},{\"name\":\"testSource\",\"required\":false,\"in\":\"query\",\"description\":\"Filter monitors by test source type (DRATA for built-in tests, CUSTOM for user-created tests, ACORN for compliance-as-code tests, EXTERNAL for external tests, DRATA_LIBRARY for Drata library tests)\",\"schema\":{\"$ref\":\"#/components/schemas/TestSourceEnum\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/MonitoringTestsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Monitoring Tests\",\"tags\":[\"Monitoring Tests\"],\"x-drata-permissions\":[\"monitors-get\"],\"x-product-area\":[\"MONITOR_TEST_DETAILS_UI\"]}},\"/workspaces/{workspaceId}/monitoring-tests/{testId}\":{\"get\":{\"description\":\"Get a specific Monitoring Test by Test ID\\n\\n🔒 Requires **Monitoring: Get Monitor** permission.\",\"operationId\":\"MonitorsPublicV2Controller_getMonitor\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"testId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/MonitorExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/MonitoringTestResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Monitoring Test\",\"tags\":[\"Monitoring Tests\"],\"x-drata-permissions\":[\"monitors-get-monitor\"],\"x-product-area\":[\"MONITOR_TEST_DETAILS_UI\"]}},\"/workspaces/{workspaceId}/monitoring-tests/{testId}/exclusions\":{\"get\":{\"description\":\"Find Monitor Exclusions for a specific Monitoring Test\\n\\n🔒 Requires **Monitoring: Get Monitor** permission.\",\"operationId\":\"MonitorsPublicV2Controller_listMonitorExclusions\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"testId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/MonitorExclusionExpandEnum\"}}},{\"name\":\"targetId\",\"required\":false,\"in\":\"query\",\"description\":\"Filter exclusions by target resource ID\",\"schema\":{\"maxLength\":30000,\"example\":\"sg-0a1b2c3d4e5f67890\",\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/MonitorExclusionsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Monitoring Test Exclusions\",\"tags\":[\"Monitoring Tests\"],\"x-drata-permissions\":[\"monitors-get-monitor\"],\"x-product-area\":[\"MONITOR_TEST_DETAILS_UI\"]}},\"/workspaces/{workspaceId}/monitoring-tests/{testId}/failures\":{\"get\":{\"description\":\"Find Monitoring Test Failures for a specific Monitoring Test. By default, excludes failures that have been manually excluded unless includeExclusions is set to true.\\n\\n🔒 Requires **Monitoring: Get Monitor** permission.\",\"operationId\":\"MonitorsPublicV2Controller_listMonitorTestFailures\",\"parameters\":[{\"name\":\"workspaceId\",\"required\":true,\"in\":\"path\",\"description\":\"The Workspace ID associated to the Account\",\"schema\":{\"type\":\"number\"}},{\"name\":\"testId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"includeExclusions\",\"required\":false,\"in\":\"query\",\"description\":\"Include excluded Monitor Test failures in the results\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/MonitorTestFailuresResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Monitoring Test Failures\",\"tags\":[\"Monitoring Tests\"],\"x-drata-permissions\":[\"monitors-get-monitor\"],\"x-product-area\":[\"MONITOR_TEST_DETAILS_UI\"]}},\"/vendors/{vendorId}/documents\":{\"get\":{\"description\":\"Get a list of Documents for a given Vendor.\\n\\n🔒 Requires **Vendors: List Vendors** permission.\",\"operationId\":\"VendorDocumentsPublicV2Controller_getVendorDocuments\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"type\",\"required\":false,\"in\":\"query\",\"description\":\"Vendor Document type\",\"schema\":{\"$ref\":\"#/components/schemas/VendorDocumentTypeEnum\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorDocumentExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorDocumentsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Vendor Documents\",\"tags\":[\"Vendor Documents\"],\"x-drata-permissions\":[\"vendors-get\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]},\"post\":{\"description\":\"Upload a Vendor Document.\\n\\n🔒 Requires **Vendors: Upload Vendor Report** permission.\",\"operationId\":\"VendorDocumentsPublicV2Controller_uploadVendorDocument\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"multipart/form-data\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorDocumentCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorDocumentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"413\":{\"description\":\"The file was too large to upload\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Upload Vendor Document\",\"tags\":[\"Vendor Documents\"],\"x-drata-permissions\":[\"vendors-post-document\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors/{vendorId}/documents/{documentId}\":{\"get\":{\"operationId\":\"VendorDocumentsPublicV2Controller_getVendorDocument\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"documentId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorDocumentResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Vendor Document\",\"tags\":[\"Vendor Documents\"],\"x-drata-permissions\":[\"vendors-get-vendor\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"],\"description\":\"🔒 Requires **Vendors: Get Vendor** permission.\"}},\"/vendors/{vendorId}/security-reviews\":{\"post\":{\"description\":\"Create a new Security Review for a given Vendor.\\n\\n🔒 Requires **Vendors: Create Security Review** permission.\",\"operationId\":\"VendorSecurityReviewsPublicV2Controller_createVendorSecurityReview\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Vendor Security Review\",\"tags\":[\"Vendor Security Reviews\"],\"x-drata-permissions\":[\"vendors-post-security-review\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors/{vendorId}/security-reviews/with-file\":{\"post\":{\"description\":\"Create a new Security Review for a given Vendor with file upload in a single atomic operation.\\n\\n🔒 Requires **Vendors: Create Security Review** permission.\",\"operationId\":\"VendorSecurityReviewsPublicV2Controller_createVendorSecurityReviewWithFile\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewWithFileCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Vendor Security Review with File\",\"tags\":[\"Vendor Security Reviews\"],\"x-drata-permissions\":[\"vendors-post-security-review\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors/{vendorId}/security-reviews/{securityReviewId}\":{\"get\":{\"description\":\"Get a specific Security Review for a given Vendor.\\n\\n🔒 Requires **Vendors: List Vendors** permission.\",\"operationId\":\"VendorSecurityReviewsPublicV2Controller_getVendorSecurityReview\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"securityReviewId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Vendor Security Review\",\"tags\":[\"Vendor Security Reviews\"],\"x-drata-permissions\":[\"vendors-get\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors/{vendorId}/security-questionnaires\":{\"post\":{\"operationId\":\"VendorSecurityReviewsPublicV2Controller_sendSecurityQuestionnaire\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"multipart/form-data\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewQuestionnaireCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityQuestionnaireResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Upload Security Questionnaire\",\"tags\":[\"Vendor Security Reviews\"],\"x-drata-permissions\":[\"vendors-post-upload-questionnaires\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"],\"description\":\"🔒 Requires **Vendors: Upload Security Questionnaire** permission.\"}},\"/vendors/{vendorId}/security-reviews/{securityReviewId}/security-questionnaires\":{\"post\":{\"description\":\"Upload a Security Questionnaire to a Vendor for a specific Security Review.\\n\\n🔒 Requires **Vendors: Upload Security Questionnaire** permission.\",\"operationId\":\"VendorSecurityReviewsPublicV2Controller_sendSecurityQuestionnaireForSecurityReview\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"securityReviewId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"multipart/form-data\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewQuestionnaireCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorSecurityQuestionnaireResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Upload Security Questionnaire\",\"tags\":[\"Vendor Security Reviews\"],\"x-drata-permissions\":[\"vendors-post-upload-questionnaires\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendor-types\":{\"get\":{\"description\":\"List all Vendor Types configured for your account.\\n\\n🔒 Requires **Vendors: List Vendor Types** permission.\",\"operationId\":\"VendorTypesPublicV2Controller_listVendorTypes\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorTypesResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Vendor Types\",\"tags\":[\"Vendor Types\"],\"x-drata-permissions\":[\"vendor-types-get\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]},\"post\":{\"description\":\"Create a new vendor type.\\n\\n🔒 Requires **Vendors: Create Vendor Type** permission.\",\"operationId\":\"VendorTypesPublicV2Controller_createVendorType\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorTypeCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorTypeResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Vendor Type\",\"tags\":[\"Vendor Types\"],\"x-drata-permissions\":[\"vendor-types-post\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendor-types/{vendorTypeId}\":{\"put\":{\"description\":\"Update an existing Vendor Type.\\n\\n🔒 Requires **Vendors: Update Vendor Type** permission.\",\"operationId\":\"VendorTypesPublicV2Controller_updateVendorType\",\"parameters\":[{\"name\":\"vendorTypeId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorTypeModifyRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorTypeResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"409\":{\"description\":\"There is a conflict in the business rules with this request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Vendor Type\",\"tags\":[\"Vendor Types\"],\"x-drata-permissions\":[\"vendor-types-put\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]},\"delete\":{\"description\":\"Soft delete a Vendor Type.\\n\\n🔒 Requires **Vendors: Delete Vendor Type** permission.\",\"operationId\":\"VendorTypesPublicV2Controller_deleteVendorType\",\"parameters\":[{\"name\":\"vendorTypeId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Delete Vendor Type\",\"tags\":[\"Vendor Types\"],\"x-drata-permissions\":[\"vendor-types-delete\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors\":{\"get\":{\"description\":\"Find Vendors matching the provided filters.\\n\\n🔒 Requires **Vendors: List Vendors** permission.\",\"operationId\":\"VendorsPublicV2Controller_listVendors\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"category\",\"required\":false,\"in\":\"query\",\"description\":\"The category of the  Vendors\",\"schema\":{\"$ref\":\"#/components/schemas/VendorCategoryEnum\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorExpandEnum\"}}},{\"name\":\"impactLevel\",\"required\":false,\"in\":\"query\",\"description\":\"Overall Vendor impact level\",\"schema\":{\"$ref\":\"#/components/schemas/VendorImpactLevelEnum\"}},{\"name\":\"renewalDate\",\"required\":false,\"in\":\"query\",\"description\":\"Vendor renewal date\",\"schema\":{\"format\":\"date\",\"example\":\"2020-07-06\",\"type\":\"string\"}},{\"name\":\"renewalScheduleType\",\"required\":false,\"in\":\"query\",\"description\":\"Vendor renewal schedule type\",\"schema\":{\"$ref\":\"#/components/schemas/RenewalScheduleTypeEnum\"}},{\"name\":\"risk\",\"required\":false,\"in\":\"query\",\"description\":\"Filter data to Vendors of this risk level\",\"schema\":{\"$ref\":\"#/components/schemas/VendorRiskEnum\"}},{\"name\":\"status\",\"required\":false,\"in\":\"query\",\"description\":\"The status of the Vendors\",\"schema\":{\"$ref\":\"#/components/schemas/VendorStatusEnum\"}},{\"name\":\"type\",\"required\":false,\"in\":\"query\",\"description\":\"Vendor type\",\"schema\":{\"$ref\":\"#/components/schemas/VendorTypeEnum\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Vendors\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-get\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]},\"post\":{\"description\":\"Create a new Vendor\\n\\n🔒 Requires **Vendors: Create Vendor** permission.\",\"operationId\":\"VendorsPublicV2Controller_createVendor\",\"parameters\":[],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Create Vendor\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-post\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors-stats\":{\"get\":{\"description\":\"Retrieve vendor statistics for specified scopes. At least one expand parameter is required. By default, archived vendors are excluded unless includeArchived is set to true.\\n\\n🔒 Requires **Vendors: Get Vendors Statistics** permission.\",\"operationId\":\"VendorsPublicV2Controller_getVendorStats\",\"parameters\":[{\"name\":\"expand[]\",\"required\":true,\"in\":\"query\",\"description\":\"List of stat scopes to include. At least one scope is required.\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorStatsExpandEnum\"}}},{\"name\":\"includeArchived\",\"required\":false,\"in\":\"query\",\"description\":\"Whether to include archived vendors in statistics. Defaults to false (excludes archived vendors).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorStatsResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Vendor Statistics\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-get-stats\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors/{vendorId}\":{\"get\":{\"operationId\":\"VendorsPublicV2Controller_getVendor\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Vendor\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-get-vendor\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"],\"description\":\"🔒 Requires **Vendors: Get Vendor** permission.\"},\"put\":{\"description\":\"Update Vendor details\\n\\n🔒 Requires **Vendors: Update Vendor** permission.\",\"operationId\":\"VendorsPublicV2Controller_updateVendor\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorModifyRequestPublicV2Dto\"}}}},\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Update Vendor\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-put\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]},\"delete\":{\"operationId\":\"VendorsPublicV2Controller_deleteVendor\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"204\":{\"description\":\"No Content\"},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Remove Vendor\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-delete\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"],\"description\":\"🔒 Requires **Vendors: Delete Vendor** permission.\"}},\"/vendors/{vendorId}/questionnaires\":{\"get\":{\"description\":\"Get Questionnaires sent to a Vendor.\\n\\n🔒 Requires **Vendors: List Vendor Questionnaire** permission.\",\"operationId\":\"VendorsPublicV2Controller_listVendorQuestionnaires\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorQuestionnairesResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Vendor Questionnaires\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-get-questionnaires\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]},\"post\":{\"description\":\"Send a Questionnaire to a Vendor by email.\\n\\n🔒 Requires **Vendors: Send Questionnaire to Vendor** permission.\",\"operationId\":\"VendorsPublicV2Controller_sendQuestionnaireToVendor\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorQuestionnaireCreateRequestPublicV2Dto\"}}}},\"responses\":{\"201\":{\"description\":\"Created\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorQuestionnaireSentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Send Questionnaire to Vendor\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-post-questionnaires\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/vendors/{vendorId}/questionnaires/{questionnaireId}\":{\"get\":{\"description\":\"Get a specific Questionnaire sent to a Vendor.\\n\\n🔒 Requires **Vendors: List Vendor Questionnaire** permission.\",\"operationId\":\"VendorsPublicV2Controller_getVendorQuestionnaire\",\"parameters\":[{\"name\":\"vendorId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}},{\"name\":\"questionnaireId\",\"required\":true,\"in\":\"path\",\"schema\":{\"type\":\"number\"}}],\"responses\":{\"200\":{\"description\":\"\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/VendorQuestionnaireSentResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\":\"Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"Get Vendor Questionnaire\",\"tags\":[\"Vendors\"],\"x-drata-permissions\":[\"vendors-get-questionnaires\"],\"x-product-area\":[\"VENDOR_PUBLIC_API\"]}},\"/workspaces\":{\"get\":{\"operationId\":\"WorkspacesPublicV2Controller_listWorkspaces\",\"parameters\":[{\"name\":\"cursor\",\"required\":false,\"in\":\"query\",\"description\":\"This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a `pagination.cursor` value that can be used in the subsequent request to retrieve the next page of results\",\"schema\":{\"type\":\"string\"}},{\"name\":\"size\",\"required\":false,\"in\":\"query\",\"description\":\"Number of results to return\",\"schema\":{\"minimum\":1,\"maximum\":500,\"default\":50,\"type\":\"number\"}},{\"name\":\"sort\",\"required\":false,\"in\":\"query\",\"description\":\"Which field to sort by\",\"schema\":{\"$ref\":\"#/components/schemas/SortTypeLimitedEnum\"}},{\"name\":\"sortDir\",\"required\":false,\"in\":\"query\",\"description\":\"The direction to sort the data\",\"schema\":{\"$ref\":\"#/components/schemas/SortDirectionEnum\"}},{\"name\":\"includeTotalCount\",\"required\":false,\"in\":\"query\",\"description\":\"Include total count of all matching records in response. Only honored on first page (when cursor is null).\",\"schema\":{\"default\":false,\"example\":false,\"type\":\"boolean\"}},{\"name\":\"expand[]\",\"required\":false,\"in\":\"query\",\"description\":\"List of subcollections and sub-objects to expand\",\"schema\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/WorkspaceExpandEnum\"}}}],\"responses\":{\"200\":{\"description\":\"Successful\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/WorkspacesResponsePublicV2Dto\"}}}},\"400\":{\"description\":\"Malformed data and/or validation errors\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponsePublicV2Dto\"}}}},\"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\"}}}},\"412\":{\"description\":\"You must accept the Drata terms and conditions to use the API\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ExceptionResponseDto\"}}}}},\"security\":[{\"bearer\":[]}],\"summary\":\"List Workspaces\",\"tags\":[\"Workspaces\"],\"x-drata-permissions\":[\"workspaces-get\"],\"x-product-area\":[\"WORKSPACE_PLATFORM\"],\"description\":\"🔒 Requires **Workspaces: List Workspaces** permission.\"}}},\"components\":{\"securitySchemes\":{\"bearer\":{\"scheme\":\"bearer\",\"bearerFormat\":\"API_KEY\",\"type\":\"http\"}},\"schemas\":{\"WorkspacesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/WorkspaceResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"PaginationTotalCountResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"cursor\":{\"type\":\"string\",\"nullable\":true,\"description\":\"When this is not null, it indicates there is additional data. Pass this value in to the `cursor` parameter to fetch the next page of data.\"},\"totalCount\":{\"type\":\"number\",\"nullable\":true,\"description\":\"Total count of all matching items (not limited by page size). Only included when `includeTotalCount=true` is passed on the first page (no cursor).\"}},\"required\":[\"cursor\"]},\"WorkspaceResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Workspace ID\"},\"primary\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Primary Workspace\"},\"name\":{\"type\":\"string\",\"example\":\"Drata Automation\",\"description\":\"Workspace name\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Drata automates SOC 2 compliance\",\"description\":\"Workspace description\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Workspace created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Workspace last updated at\"},\"howItWorks\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Connect your systems to the Drata Autopilot system and sit back and relax!\",\"description\":\"How does the Product Work?\"},\"url\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://drata.com\",\"description\":\"Workspace URL\"},\"logo\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://cdn-prod.imgpilot.com/logo.png\",\"description\":\"Workspace Logo URL\"},\"frameworks\":{\"description\":\"Frameworks associated with the Workspace, only returned when `expand[]=frameworks` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/FrameworkCompactResponsePublicV2Dto\"}}},\"required\":[\"id\",\"primary\",\"name\",\"description\",\"createdAt\",\"updatedAt\",\"howItWorks\",\"url\",\"logo\"]},\"FrameworkCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":13,\"description\":\"Framework ID\"},\"name\":{\"type\":\"string\",\"example\":\"NIST AI RMF\",\"description\":\"Framework name\"},\"description\":{\"type\":\"string\",\"example\":\"The NIST AI Risk Management Framework (AI RMF) is a set of suggestions and guidelines for incorporating trustworthiness considerations in the design, development, deployment, and use of AI systems.\",\"description\":\"Framework description\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Framework created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Framework updated date timestamp\"},\"enabledAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the framework was enabled\"}},\"required\":[\"id\",\"name\",\"description\",\"createdAt\",\"updatedAt\",\"enabledAt\"]},\"WorkspaceExpandEnum\":{\"type\":\"string\",\"enum\":[\"frameworks\"]},\"VendorQuestionnaireSentResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Questionnaire ID\"},\"title\":{\"type\":\"string\",\"example\":\"Vendor Security Questionnaire\",\"description\":\"Questionnaire title\"},\"recipientEmail\":{\"type\":\"string\",\"example\":\"wc@example.com\",\"description\":\"The email address that received the Questionnaire\"},\"isCompleted\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Whether the Questionnaire has been completed\"},\"completedBy\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Acme\",\"description\":\"Who answered the Questionnaire\"},\"responseId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"The Questionnaire response ID for the Questionnaire data file\"},\"dateSent\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Questionnaire was sent\"},\"isManualUpload\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Whether the questionnaire was manually uploaded\"}},\"required\":[\"id\",\"recipientEmail\",\"isCompleted\",\"dateSent\",\"isManualUpload\"]},\"VendorQuestionnaireCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"email\":{\"type\":\"string\",\"maxLength\":191,\"format\":\"email\",\"example\":\"vendor@example.com\",\"description\":\"The email address to receive the Questionnaire\"},\"questionnaireId\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor Questionnaire ID\"},\"emailSubject\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The email subject for the vendor questionnaire\",\"example\":\"Drata is conducting a security review of you.\"},\"emailContent\":{\"type\":\"string\",\"maxLength\":30000,\"description\":\"The email content for the Vendor\",\"example\":\"Hi,\\n\\nWe'd like to conduct a security review and would like some information from you. Use this link to complete the questionnaire.\\n\\nThank you.\"},\"securityReviewId\":{\"type\":\"number\",\"example\":1,\"description\":\"Security Review ID to associate the Questionnaire with. When provided, the sent Questionnaire will be linked to the specified security review as a document of type QUESTIONNAIRE.\"}},\"required\":[\"email\",\"questionnaireId\",\"emailContent\",\"securityReviewId\"]},\"VendorQuestionnairesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorQuestionnaireSentResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"VendorModifyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Acme\",\"description\":\"The name of the Vendor\"},\"hasPii\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates whether this Vendor stores any type of Personally Identifiable Information (PII)\"},\"passwordRequiresNumber\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates whether a password requires numbers\"},\"passwordRequiresSymbol\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates whether a password requires non-alpha-numeric characters\"},\"passwordMfaEnabled\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates whether multi-factor authentication is enabled for this Vendor\"},\"passwordRequiresMinLength\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates whether there is a minimum length requirement for password\"},\"isSubProcessor\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Indicates whether this Vendor is considered a subprocessor\"},\"isSubProcessorActive\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Indicates whether this subprocessor is active\"},\"category\":{\"nullable\":true,\"example\":\"ENGINEERING\",\"description\":\"The type of Vendor\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorCategoryEnum\"}]},\"risk\":{\"example\":\"MODERATE\",\"description\":\"The level of risk associated with customer data\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorRiskEnum\"}]},\"status\":{\"nullable\":true,\"example\":\"UNDER_REVIEW\",\"description\":\"The status of Vendor\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorStatusEnum\"}]},\"critical\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"Indicates if the Vendor is considered critical\"},\"userId\":{\"type\":\"number\",\"nullable\":true,\"maximum\":1000000000,\"example\":1,\"description\":\"The user ID of the person responsible for Vendor compliance\"},\"url\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://acme.com\",\"description\":\"Vendor URL\"},\"privacyUrl\":{\"type\":\"string\",\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://acme.com/privacy\",\"description\":\"Vendor Privacy Policy URL\"},\"termsUrl\":{\"type\":\"string\",\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://acme.com/terms\",\"description\":\"Vendor Terms of Use URL\"},\"servicesProvided\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"Perform security scans once a month\",\"description\":\"Description of the services provided by the Vendor\"},\"dataStored\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"resulting reports of security scans\",\"description\":\"Description of the type of data the Vendor stores\"},\"location\":{\"type\":\"string\",\"maxLength\":30000,\"example\":\"San Diego\",\"description\":\"Location where the Vendor services are provided\"},\"passwordPolicy\":{\"nullable\":true,\"example\":\"USERNAME_PASSWORD\",\"description\":\"The Vendor password policy\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorPasswordPolicyEnum\"}]},\"passwordMinLength\":{\"type\":\"number\",\"nullable\":true,\"minimum\":6,\"maximum\":12,\"example\":8,\"description\":\"Minimum character length required for a password\"},\"contactAtVendor\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"John Doe\",\"description\":\"Name of the corresponding account manager for this Vendor\"},\"contactsEmail\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"format\":\"email\",\"example\":\"jdoe@company.com\",\"description\":\"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\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor renewal date\"},\"renewalScheduleType\":{\"nullable\":true,\"example\":\"ONE_YEAR\",\"description\":\"Vendor renewal schedule type\",\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalScheduleTypeEnum\"}]},\"confirmed\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Indicate if all Vendor data is confirmed\"},\"type\":{\"nullable\":true,\"example\":\"VENDOR\",\"description\":\"Vendor type identifier\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorTypeEnum\"}]},\"accountId\":{\"type\":\"string\",\"maxLength\":36,\"example\":36,\"description\":\"Account Id\"},\"operationalImpact\":{\"nullable\":true,\"example\":\"IMPORTANT\",\"description\":\"Vendor level of operational impact\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorOperationalImpactEnum\"}]},\"environmentAccess\":{\"nullable\":true,\"example\":\"READ_ONLY\",\"description\":\"Vendor environment access privileges\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorEnvironmentAccessEnum\"}]},\"impactLevel\":{\"nullable\":true,\"example\":\"INSIGNIFICANT\",\"description\":\"Vendor overall impact level\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorImpactLevelEnum\"}]},\"dataAccessedOrProcessedList\":{\"nullable\":true,\"uniqueItems\":true,\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorDataAccessedOrProcessedEnum\"},\"example\":[\"FINANCIAL\",\"GENERAL\"],\"description\":\"List of data accessed or processed enum type\"},\"integrations\":{\"uniqueItems\":true,\"example\":[1,2,3],\"description\":\"List of vendor IDs\",\"type\":\"array\",\"items\":{\"type\":\"number\"}},\"cost\":{\"type\":\"string\",\"nullable\":true,\"example\":\"1088\",\"description\":\"Annual Contract Value for the Vendor in cents unit\"},\"customFields\":{\"description\":\"Custom Fields for the Vendor. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}}},\"CustomFieldSubmitRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"The ID of the Custom Field. Either this or the name must be provided.\"},\"name\":{\"type\":\"string\",\"example\":\"Compliance Status\",\"description\":\"The name of the Custom Field. Either this or the ID must be provided.\"},\"value\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Security & IT\",\"description\":\"The value of the Custom Field.  If a value of null is used, the value will be deleted.\"}},\"required\":[\"value\"]},\"VendorDataAccessedOrProcessedEnum\":{\"type\":\"string\",\"enum\":[\"GENERAL\",\"PUBLIC\",\"CONTROLLED_UNCLASSIFIED\",\"FINANCIAL\",\"PROPRIETARY\",\"EMPLOYEE_PERSONNEL\",\"PERSONAL_IDENTIFIABLE_INFORMATION\",\"PROTECTED_HEALTH_INFORMATION\",\"OTHER_PERSONAL_OR_SENSITIVE\",\"CARDHOLDER_DATA\"]},\"VendorEnvironmentAccessEnum\":{\"type\":\"string\",\"enum\":[\"NO\",\"READ_ONLY\",\"READ_WRITE\"]},\"VendorOperationalImpactEnum\":{\"type\":\"string\",\"enum\":[\"NONE\",\"LOW\",\"NORMAL\",\"IMPORTANT\",\"CRITICAL\"]},\"VendorPasswordPolicyEnum\":{\"type\":\"string\",\"enum\":[\"USERNAME_PASSWORD\",\"SSO\",\"LDAP\",\"NONE\",\"NOT_APPLICABLE\",\"SCIM\",\"OTHER\"]},\"VendorStatsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"reminder\":{\"example\":[{\"key\":\"RENEWAL_DUE\",\"count\":1},{\"key\":\"RENEWAL_DUE_SOON\",\"count\":1}],\"description\":\"Renewal reminder statistics for active vendors. Shows distribution of vendors by renewal status (due soon, overdue, etc.). Only returned when expand[]=reminder is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorReminderStatsItemPublicV2Dto\"}},\"hasPii\":{\"example\":[{\"key\":true,\"count\":1},{\"key\":false,\"count\":1}],\"description\":\"PII (Personally Identifiable Information) statistics. Shows how many vendors contain PII, which is important for data privacy compliance. Only returned when expand[]=hasPii is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorHasPiiStatsItemPublicV2Dto\"}},\"businessUnits\":{\"example\":[{\"key\":\"ENGINEERING\",\"count\":118},{\"key\":\"PRODUCT\",\"count\":2}],\"description\":\"Business unit/department distribution statistics. Shows which teams or departments use which vendors. Includes percentage of total for easy analysis. Only returned when expand[]=businessUnits is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorBusinessUnitStatsItemPublicV2Dto\"}},\"passwordPolicy\":{\"example\":[{\"key\":\"USERNAME_PASSWORD\",\"count\":118},{\"key\":\"SSO\",\"count\":32}],\"description\":\"Authentication method statistics. Shows how many vendors use SSO vs traditional passwords. SSO adoption percentage helps track security posture improvements. Only returned when expand[]=passwordPolicy is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorPasswordPolicyStatsItemPublicV2Dto\"}},\"status\":{\"example\":[{\"key\":\"ACTIVE\",\"count\":118},{\"key\":\"UNDER_REVIEW\",\"count\":20}],\"description\":\"Vendor status distribution statistics. Shows lifecycle stage of vendors (active, archived, under review, etc.). Percentages help identify status trends. Only returned when expand[]=status is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorStatusStatsItemPublicV2Dto\"}},\"isCritical\":{\"example\":[{\"key\":\"Yes\",\"count\":10},{\"key\":\"No\",\"count\":20}],\"description\":\"Vendor criticality statistics. Shows how many vendors are mission-critical to business operations. Critical vendors require enhanced monitoring and SLAs. Only returned when expand[]=isCritical is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorIsCriticalStatsItemPublicV2Dto\"}},\"isSubProcessor\":{\"example\":[{\"key\":true,\"count\":10},{\"key\":false,\"count\":20}],\"description\":\"Sub-processor statistics. Shows how many vendors process data on your behalf, which is critical for GDPR/CCPA compliance. Sub-processors require DPAs and additional documentation. Only returned when expand[]=isSubProcessor is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorIsSubProcessorStatsItemPublicV2Dto\"}},\"type\":{\"example\":[{\"key\":\"CONTRACTOR\",\"count\":15},{\"key\":\"VENDOR\",\"count\":45}],\"description\":\"Vendor type classification statistics. Shows distribution across vendor, supplier, contractor, partner categories. Helps with vendor segmentation and management strategies. Only returned when expand[]=type is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorTypeStatsItemPublicV2Dto\"}},\"risk\":{\"example\":[{\"key\":\"HIGH\",\"count\":15},{\"key\":\"MODERATE\",\"count\":50},{\"key\":\"LOW\",\"count\":45},{\"key\":\"NONE\",\"count\":10}],\"description\":\"Vendor risk level distribution statistics. Shows security and compliance risk assessment across all vendors. Use percentages to track risk reduction over time. Only returned when expand[]=risk is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorRiskStatsItemPublicV2Dto\"}},\"impactLevel\":{\"example\":[{\"key\":\"CRITICAL\",\"count\":7},{\"key\":\"MAJOR\",\"count\":12},{\"key\":\"UNSCORED\",\"count\":0}],\"description\":\"Business impact level statistics. Shows potential business disruption if vendors become unavailable. Critical/Major vendors need business continuity plans. Only returned when expand[]=impactLevel is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorImpactLevelStatsItemPublicV2Dto\"}}}},\"VendorImpactLevelStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"CRITICAL\",\"description\":\"Business impact level if vendor service is disrupted. Use this to prioritize business continuity planning and vendor relationship management.\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorImpactLevelForStatsEnum\"}]}},\"required\":[\"count\",\"key\"]},\"VendorImpactLevelForStatsEnum\":{\"type\":\"string\",\"enum\":[\"INSIGNIFICANT\",\"MINOR\",\"MODERATE\",\"MAJOR\",\"CRITICAL\",\"UNSCORED\"]},\"VendorRiskStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"HIGH\",\"description\":\"Vendor risk level. Higher risk vendors typically require more frequent reviews and monitoring.\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorRiskEnum\"}]}},\"required\":[\"count\",\"key\"]},\"VendorTypeStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"VENDOR\",\"description\":\"Vendor classification type\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorTypeEnum\"}]}},\"required\":[\"count\",\"key\"]},\"VendorIsSubProcessorStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Whether vendors act as sub-processors (process data on behalf of your organization). Sub-processors require Data Processing Agreements (DPAs) and additional compliance documentation for GDPR, CCPA, and other privacy regulations.\"}},\"required\":[\"count\",\"key\"]},\"VendorIsCriticalStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"Yes\",\"description\":\"Whether vendors are classified as critical to business operations. Critical vendors typically require more rigorous SLAs, backup plans, and monitoring.\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorCriticalityEnum\"}]}},\"required\":[\"count\",\"key\"]},\"VendorCriticalityEnum\":{\"type\":\"string\",\"enum\":[\"Yes\",\"No\",\"None\"]},\"VendorStatusStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"ACTIVE\",\"description\":\"Vendor status category. Use this to track vendor lifecycle stages.\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorStatusEnum\"}]}},\"required\":[\"count\",\"key\"]},\"VendorPasswordPolicyStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"SSO\",\"description\":\"Authentication method used for vendor access. SSO is generally more secure and easier to manage.\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorPasswordPolicyEnum\"}]}},\"required\":[\"count\",\"key\"]},\"VendorBusinessUnitStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"ENGINEERING\",\"description\":\"Business unit or category. Helps track vendor usage and costs by department.\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorCategoryEnum\"}]}},\"required\":[\"count\",\"key\"]},\"VendorHasPiiStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Whether vendors in this category contain PII. Vendors with PII require additional data privacy controls and compliance measures.\"}},\"required\":[\"count\",\"key\"]},\"VendorReminderStatsItemPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"Number of vendors in this category\",\"example\":25,\"minimum\":0},\"key\":{\"example\":\"RENEWAL_DUE\",\"description\":\"Renewal reminder status. Use this to prioritize vendor renewals and avoid service interruptions.\",\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalDateStatusEnum\"}]}},\"required\":[\"count\",\"key\"]},\"RenewalDateStatusEnum\":{\"type\":\"string\",\"enum\":[\"NO_RENEWAL\",\"COMPLETED\",\"RENEWAL_DUE_SOON\",\"RENEWAL_DUE\"]},\"VendorStatsExpandEnum\":{\"type\":\"string\",\"enum\":[\"reminder\",\"hasPii\",\"businessUnits\",\"passwordPolicy\",\"status\",\"isCritical\",\"isSubProcessor\",\"type\",\"risk\",\"impactLevel\"]},\"VendorResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor ID\"},\"name\":{\"type\":\"string\",\"example\":\"Acme\",\"description\":\"The name of the Vendor\"},\"category\":{\"nullable\":true,\"example\":\"ENGINEERING\",\"description\":\"The business domain of the Vendor\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorCategoryEnum\"}]},\"risk\":{\"nullable\":true,\"example\":\"MODERATE\",\"description\":\"The Vendor risk type\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorRiskEnum\"}]},\"type\":{\"nullable\":true,\"example\":\"CONTRACTOR\",\"description\":\"The Vendor sub-type (Vendor, Contractor, Supplier, etc)\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorTypeEnum\"}]},\"critical\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"Indicates if the Vendor is considered critical\"},\"status\":{\"nullable\":true,\"example\":\"ACTIVE\",\"description\":\"The Vendor status\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorStatusEnum\"}]},\"location\":{\"type\":\"string\",\"nullable\":true,\"example\":\"USA\",\"description\":\"Vendor location\"},\"url\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://acme.com\",\"description\":\"Vendor URL\"},\"privacyUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"config.get('swagger.examples.url')/privacy\",\"description\":\"Vendor Privacy Policy URL\"},\"termsUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"config.get('swagger.examples.url')/terms-of-service\",\"description\":\"Vendor Terms of Use URL\"},\"trustCenterUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://trust.example.com\",\"description\":\"Vendor Trust Center URL\"},\"trustCenterProvider\":{\"nullable\":true,\"example\":\"DRATA\",\"description\":\"The providing service for this Trust Center\",\"allOf\":[{\"$ref\":\"#/components/schemas/TrustCenterProviderEnum\"}]},\"servicesProvided\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Perform security scans once a month\",\"description\":\"Description of Vendor services\"},\"dataStored\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Resulting reports of security scans\",\"description\":\"Type of data the Vendor stores\"},\"hasPii\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Does this Vendor store any type of PII\"},\"passwordPolicy\":{\"nullable\":true,\"example\":\"USERNAME_PASSWORD\",\"description\":\"The Vendor password policy\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorPasswordPolicyEnum\"}]},\"passwordRequiresMinLength\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if there is a minimum length for user passwords\"},\"passwordMinLength\":{\"type\":\"number\",\"nullable\":true,\"example\":8,\"description\":\"Minimum character length for a password\"},\"passwordRequiresNumber\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if a password requires numbers\"},\"passwordRequiresSymbol\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if a password requires non-alpha-numeric characters\"},\"passwordMfaEnabled\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Is multi-factor authentication enabled for this Vendor\"},\"contactAtVendor\":{\"type\":\"string\",\"nullable\":true,\"example\":\"John Doe\",\"description\":\"The name of the corresponding account manager for this Vendor\"},\"contactsEmail\":{\"type\":\"string\",\"nullable\":true,\"example\":\"jdoe@company.com\",\"description\":\"The email of the corresponding account manager for this Vendor\"},\"notes\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Meeting once a month to adjust contract\",\"description\":\"Additional notes for Vendor\"},\"logoUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://cdn-prod.imgpilot.com/logo.png\",\"description\":\"Vendor logo URL\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor created at date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor last updated at date timestamp\"},\"isSubProcessor\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Is this Vendor a sub-processor?\"},\"isSubProcessorActive\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Is this Vendor an active Sub-processor?\"},\"archivedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when the status of the Vendor changed\"},\"renewalDate\":{\"type\":\"string\",\"nullable\":true,\"example\":\"2020-07-06\",\"description\":\"Vendor renewal date\"},\"renewalScheduleType\":{\"nullable\":true,\"example\":\"ONE_YEAR\",\"description\":\"Vendor renewal schedule type\",\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalScheduleTypeEnum\"}]},\"renewalDateStatus\":{\"type\":\"string\",\"nullable\":true,\"example\":\"COMPLETED\",\"description\":\"Vendor renewal status based on the proximity to the renewal due date\"},\"confirmedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when the Vendor details were confirmed\"},\"sharedAccountId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"Shared account id\"},\"isDrataUser\":{\"type\":\"boolean\",\"description\":\"Is the Vendor an user of Drata\",\"example\":false,\"nullable\":true},\"events\":{\"type\":\"number\",\"nullable\":true,\"description\":\"The number of event notifications pending for the Vendor\",\"example\":4},\"integrations\":{\"nullable\":true,\"description\":\"Vendor integrations list\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorIntegrationResponsePublicDto\"}},\"cost\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Annual Contract Value for the Vendor in cents unit\",\"example\":\"1088\"},\"operationalImpact\":{\"nullable\":true,\"description\":\"Vendor level of operational impact\",\"example\":\"CRITICAL\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorOperationalImpactEnum\"}]},\"environmentAccess\":{\"nullable\":true,\"description\":\"Vendor environment access privileges\",\"example\":\"READ_ONLY\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorEnvironmentAccessEnum\"}]},\"impactLevel\":{\"nullable\":true,\"description\":\"Vendor overall impact level\",\"example\":\"INSIGNIFICANT\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorImpactLevelEnum\"}]},\"dataAccessedOrProcessedList\":{\"nullable\":true,\"description\":\"List of data accessed or processed\",\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"user\":{\"nullable\":true,\"description\":\"The User that is responsible for the compliance of this Vendor, only returned when `expand[]=user` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"documents\":{\"description\":\"A list of Vendor documents, only returned when `expand[]=documents` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorDocumentResponsePublicV2Dto\"}},\"lastQuestionnaire\":{\"nullable\":true,\"description\":\"The last questionnaire associated with the Vendor, only returned when `expand[]=lastQuestionnaire` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorQuestionnaireResponsePublicV2Dto\"}]},\"latestSecurityReviews\":{\"nullable\":true,\"description\":\"Latest Security Reviews, only returned when `expand[]=latestSecurityReviews` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorSecurityReviewCompactResponsePublicV2Dto\"}},\"vendorRelationshipContact\":{\"nullable\":true,\"description\":\"The Vendor relationship contact, only returned when `expand[]=vendorRelationshipContact` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"reviews\":{\"description\":\"Vendor Reviews, only returned when `expand[]=reviews` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorReviewResponsePublicDto\"}},\"customFields\":{\"description\":\"Custom Fields, only returned when `expand[]=customFields` is passed. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldResponsePublicV2Dto\"}}},\"required\":[\"id\",\"name\",\"category\",\"risk\",\"type\",\"critical\",\"status\",\"location\",\"url\",\"privacyUrl\",\"termsUrl\",\"trustCenterUrl\",\"trustCenterProvider\",\"servicesProvided\",\"dataStored\",\"hasPii\",\"passwordPolicy\",\"passwordRequiresMinLength\",\"passwordMinLength\",\"passwordRequiresNumber\",\"passwordRequiresSymbol\",\"passwordMfaEnabled\",\"contactAtVendor\",\"contactsEmail\",\"notes\",\"logoUrl\",\"createdAt\",\"updatedAt\",\"isSubProcessor\",\"isSubProcessorActive\",\"archivedAt\",\"renewalDate\",\"renewalScheduleType\",\"renewalDateStatus\",\"confirmedAt\",\"sharedAccountId\",\"isDrataUser\",\"events\",\"integrations\",\"cost\",\"operationalImpact\",\"environmentAccess\",\"impactLevel\",\"dataAccessedOrProcessedList\"]},\"CustomFieldResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"customFieldId\":{\"type\":\"number\",\"example\":1,\"description\":\"The ID of the Custom Field\"},\"name\":{\"type\":\"string\",\"example\":\"Stakeholders\",\"description\":\"The name of the Custom Field\"},\"value\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Security & IT\",\"description\":\"The value of the Custom Field\"}},\"required\":[\"customFieldId\",\"name\"]},\"VendorReviewResponsePublicDto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor Review ID\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Review last updated date\"},\"reviewer\":{\"type\":\"string\",\"nullable\":true,\"example\":\"John Doe\",\"description\":\"Reviewer name\"},\"reviewDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Review date\"},\"reportIssueDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Report issue date\"},\"socReport\":{\"type\":\"string\",\"nullable\":true,\"example\":\"SOC_1\",\"description\":\"SOC report type\",\"enum\":[\"SOC_1\",\"SOC_2\",\"SOC_3\"]},\"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\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Start date for SOC report type 1\"},\"socType1EndDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"End date for SOC report type 1\"},\"socType2StartDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Start date for SOC report type 2\"},\"socType2EndDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"End date for SOC report type 2\"},\"reportOpinion\":{\"type\":\"string\",\"nullable\":true,\"example\":\"UNQUALIFIED\",\"description\":\"Vendor report opinion\",\"enum\":[\"UNQUALIFIED\",\"QUALIFIED\",\"ADVERSE\",\"DISCLAIMER\"]},\"encompassBusinessNeeds\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Do control objectives or trust principles encompass business needs?\"},\"followUpActivity\":{\"type\":\"string\",\"nullable\":true,\"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\",\"nullable\":true,\"example\":\"CPA firm name\",\"description\":\"CPA firm that performed the audit\"},\"cpaProcedurePerformed\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The following procedures were performed...\",\"description\":\"Procedures Performed to Assess Reputation of CPA Firm\"},\"subserviceOrganization\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Subservice Inc.\",\"description\":\"Subservice Organizations In Report\"},\"subserviceOrganizationUsingInclusiveMethod\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Are Subservice Organizations Presented in the Report Using the Inclusive Method?\"},\"subserviceOrganizationProcedurePerformed\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The following procedures were performed...\",\"description\":\"Procedures Performed to Assess Subservice Organizations\"},\"trustServiceCategories\":{\"description\":\"Procedures Performed to Assess Subservice Organizations\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorReviewTrustServiceCategoryMapResponsePublicDto\"}},\"userControls\":{\"description\":\"Procedures Performed to Assess Subservice Organizations\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorReviewUserControlResponsePublicDto\"}},\"services\":{\"description\":\"Procedures Performed to Assess Subservice Organizations\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorReviewServiceResponsePublicDto\"}},\"locations\":{\"description\":\"Procedures Performed to Assess Subservice Organizations\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorReviewLocationResponsePublicDto\"}},\"findings\":{\"description\":\"Procedures Performed to Assess Subservice Organizations\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorReviewFindingResponsePublicDto\"}}},\"required\":[\"id\",\"updatedAt\",\"reviewer\",\"reviewDate\",\"reportIssueDate\",\"socReport\",\"socReportType1\",\"socReportType2\",\"socType1StartDate\",\"socType1EndDate\",\"socType2StartDate\",\"socType2EndDate\",\"reportOpinion\",\"encompassBusinessNeeds\",\"followUpActivity\",\"hasMaterialImpact\",\"cpaFirm\",\"cpaProcedurePerformed\",\"subserviceOrganization\",\"subserviceOrganizationUsingInclusiveMethod\",\"subserviceOrganizationProcedurePerformed\",\"trustServiceCategories\",\"userControls\",\"services\",\"locations\",\"findings\"]},\"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\"]},\"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\"]},\"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\"]},\"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\"]},\"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\"]},\"VendorSecurityReviewCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor Security Review ID\"},\"requestedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Requested date\"},\"reviewDeadlineAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Review deadline date\"},\"decision\":{\"nullable\":true,\"description\":\"The decision about the Security Review\",\"example\":\"APPROVED\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewDecisionEnum\"}]},\"note\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Vendor Security Review note\"},\"status\":{\"description\":\"The status for the Security Review\",\"example\":\"NOT_YET_STARTED\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewStatusEnum\"}]},\"type\":{\"description\":\"The type for the Security Review\",\"example\":\"SECURITY\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewTypeEnum\"}]}},\"required\":[\"id\",\"requestedAt\",\"reviewDeadlineAt\",\"decision\",\"note\",\"status\",\"type\"]},\"VendorSecurityReviewTypeEnum\":{\"type\":\"string\",\"enum\":[\"SECURITY\",\"SOC_REPORT\",\"UPLOAD_REPORT\"]},\"VendorSecurityReviewStatusEnum\":{\"type\":\"string\",\"enum\":[\"NOT_YET_STARTED\",\"IN_PROGRESS\",\"COMPLETED\",\"NOT_REQUIRED\"]},\"VendorSecurityReviewDecisionEnum\":{\"type\":\"string\",\"enum\":[\"PENDING\",\"APPROVED\",\"APPROVED_WITH_CONDITIONS\",\"REJECTED\"]},\"VendorQuestionnaireResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"vendorId\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor ID of the Questionnaire\"},\"sendAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Questionnaire was sent\"},\"sentEmail\":{\"type\":\"string\",\"example\":\"jdoe@company.com\",\"description\":\"The recipient email address of the Questionnaire\"},\"file\":{\"type\":\"string\",\"example\":\"questionnaire.pdf\",\"description\":\"The file name of the Questionnaire\"},\"respondedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date timestamp of the Questionnaire response\"},\"responseId\":{\"type\":\"number\",\"example\":1,\"description\":\"The response ID of the Questionnaire data file\"},\"isManualUpload\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if the Questionnaire was manually uploaded\"},\"completedBy\":{\"type\":\"string\",\"example\":\"Acme\",\"description\":\"Questionnaire respondent\"}},\"required\":[\"vendorId\",\"sendAt\",\"sentEmail\",\"file\",\"respondedAt\",\"responseId\",\"isManualUpload\",\"completedBy\"]},\"VendorIntegrationResponsePublicDto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor ID\"},\"name\":{\"type\":\"string\",\"example\":\"Acme\",\"description\":\"The name of a vendor\"}},\"required\":[\"id\",\"name\"]},\"TrustCenterProviderEnum\":{\"type\":\"string\",\"enum\":[\"ANECDOTES\",\"CONVEYOR\",\"DRATA\",\"HYPERCOMPLY\",\"SAFEBASE\",\"SCRUT\",\"SECUREFRAME\",\"SECURITYPAL\",\"SKYPHER\",\"SPRINTO\",\"TRUSTARC\",\"TRUSTCLOUD\",\"VANTA\",\"WHISTIC\",\"ZENGRC\"]},\"VendorCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Acme\",\"description\":\"The name of the Vendor\"},\"hasPii\":{\"type\":\"boolean\",\"default\":false,\"example\":true,\"description\":\"Indicates whether this Vendor stores any type of Personally Identifiable Information (PII)\"},\"passwordRequiresNumber\":{\"type\":\"boolean\",\"default\":false,\"example\":true,\"description\":\"Indicates whether a password requires numbers\"},\"passwordRequiresSymbol\":{\"type\":\"boolean\",\"default\":false,\"example\":true,\"description\":\"Indicates whether a password requires non-alpha-numeric characters\"},\"passwordMfaEnabled\":{\"type\":\"boolean\",\"default\":false,\"example\":true,\"description\":\"Indicates whether multi-factor authentication is enabled for this Vendor\"},\"passwordRequiresMinLength\":{\"type\":\"boolean\",\"default\":false,\"example\":true,\"description\":\"Indicates whether there is a minimum length requirement for password\"},\"isSubProcessor\":{\"type\":\"boolean\",\"default\":false,\"example\":false,\"description\":\"Indicates whether this Vendor is considered a subprocessor\"},\"isSubProcessorActive\":{\"type\":\"boolean\",\"default\":false,\"example\":false,\"description\":\"Indicates whether this subprocessor is active\"},\"category\":{\"nullable\":true,\"example\":\"ENGINEERING\",\"description\":\"The type of Vendor\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorCategoryEnum\"}]},\"risk\":{\"example\":\"MODERATE\",\"description\":\"The level of risk associated with customer data\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorRiskEnum\"}]},\"status\":{\"nullable\":true,\"example\":\"UNDER_REVIEW\",\"description\":\"The status of Vendor\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorStatusEnum\"}]},\"critical\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"Indicates if the Vendor is considered critical\"},\"userId\":{\"type\":\"number\",\"nullable\":true,\"maximum\":1000000000,\"example\":1,\"description\":\"The user ID of the person responsible for Vendor compliance\"},\"url\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://acme.com\",\"description\":\"Vendor URL\"},\"privacyUrl\":{\"type\":\"string\",\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://acme.com/privacy\",\"description\":\"Vendor Privacy Policy URL\"},\"termsUrl\":{\"type\":\"string\",\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://acme.com/terms\",\"description\":\"Vendor Terms of Use URL\"},\"servicesProvided\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"Perform security scans once a month\",\"description\":\"Description of the services provided by the Vendor\"},\"dataStored\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"resulting reports of security scans\",\"description\":\"Description of the type of data the Vendor stores\"},\"location\":{\"type\":\"string\",\"maxLength\":30000,\"example\":\"San Diego\",\"description\":\"Location where the Vendor services are provided\"},\"passwordPolicy\":{\"nullable\":true,\"example\":\"USERNAME_PASSWORD\",\"description\":\"The Vendor password policy\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorPasswordPolicyEnum\"}]},\"passwordMinLength\":{\"type\":\"number\",\"nullable\":true,\"minimum\":6,\"maximum\":12,\"example\":8,\"description\":\"Minimum character length required for a password\"},\"contactAtVendor\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"John Doe\",\"description\":\"Name of the corresponding account manager for this Vendor\"},\"contactEmail\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"format\":\"email\",\"example\":\"jdoe@company.com\",\"description\":\"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\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor renewal date\"},\"renewalScheduleType\":{\"nullable\":true,\"example\":\"ONE_YEAR\",\"description\":\"Vendor renewal schedule type\",\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalScheduleTypeEnum\"}]},\"confirmed\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Indicate if all Vendor data is confirmed\"},\"type\":{\"nullable\":true,\"example\":\"VENDOR\",\"description\":\"Vendor type identifier\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorTypeEnum\"}]},\"accountId\":{\"type\":\"string\",\"maxLength\":36,\"example\":36,\"description\":\"Account Id\"},\"operationalImpact\":{\"nullable\":true,\"example\":\"IMPORTANT\",\"description\":\"Vendor level of operational impact\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorOperationalImpactEnum\"}]},\"environmentAccess\":{\"nullable\":true,\"example\":\"READ_ONLY\",\"description\":\"Vendor environment access privileges\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorEnvironmentAccessEnum\"}]},\"impactLevel\":{\"nullable\":true,\"example\":\"INSIGNIFICANT\",\"description\":\"Vendor overall impact level\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorImpactLevelEnum\"}]},\"dataAccessedOrProcessedList\":{\"nullable\":true,\"uniqueItems\":true,\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorDataAccessedOrProcessedEnum\"},\"example\":[\"FINANCIAL\",\"GENERAL\"],\"description\":\"List of data accessed or processed enum type\"},\"integrations\":{\"uniqueItems\":true,\"example\":[1,2,3],\"description\":\"List of vendor IDs\",\"type\":\"array\",\"items\":{\"type\":\"number\"}},\"cost\":{\"type\":\"string\",\"nullable\":true,\"example\":\"1088\",\"description\":\"Annual Contract Value for the Vendor in Cents unit\"},\"customFields\":{\"description\":\"Custom Fields for the Vendor. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}},\"required\":[\"name\"]},\"VendorsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"VendorTypeEnum\":{\"type\":\"string\",\"enum\":[\"VENDOR\",\"SUPPLIER\",\"CONTRACTOR\",\"PARTNER\",\"OTHER\",\"NONE\"]},\"VendorStatusEnum\":{\"type\":\"string\",\"enum\":[\"PROSPECTIVE\",\"ACTIVE\",\"ARCHIVED\",\"APPROVED\",\"REJECTED\",\"FLAGGED\",\"ON_HOLD\",\"OFFBOARDED\",\"UNDER_REVIEW\",\"NONE\"]},\"VendorRiskEnum\":{\"type\":\"string\",\"enum\":[\"NONE\",\"LOW\",\"MODERATE\",\"HIGH\"]},\"RenewalScheduleTypeEnum\":{\"type\":\"string\",\"enum\":[\"ONE_MONTH\",\"TWO_MONTHS\",\"THREE_MONTHS\",\"SIX_MONTHS\",\"ONE_YEAR\",\"CUSTOM\",\"NONE\"]},\"VendorImpactLevelEnum\":{\"type\":\"string\",\"enum\":[\"INSIGNIFICANT\",\"MINOR\",\"MODERATE\",\"MAJOR\",\"CRITICAL\",\"UNSCORED\"]},\"VendorExpandEnum\":{\"type\":\"string\",\"enum\":[\"customFields\",\"documents\",\"integrations\",\"lastQuestionnaire\",\"latestSecurityReviews\",\"reviews\",\"vendorUser\",\"vendorRelationshipContact\",\"dataAccessedOrProcessed\",\"scheduleConfiguration\",\"customVendorType\"]},\"VendorCategoryEnum\":{\"type\":\"string\",\"enum\":[\"ENGINEERING\",\"PRODUCT\",\"MARKETING\",\"CS\",\"SALES\",\"FINANCE\",\"HR\",\"ADMINISTRATIVE\",\"SECURITY\",\"LEGAL\",\"INFORMATION_TECHNOLOGY\",\"NONE\"]},\"VendorTypeModifyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Cloud Service Provider\",\"description\":\"The name of the Vendor Type\"}},\"required\":[\"name\"]},\"VendorTypeResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor Type ID\"},\"name\":{\"type\":\"string\",\"example\":\"Cloud Provider\",\"description\":\"The name of the Vendor Type\"}},\"required\":[\"id\",\"name\"]},\"VendorTypeCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Cloud Provider\",\"description\":\"The name of the Vendor Type\"}},\"required\":[\"name\"]},\"VendorTypesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorTypeResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"VendorSecurityQuestionnaireResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Questionnaire ID\"},\"completedBy\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Acme\",\"description\":\"Who completed the Questionnaire, null if not completed\"},\"recipientEmail\":{\"type\":\"string\",\"maxLength\":191,\"format\":\"email\",\"example\":\"jdoe@company.com\",\"description\":\"The email address to receive the Questionnaire\"},\"isCompleted\":{\"type\":\"boolean\",\"example\":\"true\",\"description\":\"The status of the Questionnaire\"},\"dateSent\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Questionnaire was sent\"},\"isManualUpload\":{\"type\":\"boolean\",\"example\":\"true\",\"description\":\"Flag indicating whether the questionnaire was manually uploaded\"},\"responseId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"The Questionnaire response ID to the Questionnaire data file, null if not completed\"},\"title\":{\"type\":\"string\",\"example\":\"Vendor Security Questionnaire\",\"description\":\"Vendor Questionnaire title\"}},\"required\":[\"id\",\"completedBy\",\"recipientEmail\",\"isCompleted\",\"dateSent\",\"isManualUpload\",\"responseId\"]},\"VendorSecurityReviewQuestionnaireCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"files\":{\"description\":\"Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .csv\",\"type\":\"array\",\"items\":{\"type\":\"string\",\"format\":\"binary\"}}},\"required\":[\"files\"]},\"VendorSecurityReviewExpandEnum\":{\"type\":\"string\",\"enum\":[\"user\",\"requesterUser\"]},\"VendorSecurityReviewWithFileCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"maxLength\":255,\"example\":\"Q4 2024 Security Review\",\"description\":\"The title of the security review\"},\"reviewDeadlineAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor Security Review deadline date\",\"nullable\":false},\"requestedAt\":{\"type\":\"string\",\"example\":\"2024-01-01T00:00:00.000Z\",\"description\":\"The date when the security review was requested\"},\"securityReviewStatus\":{\"enum\":[\"NOT_YET_STARTED\",\"IN_PROGRESS\",\"COMPLETED\",\"NOT_REQUIRED\"],\"type\":\"string\",\"example\":3,\"description\":\"The status of the security review\"},\"securityReviewType\":{\"enum\":[\"SECURITY\",\"SOC_REPORT\",\"UPLOAD_REPORT\"],\"type\":\"string\",\"example\":1,\"description\":\"The type of security review\"},\"requesterUserId\":{\"type\":\"number\",\"example\":123,\"description\":\"The ID of the user requesting the security review\"},\"note\":{\"type\":\"string\",\"maxLength\":1000,\"example\":\"Additional notes about the security review\",\"description\":\"Optional notes for the security review\"},\"documentType\":{\"enum\":[\"COMPLIANCE_REPORT\",\"COMPLIANCE_REPORT_REVIEW\",\"BRIDGE_LETTER\",\"UPLOADED_COMPLIANCE_REPORT_REVIEW\",\"QUESTIONNAIRE_ATTACHMENT\",\"SOC_DOCUMENT\",\"QUESTIONNAIRE_REPORT\"],\"type\":\"string\",\"example\":1,\"description\":\"The type of document being uploaded\"},\"file\":{\"type\":\"string\",\"format\":\"binary\",\"description\":\"File to upload. Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .gif, .jpg, .jpeg, .png, .csv\"}},\"required\":[\"title\",\"reviewDeadlineAt\",\"securityReviewStatus\",\"securityReviewType\",\"file\"]},\"VendorSecurityReviewResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor Security Review ID\"},\"requestedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Requested date\"},\"reviewDeadlineAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Review deadline date\"},\"decision\":{\"nullable\":true,\"description\":\"The decision about the Security Review\",\"example\":\"APPROVED\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewDecisionEnum\"}]},\"note\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Vendor Security Review note\"},\"status\":{\"description\":\"The status for the Security Review\",\"example\":\"NOT_YET_STARTED\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewStatusEnum\"}]},\"type\":{\"description\":\"The type for the Security Review\",\"example\":\"SECURITY\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewTypeEnum\"}]},\"userId\":{\"type\":\"number\",\"nullable\":true,\"description\":\"The ID of the user assigned to conduct this Vendor Security Review\"},\"requesterUserId\":{\"type\":\"number\",\"nullable\":true,\"description\":\"The requester user ID\"},\"user\":{\"nullable\":true,\"description\":\"The Security Review Vendor user\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"requesterUser\":{\"nullable\":true,\"description\":\"The related Security Review requester user\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"requestedAt\",\"reviewDeadlineAt\",\"decision\",\"note\",\"status\",\"type\",\"userId\",\"requesterUserId\"]},\"VendorSecurityReviewCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"reviewDeadlineAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor Security Review deadline date\",\"nullable\":false},\"securityReviewStatus\":{\"example\":\"NOT_YET_STARTED\",\"description\":\"The status of the Security Review\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewStatusEnum\"}]},\"securityReviewType\":{\"example\":\"SECURITY\",\"description\":\"The type of the Security Review\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorSecurityReviewTypeEnum\"}]},\"requestedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor Security Review requested date\",\"nullable\":false},\"note\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":1000,\"example\":\"Security Review note\",\"description\":\"Vendor Security Review note\"},\"requesterUserId\":{\"type\":\"number\",\"maximum\":1000000000,\"example\":1,\"description\":\"The user ID of the person that requested the Security Review\",\"nullable\":true},\"title\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Security Review title\",\"description\":\"Vendor Security Review title\"}},\"required\":[\"reviewDeadlineAt\",\"securityReviewStatus\",\"securityReviewType\"]},\"VendorDocumentResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Vendor document ID\"},\"name\":{\"type\":\"string\",\"example\":\"AWS SOC 2 2025\",\"description\":\"The name the file\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor Document created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Vendor Document last updated at\"},\"type\":{\"description\":\"The type of the Vendor document\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorDocumentTypeEnum\"}]},\"downloadUrl\":{\"description\":\"The signed URL to download the Vendor document\",\"allOf\":[{\"$ref\":\"#/components/schemas/SignedUrlResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"name\",\"createdAt\",\"updatedAt\",\"type\"]},\"SignedUrlResponsePublicV2Dto\":{\"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\"},\"fileBuffer\":{\"type\":\"object\",\"nullable\":true,\"description\":\"The file on buffer format. This only applies for txt files.\",\"example\":{\"buffer\":\"RXhhbXBsZSB0ZXh0IGNvbnRlbnQ=\"}}},\"required\":[\"signedUrl\",\"fileBuffer\"]},\"VendorDocumentCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"file\":{\"type\":\"string\",\"format\":\"binary\",\"description\":\"Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .gif, .jpg, .jpeg, .png, .csv. MIME type must match the file extension\"},\"securityReviewId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"Security Review ID, when set this will attach the document to this security review\"},\"type\":{\"example\":\"COMPLIANCE_REPORT\",\"description\":\"Vendor Document type\",\"allOf\":[{\"$ref\":\"#/components/schemas/VendorDocumentTypeEnum\"}]}},\"required\":[\"file\"]},\"VendorDocumentsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Full list of Vendor Documents\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/VendorDocumentResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"VendorDocumentExpandEnum\":{\"type\":\"string\",\"enum\":[\"downloadUrl\"]},\"VendorDocumentTypeEnum\":{\"type\":\"string\",\"enum\":[\"COMPLIANCE_REPORT\",\"COMPLIANCE_REPORT_REVIEW\",\"BRIDGE_LETTER\",\"UPLOADED_COMPLIANCE_REPORT_REVIEW\",\"QUESTIONNAIRE_ATTACHMENT\",\"SOC_DOCUMENT\",\"QUESTIONNAIRE_REPORT\"]},\"MonitorTestFailuresResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/MonitorTestFailureResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"MonitorTestFailureResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"example\":\"sg-0a1b2c3d4e5f67890\",\"description\":\"Unique identifier of the cloud resource that failed the compliance test. This is typically the resource ID from the cloud provider (e.g., AWS resource ID, Azure resource ID, GCP resource name).\"},\"providerName\":{\"type\":\"string\",\"example\":\"Amazon Web Services\",\"description\":\"Human-readable name of the cloud provider where the failing resource is located. Common values include \\\"Amazon Web Services\\\", \\\"Microsoft Azure\\\", \\\"Google Cloud Platform\\\", etc.\"},\"resourceName\":{\"type\":\"string\",\"example\":\"sg-0a1b2c3d4e5f67890\",\"description\":\"The name or identifier of the specific cloud resource that failed the compliance test. This could be a security group name, S3 bucket name, virtual machine name, etc.\"},\"accountName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Production Account\",\"description\":\"Human-readable name of the cloud account or subscription where the failing resource is located. This helps identify which environment or business unit owns the resource.\"},\"clientId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"123456789012\",\"description\":\"Unique identifier for the cloud account, subscription, or project where the resource resides. This is typically the AWS Account ID, Azure Subscription ID, or GCP Project ID.\"},\"resourceArn\":{\"type\":\"string\",\"nullable\":true,\"example\":\"arn:aws:iam::259468815732:user/TestUser\",\"description\":\"Amazon Resource Name (ARN) or equivalent unique resource identifier from the cloud provider. This provides the full path to the resource within the cloud infrastructure hierarchy.\"},\"organizationalUnitId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"ou-root-123456789\",\"description\":\"Organizational Unit identifier, primarily used in AWS Organizations to group accounts by business unit or environment. For other providers, this may contain subscription IDs (Azure) or project hierarchy information (GCP), but is most commonly populated for AWS resources.\"},\"region\":{\"type\":\"string\",\"nullable\":true,\"example\":\"us-east-1\",\"description\":\"Geographic region or availability zone where the failing resource is deployed. Examples include AWS regions (us-east-1), Azure regions (East US), or GCP zones (us-central1-a).\"}},\"required\":[\"id\",\"providerName\",\"resourceName\",\"accountName\"]},\"MonitorExclusionsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/MonitorExclusionResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"MonitorExclusionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"The ID of the Monitor Exclusion\"},\"targetId\":{\"type\":\"string\",\"example\":\"sg-0a1b2c3d4e5f67890\",\"description\":\"The unique identifier of the excluded cloud resource. Examples: AWS Security Group (sg-12345), EC2 Instance (i-1234567890abcdef0), S3 Bucket (my-bucket-name), RDS Instance (my-database-instance), Load Balancer (my-load-balancer), Azure VM (vm-12345), GCP Instance (instance-12345)\"},\"targetName\":{\"type\":\"string\",\"example\":\"Production Security Group - Web Servers\",\"description\":\"The human-readable name or description of the excluded cloud resource. Examples: \\\"Production Security Group\\\", \\\"Web Server Instance\\\", \\\"Customer Data Bucket\\\", \\\"Primary Database\\\", \\\"Load Balancer - API\\\", \\\"Development VM\\\", \\\"Analytics Instance\\\"\"},\"exclusionReason\":{\"type\":\"string\",\"example\":\"Legacy system scheduled for decommission in Q2 2024 - approved by security team\",\"description\":\"The business justification for excluding this resource from compliance monitoring. Examples: \\\"Legacy system scheduled for decommission\\\", \\\"Development environment - non-production\\\", \\\"Approved exception by security team\\\", \\\"Temporary exclusion during migration\\\", \\\"Test environment with controlled access\\\", \\\"Maintenance window exclusion\\\"\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Exclusion created timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Exclusion updated timestamp\"},\"connection\":{\"nullable\":true,\"description\":\"The connection associated with this exclusion\",\"allOf\":[{\"$ref\":\"#/components/schemas/ConnectionCompactResponsePublicV2Dto\"}]},\"exclusionDesignator\":{\"description\":\"The user who created this exclusion\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"targetId\",\"targetName\",\"exclusionReason\",\"createdAt\",\"updatedAt\"]},\"ConnectionCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":\"1\",\"description\":\"The Connection ID\"},\"clientType\":{\"type\":\"string\",\"enum\":[\"GOOGLE\",\"OKTA\",\"MICROSOFT_365\",\"AWS\",\"GCP\",\"AZURE\",\"HEROKU\",\"GITHUB\",\"GITLAB\",\"BITBUCKET\",\"SHORTCUT\",\"JIRA\",\"ASANA\",\"GUSTO\",\"KARMACHECK\",\"GITHUB_ISSUES\",\"RIPPLING\",\"CERTN\",\"MERGEDEV_ADP_WORKFORCE_NOW\",\"MERGEDEV_BAMBOO_HR\",\"MERGEDEV_HR_PARTNER\",\"MERGEDEV_HI_BOB\",\"MERGEDEV_HUMAANS\",\"MERGEDEV_PERSONIO\",\"MERGEDEV_SAGE\",\"DIGITAL_OCEAN\",\"MERGEDEV_KALLIDUS\",\"MERGEDEV_TRINET\",\"MERGEDEV_TRINET_HR\",\"MERGEDEV_FRESHTEAM\",\"MERGEDEV_SAP_SUCCESSFACTORS\",\"TRELLO\",\"GITLAB_ISSUES\",\"MERGEDEV_JUSTWORKS\",\"LINEAR\",\"PIVOTAL_TRACKER\",\"WORK_OS\",\"MERGEDEV_PAYLOCITY\",\"MONGO_DB_ATLAS\",\"TARGET_PROCESS\",\"CLICKUP\",\"CHECKR\",\"MERGEDEV_WORKDAY\",\"ZOHO\",\"CLOUDFLARE\",\"JAMF\",\"AZURE_BOARDS\",\"AZURE_REPOS\",\"MERGEDEV_HR_CLOUD\",\"INTUNE\",\"OKTA_IDENTITY\",\"GOODHIRE\",\"KANDJI\",\"AWS_CODECOMMIT\",\"FIBERY\",\"CURRICULA\",\"JUMPCLOUD\",\"HEXNODE_UEM\",\"RIPPLING_MDM\",\"AWS_ORG_UNITS\",\"KNOWBE4\",\"MERGEDEV_UKG_PRO\",\"MERGEDEV_UKG_READY\",\"DATADOG\",\"SLACK\",\"DOCUSIGN\",\"MICROSOFT_TEAMS\",\"AWS_INSPECTOR\",\"MERGEDEV_ONELOGIN\",\"MERGEDEV_JUMPCLOUD\",\"CONFLUENCE\",\"WORKSPACE_ONE\",\"NEW_RELIC\",\"MERGEDEV_SERVICENOW\",\"RAPID7\",\"MERGEDEV_AHA\",\"MERGEDEV_BASECAMP\",\"MERGEDEV_BITBUCKET\",\"MERGEDEV_FRESHDESK\",\"MERGEDEV_FRESHSERVICE\",\"MERGEDEV_HEIGHT\",\"MERGEDEV_HIVE\",\"MERGEDEV_TEAMWORK\",\"MERGEDEV_WRIKE\",\"MERGEDEV_ZENDESK\",\"CSV_IDP\",\"APIDECK\",\"AWS_GOV_CLOUD\",\"SENTINEL_ONE\",\"MERGEDEV_NAMELY\",\"MERGEDEV_INSPERITY_PREMIER\",\"MERGEDEV_DAYFORCE\",\"MERGEDEV_ALEXISHR\",\"MERGEDEV_BREATHE\",\"MERGEDEV_CHARLIE\",\"MERGEDEV_CHARTHOP\",\"MERGEDEV_DEEL\",\"MERGEDEV_FACTORIAL\",\"MERGEDEV_INTELLIHR\",\"MERGEDEV_KEKA\",\"MERGEDEV_LUCCA\",\"MERGEDEV_OFFICIENT\",\"MERGEDEV_PAYCHEX\",\"MERGEDEV_PEOPLE_HR\",\"MERGEDEV_OYSTERHR\",\"MERGEDEV_PAYCOR\",\"HUBSPOT\",\"ZOOM\",\"AUTH0\",\"SENTRY\",\"ZAPIER\",\"SNOWFLAKE\",\"MIRO\",\"MERGEDEV_EMPLOYMENT_HERO\",\"SEGMENT\",\"WIZ\",\"XERO\",\"GITHUB_CODE\",\"ATLASSIAN\",\"PAGER_DUTY\",\"STACKONE_SMARTRECRUITERS\",\"STACKONE_TEAMTAILOR\",\"CROWDSTRIKE\",\"GITHUB_ENTERPRISE\",\"NOTION\",\"STACKONE_KLAVIYO\",\"STACKONE_LASTPASS\",\"STACKONE_LEAPSOME\",\"STACKONE_LEVER\",\"STACKONE_ORACLEHCM\",\"STACKONE_PINPOINT\",\"STACKONE_PIPEDRIVE\",\"STACKONE_RECRUITEE\",\"STACKONE_WEBEX\",\"STACKONE_WORKABLE\",\"STACKONE_ZELT\",\"STACKONE_BITWARDEN\",\"STACKONE_SALESLOFT\",\"STACKONE_DIXA\",\"STACKONE_FRESHSALES\",\"STACKONE_CANVA\",\"STACKONE_GREENHOUSE\",\"STACKONE_ASHBY\",\"STACKONE_ATTIO\",\"STACKONE_CONTENTFUL\",\"COVERDASH\",\"MERGEDEV_FRONT\",\"SALESFORCE\",\"STACKONE_ELASTIC\",\"STACKONE_RENDER\",\"STACKONE_TERRAFORM\",\"STACKONE_DOMO\",\"STACKONE_ENVOY\",\"STACKONE_SCALEWAY\",\"STACKONE_JETBRAINS\",\"STACKONE_FIVETRAN\",\"STACKONE_INTERCOM\",\"STACKONE_AUTODESK\",\"GITHUB_ACTIONS\",\"AZURE_ORG_UNITS\",\"MICROSOFT_365_GCC_HIGH\",\"STACKONE_AIRCALL\",\"STACKONE_15FIVE\",\"STACKONE_ROLLBAR\",\"STACKONE_EGNYTE\",\"STACKONE_QLIK\",\"STACKONE_BULLHORN\",\"STACKONE_OPENVPN\",\"STACKONE_SOPHOS\",\"STACKONE_MEISTERTASK\",\"STACKONE_TALENTLMS\",\"STACKONE_ONEFLOW\",\"STACKONE_RING_CENTRAL\",\"STACKONE_ARTICULATE\",\"STACKONE_DIALPAD\",\"STACKONE_TABLEAU\",\"AZURE_DEVOPS\",\"STACKONE_1PASSWORD\",\"STACKONE_MIXPANEL\",\"STACKONE_SONARCLOUD\",\"STACKONE_TWILIO\",\"STACKONE_ANSIBLE\",\"STACKONE_LATTICE\",\"STACKONE_WEBFLOW\",\"STACKONE_LACEWORK\",\"STACKONE_DATABRICKS\",\"STACKONE_IFS\",\"STACKONE_TRAVISCI\",\"STACKONE_MATILLIONETL\",\"STACKONE_OPTIMIZELY\",\"UAR_CSV\",\"STERLING\",\"HIRERIGHT\",\"VETTY\",\"MERGEDEV_CYBERARK\",\"SALESFORCE_UAR\",\"GOOGLE_ADMIN_CONSOLE\",\"VERCEL\",\"STACKONE_DUO\",\"STACKONE_GONG\",\"STACKONE_IRONCLAD\",\"STACKONE_SCORO\",\"STACKONE_TEAMVIEWER_REMOTE\",\"STACKONE_SPOTDRAFT\",\"STACKONE_SPENDESK\",\"STACKONE_SENDGRID\",\"STACKONE_SMARTSHEET\",\"STACKONE_CHECKMK\",\"LEEN_TENABLE\",\"LEEN_QUALYS\",\"LEEN_SEMGREP\",\"LEEN_SNYK\",\"LEEN_CROWDSTRIKE_VMS\",\"LEEN_MS_DEFENDER_VMS\",\"LEEN_SENTINELONE_VMS\",\"GITLAB_ON_PREM\",\"CUSTOM\",\"LEEN_RAPID7_VMS\",\"BAMBOO_HR\",\"GITLAB_ISSUES_ON_PREM\",\"GITHUB_ISSUES_ENTERPRISE\",\"BITBUCKET_CODE\",\"LEEN_ARNICA\",\"STACKONE_NETLIFY\",\"STACKONE_OPENAI\",\"KOLIDE\",\"MERGEDEV_JIRA_DATA_CENTER\",\"MERGEDEV_PINGONE\",\"GOOGLE_ADMIN_CONSOLE_OAUTH\",\"GOOGLE_OAUTH\",\"STACKONE_ANTHROPIC\",\"INTUNE_GCC_HIGH\",\"STACKONE_DROPBOX\",\"STACKONE_DROPBOX_SIGN\",\"STACKONE_HARVEST\",\"STACKONE_KAMELEOON\",\"STACKONE_MAKE\",\"STACKONE_RETOOL\",\"STACKONE_TOGGL\",\"STACKONE_BOX\",\"MERGEDEV_ZOHO_PEOPLE\",\"MERGEDEV_ZOHO_DESK\",\"LEEN_WIZ_VMS\",\"LEEN_WIZ_CODE\",\"LEEN_AIKIDO\",\"MERGEDEV_LATTICE_HRIS\",\"MERGEDEV_DARWINBOX\",\"MERGEDEV_PAYCOM\",\"AZURE_GCC_HIGH\",\"AZURE_MG_GCC_HIGH\",\"STACKONE_EASY_LLAMA\",\"MERGEDEV_LEAPSOME\",\"CUSTOM_XFA\",\"LEEN_MS_DEFENDER_VMS_GCC_HIGH\",\"STACKONE_CORNERSTONE\",\"STACKONE_DOCEBO\",\"STACKONE_GO1\",\"STACKONE_LINKEDIN_LEARNING\",\"STACKONE_SAP_LEARNING\",\"STACKONE_WORKDAY_LEARNING\",\"STACKONE_360LEARNING\",\"STACKONE_BRAINIER\",\"STACKONE_COURSERA\",\"STACKONE_XYLEME\",\"STACKONE_INFOSEC\",\"STACKONE_PEOPLE_FLUENT\",\"STACKONE_UDEMY\",\"AIKIDO\",\"AZURE_ENTRA_ID\",\"GOOGLE_CLOUD_IDENTITY\",\"HYPERCOMPLY\",\"INTRUDER\",\"IRIS_AI\",\"JIT\",\"TINES\",\"TORQ\",\"TRAY\",\"SWIF\",\"LEEN_ORCA_SECURITY\",\"ZIP\",\"CUSTOM_MDM\",\"LEEN_UPWIND\",\"WORK_OS_SCIM\",\"LEEN_GITLAB_VMS\",\"NINJAONE_MDM\",\"OKTA_OAUTH\",\"IRONCLAD_VENDOR\"],\"example\":\"GOOGLE\",\"description\":\"The client type\"},\"clientId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"drata.com\",\"description\":\"The client id from the external system associated to this connection\"},\"clientAlias\":{\"type\":\"string\",\"nullable\":true,\"example\":\"My-connection-alias-1\",\"description\":\"Alias for the connection\"},\"state\":{\"type\":\"string\",\"enum\":[\"ACTIVE\",\"MISCONFIGURED\"],\"example\":\"ACTIVE\",\"description\":\"The state of the connection\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"nullable\":true,\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this connection was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"nullable\":true,\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this connection was last updated\"},\"connectedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this connection was successfully established\"},\"failedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this connection failed\"},\"deletedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the connection was deleted\"}},\"required\":[\"id\",\"clientType\",\"clientId\",\"clientAlias\",\"state\",\"createdAt\",\"updatedAt\",\"connectedAt\",\"failedAt\",\"deletedAt\"]},\"MonitorExclusionExpandEnum\":{\"type\":\"string\",\"enum\":[\"connection\",\"exclusionDesignator\"]},\"MonitoringTestResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Monitoring Test ID\"},\"name\":{\"type\":\"string\",\"example\":\"A Version Control System is being Used\",\"description\":\"Name of the Monitoring Test\"},\"description\":{\"type\":\"string\",\"example\":\"Inspected Drata's version control system...\",\"description\":\"The description of the Monitoring Test\"},\"checkResultStatus\":{\"example\":\"PASSED\",\"description\":\"The compliance status of this Monitoring Test\",\"allOf\":[{\"$ref\":\"#/components/schemas/CheckResultStatusEnum\"}]},\"testId\":{\"type\":\"number\",\"example\":1,\"description\":\"Test ID\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Monitoring Test creation timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Monitoring Test updated timestamp\"},\"monitorInstances\":{\"description\":\"Monitor associated to this monitor test\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/MonitorCompactResponsePublicV2Dto\"}},\"disabledByUser\":{\"description\":\"The user who has disabled this Monitoring Test\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"controls\":{\"description\":\"Controls associated to this Monitoring Test\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlCompactResponsePublicV2Dto\"}}},\"required\":[\"id\",\"name\",\"description\",\"checkResultStatus\",\"testId\",\"createdAt\",\"updatedAt\"]},\"ControlCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Control ID\"},\"code\":{\"type\":\"string\",\"example\":\"AC-1\",\"description\":\"Control code\"},\"name\":{\"type\":\"string\",\"example\":\"Access Control\",\"description\":\"Control name\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Drata has implemented tools to monitor Drata's databases and notify appropriate personnel of any events or incidents based on\\n                 predetermined criteria. Incidents are escalated per policy.\",\"description\":\"Control description\"},\"isReady\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if the control is ready for compliance assessment. A control is considered ready when it has at least one valid component (tests, evidence, policies, or reports) and no failing components (no failing tests, invalid evidence, unapproved policies, etc.). This is calculated in real-time based on the current state of all control components.\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Control was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Control was last updated\"}},\"required\":[\"id\",\"code\",\"name\",\"description\",\"createdAt\",\"updatedAt\"]},\"MonitorCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Monitor ID\"},\"checkResultStatus\":{\"example\":\"PASSED\",\"description\":\"Current compliance status of the monitor (PASSED, FAILED, PENDING, etc.)\",\"allOf\":[{\"$ref\":\"#/components/schemas/CheckResultStatusEnum\"}]},\"collectionDescription\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Curl call to the website\",\"description\":\"Detailed description of how evidence is collected for this Monitor\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when the Monitor was first created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when the Monitor was last updated\"}},\"required\":[\"id\",\"checkResultStatus\",\"collectionDescription\",\"createdAt\",\"updatedAt\"]},\"MonitoringTestsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/MonitoringTestResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"TestSourceEnum\":{\"type\":\"string\",\"enum\":[\"DRATA\",\"CUSTOM\",\"EXTERNAL\",\"ACORN\",\"DRATA_LIBRARY\"]},\"CheckTypeEnum\":{\"type\":\"string\",\"enum\":[\"POLICY\",\"IN_DRATA\",\"AGENT\",\"INFRASTRUCTURE\",\"VERSION_CONTROL\",\"IDENTITY\",\"TICKETING\",\"HRIS\",\"OBSERVABILITY\",\"CUSTOM\"]},\"CheckStatusEnum\":{\"type\":\"string\",\"enum\":[\"UNUSED\",\"NEW\",\"ENABLED\",\"DISABLED\",\"TESTING\"]},\"CheckResultStatusEnum\":{\"type\":\"string\",\"enum\":[\"READY\",\"PASSED\",\"FAILED\",\"ERROR\",\"PREAUDIT\"]},\"MonitorExpandEnum\":{\"type\":\"string\",\"enum\":[\"controls\",\"monitorInstances\",\"disablingUser\"]},\"UserResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"User ID\"},\"email\":{\"type\":\"string\",\"example\":\"email@example.com\",\"description\":\"User email\"},\"firstName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Sally\",\"description\":\"User first name\"},\"lastName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Smith\",\"description\":\"User last name\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User last updated at\"},\"jobTitle\":{\"type\":\"string\",\"nullable\":true,\"example\":\"CEO\",\"description\":\"User job title\"},\"avatarUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://cdn-prod.imgpilot.com/avatar.png\",\"description\":\"User avatar URL\"},\"drataTermsAgreedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User agreed to the Drata terms date timestamp\"},\"roles\":{\"example\":[\"ROLE\",\"ANOTHER_ROLE\"],\"description\":\"User roles, only returned when `expand[]=roles` is passed.\",\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"backgroundChecks\":{\"nullable\":true,\"description\":\"The Background Checks array DTO, only returned when `expand[]=backgroundChecks` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/BackgroundCheckResponsePublicV2Dto\"}},\"documents\":{\"description\":\"Full list of user documents, only returned when `expand[]=documents` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserDocumentResponsePublicV2Dto\"}},\"identities\":{\"description\":\"User identities, only returned when `expand[]=identities` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserIdentityResponsePublicV2Dto\"}}},\"required\":[\"id\",\"email\",\"createdAt\",\"updatedAt\"]},\"UserIdentityResponsePublicV2Dto\":{\"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\",\"nullable\":true,\"example\":\"johndoe\",\"description\":\"External service username\"},\"connectedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this external user was linked to an application user\"},\"disconnectedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this external user was unlinked to an application user\"},\"hasMfa\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Indicates the external user MFA status\"},\"userId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"The user ID\"},\"connectionId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"The connection ID\"},\"connection\":{\"description\":\"Connection details\",\"allOf\":[{\"$ref\":\"#/components/schemas/ConnectionCompactResponsePublicV2Dto\"}]},\"email\":{\"type\":\"string\",\"nullable\":true,\"example\":\"johndoe@example.com\",\"description\":\"Primary email for user identity\"},\"secondaryEmail\":{\"type\":\"string\",\"nullable\":true,\"example\":\"johndoe@test.com\",\"description\":\"Secondary email for user identity\"},\"firstName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"John\",\"description\":\"First name\"},\"lastName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Doe\",\"description\":\"Last name\"},\"startedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"Fri Apr 03 2026\",\"description\":\"Start (hire) date for the user.\"},\"separatedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"description\":\"Separation (termination) date for the user. Null indicates a current employee.\",\"example\":\"Fri Apr 03 2026\"},\"isContractor\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Is the user a contractor? Null indicates no information is available.\"},\"jobTitle\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Engineer\",\"description\":\"Job title\"},\"managerId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"x00jk12-2312\",\"description\":\"Manager's identity id\"},\"managerName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Jose Díaz\",\"description\":\"Manager's full name\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User identity created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User identity last updated at\"}},\"required\":[\"id\",\"identityId\",\"username\",\"connectedAt\",\"disconnectedAt\",\"hasMfa\",\"userId\",\"connectionId\",\"connection\",\"email\",\"secondaryEmail\",\"firstName\",\"lastName\",\"startedAt\",\"separatedAt\",\"jobTitle\",\"managerId\",\"managerName\",\"createdAt\",\"updatedAt\"]},\"BackgroundCheckResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"description\":\"The Background Check Id\"},\"userId\":{\"type\":\"number\",\"nullable\":true,\"description\":\"The user ID\"},\"status\":{\"type\":\"string\",\"enum\":[\"PENDING\",\"OK\",\"ISSUE\",\"CANCELED\",\"EXPIRED\",\"OUT_OF_SCOPE\"],\"example\":\"OK\",\"description\":\"The status of the background check\"},\"caseId\":{\"type\":\"string\",\"nullable\":true,\"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\",\"nullable\":true,\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"The date this background check was manually uploaded\"},\"manuallyCheckUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"url.com\",\"description\":\"The url of manual background check\"},\"type\":{\"type\":\"string\",\"enum\":[\"KARMACHECK\",\"MANUAL\",\"CERTN\",\"CHECKR\",\"HRIS_RIPPLING\",\"STERLING\",\"HIRERIGHT\",\"VETTY\"],\"example\":\"CERTN\",\"description\":\"The background check type\"},\"source\":{\"type\":\"string\",\"nullable\":true,\"enum\":[\"DRATA\",\"CHECKR\",\"KARMACHECK\",\"RIPPLING_CHECKR\",\"CERTN\",\"STERLING\",\"HIRERIGHT\",\"VETTY\"],\"example\":\"DRATA\",\"description\":\"The background check source\"},\"reportData\":{\"type\":\"string\",\"description\":\"The background check report data\"},\"outOfScopeReason\":{\"type\":\"string\",\"nullable\":true,\"example\":\"abc123\",\"description\":\"the reason it was marked out of scope\"},\"outOfScopeAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When it was marked out of scope\"},\"invitationEmail\":{\"type\":\"string\",\"nullable\":true,\"example\":\"email@email.com\",\"description\":\"Invitation email\"},\"linkedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the report was linked to a user\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Report created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Report updated date timestamp\"}},\"required\":[\"id\",\"userId\",\"status\",\"caseId\",\"caseInvitationId\",\"url\",\"manualCheckDate\",\"manuallyCheckUrl\",\"type\",\"source\",\"reportData\",\"outOfScopeReason\",\"outOfScopeAt\",\"invitationEmail\",\"linkedAt\",\"createdAt\",\"updatedAt\"]},\"UserPolicyVersionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"User's Assigned Policy Version ID\"},\"acceptedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User Policy Version accepted at date timestamp. A null value indicates the user has not acknowledged the Policy yet.\"},\"createdAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User's Assigned Policy Version created at date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User's Assigned Policy Version updated at date timestamp\"},\"sourceType\":{\"description\":\"Indicates the source of the acknowledgement data\",\"example\":\"MY_DRATA\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyApprovalsSourceTypeEnum\"}]},\"details\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Additional details on how and where the User acknowledged the Policy\"},\"policyId\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy  ID\"},\"policyVersionId\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy Version ID\"},\"policy\":{\"description\":\"The associated Policy\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyCompactResponsePublicV2Dto\"}]},\"policyVersion\":{\"description\":\"The associated Policy Version\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyVersionCompactResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"acceptedAt\",\"createdAt\",\"updatedAt\",\"sourceType\",\"details\",\"policyId\",\"policyVersionId\"]},\"PolicyVersionCompactResponsePublicV2Dto\":{\"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\":\"Indicates if is this the current Policy\"},\"type\":{\"example\":\"UPLOADED\",\"description\":\"The Policy Version type\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyTypeEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy Version created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy Version last updated date timestamp\"},\"renewalDate\":{\"type\":\"string\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy renewal date. At the renewal date the administrator needs to review the policy and decide if\\n         re-acceptance is necessary.\"},\"subVersion\":{\"type\":\"number\",\"example\":1,\"description\":\"The Policy sub-version\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"description\":\"The Policy Version description\"},\"approvedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy Version approved at date timestamp\"},\"changesExplanation\":{\"type\":\"string\",\"nullable\":true,\"description\":\"The description of the changes done in this update\"},\"publishedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy Version published at date timestamp\"},\"requiresAcknowledgment\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Indicates if acknowledgment is required\"}},\"required\":[\"id\",\"version\",\"current\",\"type\",\"createdAt\",\"updatedAt\",\"renewalDate\",\"subVersion\",\"description\",\"approvedAt\",\"changesExplanation\",\"publishedAt\",\"requiresAcknowledgment\"]},\"PolicyTypeEnum\":{\"type\":\"string\",\"enum\":[\"BUILDER\",\"UPLOADED\",\"EXTERNAL\"]},\"PolicyCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy ID\"},\"name\":{\"type\":\"string\",\"example\":\"Acceptable Use Policy\",\"description\":\"The Policy name\"},\"description\":{\"type\":\"string\",\"description\":\"The Policy description\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy last updated date timestamp\"},\"assignedTo\":{\"example\":\"ALL\",\"description\":\"The scope of Users the Policy is assigned to\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyScopeEnum\"}]},\"policyStatus\":{\"example\":\"ACTIVE\",\"description\":\"The current status of the Policy (e.g. ACTIVE, ARCHIVED, REPLACED)\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyStatusEnum\"}]},\"renewalDate\":{\"type\":\"string\",\"nullable\":true,\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy renewal date\"}},\"required\":[\"id\",\"name\",\"description\",\"createdAt\",\"updatedAt\",\"policyStatus\",\"renewalDate\"]},\"PolicyScopeEnum\":{\"type\":\"string\",\"enum\":[\"ALL\",\"GROUP\",\"NONE\"]},\"PolicyApprovalsSourceTypeEnum\":{\"type\":\"string\",\"enum\":[\"UNKNOWN\",\"BAMBOO_HR\",\"CSV\",\"MY_DRATA\",\"PUBLIC_API\"]},\"UserPolicyAcceptRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"acceptedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"When the user accepted the Policy. Must be within the last year.\"},\"details\":{\"type\":\"string\",\"description\":\"Additional details on how and where the User acknowledged the Policy\",\"example\":\"Accepted in Confluence via plugin\"}},\"required\":[\"acceptedAt\"]},\"UserPolicyVersionsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Full list of User Policy Versions\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserPolicyVersionResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"UserPoliciesExpandEnum\":{\"type\":\"string\",\"enum\":[\"policy\",\"policyVersion\"]},\"UserDocumentResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"User document ID\"},\"userId\":{\"type\":\"number\",\"description\":\"The User ID the Document belongs to\"},\"downloadUrl\":{\"description\":\"The signed URL to download the User Document, only returned when `expand[]=downloadUrl` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/SignedUrlResponsePublicV2Dto\"}]},\"name\":{\"type\":\"string\",\"example\":\"Security Training\",\"description\":\"The name the file\"},\"type\":{\"type\":\"string\",\"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\",\"NIST_AI_TRAINING_EVIDENCE\"],\"example\":\"SEC_TRAINING\",\"description\":\"The User Document type\"},\"fileUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"http://localhost:5000/download/documents/1\",\"description\":\"The secure URL to the user document\"},\"renewalDate\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2026-10-27\",\"description\":\"Document's renewal date, after which the document is no longer consider valid evidence\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2020-07-06\",\"description\":\"Document created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2020-07-06\",\"description\":\"Document updated at\"}},\"required\":[\"id\",\"userId\",\"name\",\"type\",\"fileUrl\",\"renewalDate\",\"createdAt\",\"updatedAt\"]},\"UserDocumentCreateRequestPublicV2Dto\":{\"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\",\"description\":\"Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .gif, .jpg, .jpeg, .png\"},\"base64File\":{\"type\":\"string\",\"example\":{\"base64String\":\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg\",\"filename\":\"excellent-filename\"},\"description\":\"JSON string with external evidence in Base64 format.\"},\"completionDate\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2020-07-06\",\"description\":\"The date when the compliance was completed\"}},\"required\":[\"type\"]},\"UserDocumentsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Full list of user documents\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserDocumentResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"UserDocumentExpandEnum\":{\"type\":\"string\",\"enum\":[\"downloadUrl\"]},\"UsersResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"UserExpandEnum\":{\"type\":\"string\",\"enum\":[\"backgroundChecks\",\"documents\",\"personnel\",\"identities\",\"roles\"]},\"RoleResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Role ID\"},\"role\":{\"example\":\"ADMIN\",\"description\":\"Role type\",\"allOf\":[{\"$ref\":\"#/components/schemas/RoleEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Role created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Role last updated at\"},\"permissions\":{\"description\":\"Permissions associated with this Role, only returned when `expand[]=permissions` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PermissionResponsePublicV2Dto\"}}},\"required\":[\"id\",\"role\",\"createdAt\",\"updatedAt\"]},\"PermissionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Permission ID\"},\"action\":{\"example\":\"READ\",\"description\":\"Permission action\",\"allOf\":[{\"$ref\":\"#/components/schemas/ActionEnum\"}]},\"subject\":{\"example\":\"Asset\",\"description\":\"Permission subject\",\"allOf\":[{\"$ref\":\"#/components/schemas/SubjectEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Permission created at\"}},\"required\":[\"id\",\"action\",\"subject\",\"createdAt\"]},\"SubjectEnum\":{\"type\":\"string\",\"enum\":[\"AdminOnboarding\",\"Asset\",\"AuditHub\",\"Company\",\"CompanyDocument\",\"Connection\",\"Control\",\"ControlTestInstance\",\"CustomerRequest\",\"CustomTask\",\"Event\",\"Framework\",\"Personnel\",\"Policy\",\"PublicApiKey\",\"QuestionnairesVendors\",\"Report\",\"Risk\",\"RiskAssessment\",\"ServiceUser\",\"Ticket\",\"TrustCenter\",\"ListAllUsers\",\"UserIdentity\",\"UserIdentityInfrastructure\",\"UserIdentityVersionControl\",\"UsersRoles\",\"Vendor\",\"Vulnerability\",\"Note\",\"UserFeature\",\"Monitors\",\"Dashboard\",\"UserDocument\",\"Autopilot\",\"MonitorInstanceExclusion\",\"Workspace\",\"InternalSecurity\",\"ComplianceCheckExclusion\",\"UserLanguage\",\"SecurityReport\",\"Resync\",\"UserIdentityObservability\",\"SignIn\",\"FeatureAnnouncement\",\"Wysiwyg\",\"RemoteAccess\",\"EmployeeOnboarding\",\"UserIdentitiesAccess\",\"TicketManagement\",\"HumanResources\",\"UserControls\",\"TasksDetails\",\"ControlList\",\"ControlTicket\",\"RiskManagementTicket\",\"MonitorTicket\",\"CreateTicket\",\"DeleteTask\",\"UpdateTask\",\"CreateTask\",\"AssociateRequirements\",\"GetGroups\",\"WorkspaceConnections\",\"TrustCenterInfo\",\"GlobalConnection\",\"RiskTask\",\"GeneralTask\",\"ControlTask\",\"EvidenceTask\",\"PolicyTask\",\"VendorTask\",\"AccessReview\",\"RiskSettings\",\"Scan\",\"RiskDocument\",\"ViewAllControls\",\"ViewAllRisks\",\"ControlTemplate\",\"FrameworkMappingReset\",\"ActivateFramework\",\"CustomFields\",\"CaCConfiguration\",\"CaCMonitoring\",\"AccessReviewTicket\",\"SecurityQuestionnaire\",\"Findings\",\"ExceptionManagement\",\"CustomWorkflows\",\"VulnerabilityReport\",\"CustomConnections\",\"UserSettings\",\"KnowledgeBase\",\"TrustCenterRequest\",\"BulkImportRisk\",\"TestLibrary\",\"RiskRegisters\",\"BulkImportControl\",\"BulkImportTraining\",\"BulkImportBackgroundCheck\",\"BulkImportVendor\",\"RiskCategory\",\"Audit\",\"GroupRoleManagement\",\"BulkImportCustomTask\",\"UserIdentityHris\",\"Requirements\",\"ALL\",\"DenyControl\"]},\"ActionEnum\":{\"type\":\"string\",\"enum\":[\"READ\",\"MANAGE\",\"CREATE\",\"UPDATE\",\"DELETE\"]},\"RoleEnum\":{\"type\":\"string\",\"enum\":[\"EMPLOYEE\",\"TECHGOV\",\"AUDITOR\",\"ADMIN\",\"ACT_AS_READ_ONLY\",\"APP\",\"RISK_MANAGER\",\"WORKSPACE_ADMINISTRATOR\",\"SERVICE_USER\",\"REVIEWER\",\"CONTROL_MANAGER\",\"PEOPLE_OPS\",\"POLICY_MANAGER\",\"DEVOPS_ENGINEER\",\"KNOWLEDGE_BASE\",\"TRUST_CENTER_MANAGER\",\"TRUST_CENTER_REVIEWER\",\"RISK_REGISTER_OWNER\",\"INTERNAL_AUDITOR\",\"RESTRICTED_CONTROL_MANAGER\",\"RESTRICTED_RISK_MANAGER\",\"READONLY_ADMIN\",\"READONLY_TECHGOV\",\"READONLY_RISK_MANAGER\",\"READONLY_CONTROL_MANAGER\",\"READONLY_POLICY_MANAGER\",\"READONLY_PEOPLE_OPS\",\"READONLY_WORKSPACE_ADMINISTRATOR\",\"READONLY_RESTRICTED_CONTROL_MANAGER\",\"READONLY_RESTRICTED_RISK_MANAGER\",\"READONLY_RISK_REGISTER_OWNER\",\"READONLY_REVIEWER\",\"READONLY_DEVOPS_ENGINEER\",\"READONLY_TRUST_CENTER_MANAGER\"]},\"RolesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RoleResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"RoleExpandEnum\":{\"type\":\"string\",\"enum\":[\"permissions\"]},\"RiskDashboardResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"riskPosture\":{\"description\":\"Distribution of Risks by severity level. Shows the count of Risks in each severity category based on their calculated Risk scores.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskThresholdCountResponsePublicV2Dto\"}},\"treatmentOverview\":{\"description\":\"Distribution of Risks by treatment strategy. Shows how many Risks are assigned to each treatment plan: ACCEPT (acknowledge and monitor), AVOID (eliminate Risk source), MITIGATE (reduce impact/likelihood), TRANSFER (shift to third party), UNTREATED (no action taken).\",\"allOf\":[{\"$ref\":\"#/components/schemas/TreatmentOverviewResponsePublicV2Dto\"}]},\"riskHeatmap\":{\"description\":\"Risk heatmap data showing the distribution of Risks across impact and likelihood dimensions. Each entry represents the count of Risks at a specific impact/likelihood intersection, useful for visualizing Risk concentration in a matrix format.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskHeatmapResponsePublicV2Dto\"}},\"categoryBreakdown\":{\"description\":\"Breakdown of Risks by category and severity. For each Risk category, shows the distribution of Risks across severity levels, enabling analysis of which Risk categories have the most critical issues.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CategorySeverityResponsePublicV2Dto\"}},\"scored\":{\"type\":\"number\",\"example\":63,\"description\":\"Count of Risks that have been scored (have both impact and likelihood values assigned). Scored Risks contribute to the Risk posture and heatmap analytics.\"},\"remaining\":{\"type\":\"number\",\"example\":8,\"description\":\"Count of Risks that have not yet been scored (missing impact or likelihood values). These Risks require assessment to be included in comprehensive Risk analytics.\"},\"riskOverTime\":{\"description\":\"Historical trend data showing Risk severity distribution over time. Each entry represents a month with counts of Risks at each severity level, enabling time-series analysis and trend visualization. Sorted by most recent first.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskOverTimeResponsePublicV2Dto\"}}},\"required\":[\"riskPosture\",\"treatmentOverview\",\"riskHeatmap\",\"categoryBreakdown\",\"scored\",\"remaining\",\"riskOverTime\"]},\"RiskOverTimeResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"period\":{\"type\":\"string\",\"example\":\"2026-02\",\"description\":\"Time period in YYYY-MM format\"},\"severityCounts\":{\"description\":\"Distribution of Risks across severity levels for this time period\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskThresholdCountResponsePublicV2Dto\"}}},\"required\":[\"period\",\"severityCounts\"]},\"CategorySeverityResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"category\":{\"description\":\"Risk Category information\",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskCategoryCompactResponsePublicV2Dto\"}]},\"severity\":{\"description\":\"Distribution of Risks across severity levels for this category.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskThresholdCountResponsePublicV2Dto\"}}},\"required\":[\"category\",\"severity\"]},\"RiskCategoryCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Risk Category ID\"},\"name\":{\"type\":\"string\",\"example\":\"Access Control\",\"description\":\"Risk Category name used to group and organize related Risks\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Risk Category was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Risk Category was last updated\"}},\"required\":[\"id\",\"name\",\"createdAt\",\"updatedAt\"]},\"RiskHeatmapResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"impact\":{\"type\":\"number\",\"example\":2,\"description\":\"Impact level based on the configured risk matrix dimensions. Default is 1-5 scale, but can be configured from 3x3 up to 10x10 matrices.\",\"minimum\":1,\"maximum\":10},\"likelihood\":{\"type\":\"number\",\"example\":2,\"description\":\"Likelihood level based on the configured risk matrix dimensions. Default is 1-5 scale, but can be configured from 3x3 up to 10x10 matrices.\",\"minimum\":1,\"maximum\":10},\"total\":{\"type\":\"number\",\"example\":11,\"description\":\"Count of Risks at this impact/likelihood combination\"}},\"required\":[\"impact\",\"likelihood\",\"total\"]},\"TreatmentOverviewResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"untreated\":{\"type\":\"number\",\"example\":5,\"description\":\"Count of Risks with UNTREATED treatment plan\"},\"accept\":{\"type\":\"number\",\"example\":23,\"description\":\"Count of Risks with ACCEPT treatment plan\"},\"transfer\":{\"type\":\"number\",\"example\":13,\"description\":\"Count of Risks with TRANSFER treatment plan\"},\"avoid\":{\"type\":\"number\",\"example\":10,\"description\":\"Count of Risks with AVOID treatment plan \"},\"mitigate\":{\"type\":\"number\",\"example\":33,\"description\":\"Count of Risks with MITIGATE treatment plan\"}}},\"RiskThresholdCountResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"ID of the Risk Threshold\"},\"title\":{\"type\":\"string\",\"example\":\"Low\",\"description\":\"Title of the Risk Threshold\"},\"count\":{\"type\":\"number\",\"example\":5,\"description\":\"Count of Risks in this Risk Threshold\"}},\"required\":[\"id\",\"title\",\"count\"]},\"RiskUpdateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Password Management - Weak Password Policies\",\"description\":\"Descriptive title that clearly identifies the nature and scope of the Risk\"},\"description\":{\"type\":\"string\",\"maxLength\":768,\"example\":\"Weak password policies may allow unauthorized access to organizational systems and data through password-based attacks such as brute force, dictionary attacks, or credential stuffing.\",\"description\":\"Comprehensive description of the Risk scenario, potential threats, business impact, and affected systems or processes\"},\"identifiedAt\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Date when the Risk was first identified\",\"nullable\":true},\"impact\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":4,\"description\":\"Impact score representing the potential severity of consequences if the Risk materializes. Default is 1-5 scale (where 5 is most severe), but can be configured from 3x3 up to 10x10 matrices.\"},\"likelihood\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":3,\"description\":\"Likelihood score representing the probability of the Risk occurring. Default is 1-5 scale (where 5 is most likely), but can be configured from 3x3 up to 10x10 matrices.\"},\"treatmentPlan\":{\"example\":\"MITIGATE\",\"description\":\"Strategy for addressing the Risk: ACCEPT (acknowledge and monitor), AVOID (eliminate source), MITIGATE (reduce impact/likelihood), TRANSFER (shift to third party), UNTREATED (no action taken)\",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskTreatmentPlanEnum\"}]},\"treatmentDetails\":{\"type\":\"string\",\"maxLength\":30000,\"example\":\"Implement multi-factor authentication and enforce strong password complexity requirements across all systems.\",\"description\":\"Detailed explanation of the specific actions, controls, or measures being implemented to address the Risk. Cannot be provided when treatmentPlan is UNTREATED\"},\"anticipatedCompletionDate\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Target date for completing Risk treatment activities. Cannot be provided when treatmentPlan is UNTREATED\"},\"completionDate\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2024-12-01\",\"description\":\"Actual date when Risk treatment was completed. Cannot be provided when treatmentPlan is UNTREATED\"},\"residualImpact\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":2,\"description\":\"Residual impact score after treatment implementation. Default is 1-5 scale, but can be configured from 3x3 up to 10x10 matrices. Cannot be provided when treatmentPlan is UNTREATED\"},\"residualLikelihood\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":2,\"description\":\"Residual likelihood score after treatment implementation. Default is 1-5 scale, but can be configured from 3x3 up to 10x10 matrices. Cannot be provided when treatmentPlan is UNTREATED\"},\"status\":{\"example\":\"ACTIVE\",\"description\":\"Current status of the Risk in the Risk management lifecycle\",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskStatusTypeEnum\"}]},\"categories\":{\"uniqueItems\":true,\"description\":\"Risk categories for classification and reporting purposes\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CategoryRequestPublicV2Dto\"}},\"owners\":{\"uniqueItems\":true,\"description\":\"Users responsible for managing and monitoring this Risk\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskOwnerRequestPublicV2Dto\"}},\"reviewers\":{\"uniqueItems\":true,\"description\":\"Users responsible for reviewing and approving Risk treatment plans. Cannot be provided when treatmentPlan is UNTREATED\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ReviewerRequestPublicV2Dto\"}},\"controls\":{\"uniqueItems\":true,\"description\":\"Security controls implemented to mitigate this Risk\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskControlRequestPublicV2Dto\"}},\"customFields\":{\"description\":\"Custom Fields for the Risk\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}}},\"RiskControlRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique identifier for the Control\"}},\"required\":[\"id\"]},\"ReviewerRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique identifier for the Risk reviewer (user)\"}},\"required\":[\"id\"]},\"RiskOwnerRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique identifier for the Risk owner (user)\"}},\"required\":[\"id\"]},\"CategoryRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique identifier for the Risk category\"}},\"required\":[\"id\"]},\"RiskExpandEnum\":{\"type\":\"string\",\"enum\":[\"owners\",\"reviewers\",\"controls\",\"categories\",\"documents\",\"notes\",\"tickets\",\"tasks\",\"customFields\"]},\"RiskResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique internal identifier for the Risk record\"},\"riskId\":{\"type\":\"string\",\"example\":\"AC-04\",\"description\":\"Human-readable Risk identifier used for referencing and reporting (e.g., AC-04, VR-001)\"},\"title\":{\"type\":\"string\",\"example\":\"Password Management - Password Cracking\",\"description\":\"Descriptive title summarizing the nature of the Risk\"},\"description\":{\"type\":\"string\",\"example\":\"An attacker attempts to gain access to organizational information by guessing of passwords.\",\"description\":\"Detailed explanation of the Risk scenario, potential threats, and business impact\"},\"treatmentPlan\":{\"example\":\"UNTREATED\",\"description\":\"Risk treatment strategy: ACCEPT (acknowledge and monitor), AVOID (eliminate the Risk), MITIGATE (reduce impact/likelihood), TRANSFER (shift to third party), or UNTREATED (no action taken)\",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskTreatmentPlanEnum\"}]},\"treatmentDetails\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Implementing multi-factor authentication and password complexity requirements to reduce likelihood of successful password attacks.\",\"description\":\"Specific details about how the Risk treatment plan is being implemented or why a particular treatment approach was chosen\"},\"anticipatedCompletionDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Target date by which the Risk treatment plan is expected to be fully implemented\"},\"completionDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Actual date when the Risk treatment plan was completed and implemented\"},\"impact\":{\"type\":\"number\",\"nullable\":true,\"example\":5,\"description\":\"The potential severity or consequence of the Risk if it occurs\"},\"likelihood\":{\"type\":\"number\",\"nullable\":true,\"example\":5,\"description\":\"The probability or chance that the Risk will occur\"},\"score\":{\"type\":\"number\",\"nullable\":true,\"example\":25,\"description\":\"Overall Risk rating calculated as impact × likelihood. Score range depends on organization settings (1-25 with thresholds 1-4=low, 5-9=medium, 10-16=high, 17-25=critical)\"},\"residualImpact\":{\"type\":\"number\",\"nullable\":true,\"example\":3,\"description\":\"The residual severity or consequence of the Risk\"},\"residualLikelihood\":{\"type\":\"number\",\"nullable\":true,\"example\":3,\"description\":\"The residual probability or chance that the Risk will occur\"},\"residualScore\":{\"type\":\"number\",\"nullable\":true,\"example\":9,\"description\":\"Post-treatment Risk rating (residual impact × residual likelihood). Score range depends on organization settings (1-25 with thresholds 1-4=low, 5-9=medium, 10-16=high, 17-25=critical)\"},\"status\":{\"example\":\"ACTIVE\",\"description\":\"Current lifecycle status of the Risk: ACTIVE (being monitored/treated and considered applicable to your organization), CLOSED (resolved/completed), or ARCHIVED (not applicable to your organization). \",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskStatusTypeEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date and time when the Risk record was initially created in the system\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date and time when the Risk record was last modified or updated\"},\"controls\":{\"description\":\"Security controls implemented to mitigate or manage this Risk, only returned when `expand[]=controls` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlCompactResponsePublicV2Dto\"}},\"categories\":{\"description\":\"Risk categories used to organize and group related Risks for better management, only returned when `expand[]=categories` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskCategoryResponsePublicV2Dto\"}},\"owners\":{\"description\":\"Users responsible for managing and overseeing this Risk, only returned when `expand[]=owners` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}},\"reviewers\":{\"description\":\"Users assigned to review and validate Risk assessments and treatments, only returned when `expand[]=reviewers` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}},\"documents\":{\"description\":\"Supporting documents attached to this Risk for evidence and documentation, only returned when `expand[]=documents` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DocumentCompactResponsePublicV2Dto\"}},\"notes\":{\"description\":\"Notes and comments added by users to provide additional context about the Risk, only returned when `expand[]=notes` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskNoteCompactResponsePublicV2Dto\"}},\"tickets\":{\"description\":\"Tickets from external ticket management systems (Jira, ServiceNow, etc.) linked to this Risk for tracking remediation efforts, only returned when `expand[]=tickets` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/TicketCompactResponsePublicV2Dto\"}},\"tasks\":{\"description\":\"Custom tasks assigned to this Risk for tracking specific remediation activities, compliance requirements, or follow-up actions, only returned when `expand[]=tasks` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomTaskCompactResponsePublicV2Dto\"}},\"riskRegister\":{\"description\":\"Risk Register information for this Risk.\",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskRegisterCompactResponsePublicV2Dto\"}]},\"customFields\":{\"description\":\"Custom Fields, only returned when `expand[]=customFields` is passed. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldResponsePublicV2Dto\"}}},\"required\":[\"id\",\"riskId\",\"title\",\"description\",\"treatmentPlan\",\"impact\",\"likelihood\",\"score\",\"residualImpact\",\"residualLikelihood\",\"residualScore\",\"status\",\"createdAt\",\"updatedAt\"]},\"RiskRegisterCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique internal identifier for the Risk Register\"},\"name\":{\"type\":\"string\",\"example\":\"Default Risk Register\",\"description\":\"Name of the Risk Register\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Primary risk register for organizational risks\",\"description\":\"Description of the Risk Register\"}},\"required\":[\"id\",\"name\",\"description\"]},\"CustomTaskCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique internal identifier for the Custom Task\"},\"title\":{\"type\":\"string\",\"example\":\"Review quarterly security policies\",\"description\":\"Title or name of the Custom Task describing what needs to be accomplished\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Conduct a comprehensive review of all security policies to ensure compliance with current regulations.\",\"description\":\"Detailed description providing additional context about the Custom Task requirements and objectives\"},\"dueDate\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Due date for Custom Task completion in ISO 8601 date format (YYYY-MM-DD)\"},\"completedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date and time when the Custom Task was marked as completed, null if still pending\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date and time when the Custom Task was created in the system\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date and time when the Custom Task was last updated\"}},\"required\":[\"id\",\"title\",\"dueDate\",\"createdAt\",\"updatedAt\"]},\"TicketCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique internal identifier for the Ticket record\"},\"externalTicketId\":{\"type\":\"string\",\"example\":\"ENG-11245\",\"description\":\"External ticket identifier from the connected ticket management system (e.g., Jira, ServiceNow, GitHub Issues)\"},\"isDone\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Indicates whether the ticket has been completed or resolved. True means the ticket is closed/done, false means it is still open/in progress.\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date and time when the ticket record was created in Drata\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date and time when the ticket record was last updated in Drata\"}},\"required\":[\"id\",\"externalTicketId\",\"isDone\",\"createdAt\",\"updatedAt\"]},\"RiskNoteCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Note ID\"},\"comment\":{\"type\":\"string\",\"example\":\"This Risk has been reviewed and approved by the security team. Implementation timeline updated.\",\"description\":\"Note content providing additional context or updates about the risk\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Note was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Note was last updated\"}},\"required\":[\"id\",\"comment\",\"createdAt\",\"updatedAt\"]},\"DocumentCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Document ID\"},\"name\":{\"type\":\"string\",\"example\":\"Risk Assessment Report Q4 2023.pdf\",\"description\":\"Document name as uploaded by the user\"},\"downloadUrl\":{\"type\":\"string\",\"example\":\"https://example.com/document.pdf\",\"description\":\"Signed URL to download the Document\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Document was uploaded\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Document was last updated\"}},\"required\":[\"id\",\"name\",\"downloadUrl\",\"createdAt\",\"updatedAt\"]},\"RiskCategoryResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Risk Category ID\"},\"name\":{\"type\":\"string\",\"example\":\"Access Control\",\"description\":\"Risk Category name used to group and organize related Risks\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Risk Category was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Risk Category was last updated\"}},\"required\":[\"id\",\"name\",\"createdAt\",\"updatedAt\"]},\"RiskCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Password Management - Weak Password Policies\",\"description\":\"Descriptive title that clearly identifies the nature and scope of the Risk\"},\"description\":{\"type\":\"string\",\"maxLength\":768,\"example\":\"Weak password policies may allow unauthorized access to organizational systems and data through password-based attacks such as brute force, dictionary attacks, or credential stuffing.\",\"description\":\"Comprehensive description of the Risk scenario, potential threats, business impact, and affected systems or processes\"},\"identifiedAt\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Date when the Risk was first identified (accepts date-only or full ISO8601 format)\",\"nullable\":true},\"impact\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":4,\"description\":\"Impact score representing the potential severity of consequences if the Risk materializes. Default is 1-5 scale (where 5 is most severe), but can be configured from 3x3 up to 10x10 matrices.\"},\"likelihood\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":3,\"description\":\"Likelihood score representing the probability of the Risk occurring. Default is 1-5 scale (where 5 is most likely), but can be configured from 3x3 up to 10x10 matrices.\"},\"treatmentPlan\":{\"default\":0,\"example\":\"MITIGATE\",\"description\":\"Strategy for addressing the Risk: ACCEPT (acknowledge and monitor), AVOID (eliminate source), MITIGATE (reduce impact/likelihood), TRANSFER (shift to third party), UNTREATED (no action taken)\",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskTreatmentPlanEnum\"}]},\"treatmentDetails\":{\"type\":\"string\",\"maxLength\":30000,\"example\":\"Implement multi-factor authentication and enforce strong password complexity requirements across all systems.\",\"description\":\"Detailed explanation of the specific actions, controls, or measures being implemented to address the Risk. Cannot be provided when treatmentPlan is UNTREATED\"},\"anticipatedCompletionDate\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2020-07-06\",\"description\":\"Target date for completing Risk treatment activities (accepts date-only or full ISO8601 format). Cannot be provided when treatmentPlan is UNTREATED\"},\"completionDate\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Actual date when Risk treatment was completed (accepts date-only or full ISO8601 format). Cannot be provided when treatmentPlan is UNTREATED\"},\"residualImpact\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":2,\"description\":\"Residual impact score after treatment implementation. Default is 1-5 scale, but can be configured from 3x3 up to 10x10 matrices. Cannot be provided when treatmentPlan is UNTREATED\"},\"residualLikelihood\":{\"type\":\"number\",\"minimum\":1,\"maximum\":10,\"example\":2,\"description\":\"Residual likelihood score after treatment implementation. Default is 1-5 scale, but can be configured from 3x3 up to 10x10 matrices. Cannot be provided when treatmentPlan is UNTREATED\"},\"status\":{\"example\":\"ACTIVE\",\"description\":\"Current lifecycle status of the Risk: ACTIVE (being monitored/treated and considered applicable to your organization), CLOSED (resolved/completed), or ARCHIVED (not applicable to your organization).\",\"default\":\"ACTIVE\",\"allOf\":[{\"$ref\":\"#/components/schemas/RiskStatusTypeEnum\"}]},\"categories\":{\"uniqueItems\":true,\"description\":\"Risk categories for classification and reporting purposes\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CategoryRequestPublicV2Dto\"}},\"owners\":{\"uniqueItems\":true,\"description\":\"Users responsible for managing and monitoring this Risk\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskOwnerRequestPublicV2Dto\"}},\"reviewers\":{\"uniqueItems\":true,\"description\":\"Users responsible for reviewing and approving Risk treatment plans. Cannot be provided when treatmentPlan is UNTREATED\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ReviewerRequestPublicV2Dto\"}},\"controls\":{\"uniqueItems\":true,\"description\":\"Security controls implemented to mitigate this Risk\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskControlRequestPublicV2Dto\"}},\"customFields\":{\"description\":\"Custom Fields for the Risk\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}},\"required\":[\"title\",\"description\"]},\"RisksResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"RiskTreatmentPlanEnum\":{\"type\":\"string\",\"enum\":[\"UNTREATED\",\"ACCEPT\",\"TRANSFER\",\"AVOID\",\"MITIGATE\"]},\"RiskStatusTypeEnum\":{\"type\":\"string\",\"enum\":[\"ACTIVE\",\"ARCHIVED\",\"CLOSED\"]},\"RiskExpandV2Enum\":{\"type\":\"string\",\"enum\":[\"owners\",\"reviewers\",\"controls\",\"categories\",\"documents\",\"notes\",\"tickets\",\"tasks\",\"customFields\"]},\"RiskRegisterUpdatePublicV2RequestDto\":{\"type\":\"object\",\"properties\":{\"description\":{\"type\":\"string\",\"maxLength\":60000,\"nullable\":true,\"example\":\"Register for all Risks\",\"description\":\"Description for the Risk Register\"},\"ownerIds\":{\"example\":[1,2,3],\"description\":\"List of User ids to be assigned to the Risk Register as owners\",\"type\":\"array\",\"items\":{\"type\":\"number\",\"minimum\":1}},\"workspaceIds\":{\"example\":[1,2],\"description\":\"List of Workspace IDs to associate with the Risk Register\",\"type\":\"array\",\"items\":{\"type\":\"number\",\"minimum\":1}},\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Default Register\",\"description\":\"Unique name for the Risk Register\"}}},\"RiskRegisterResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique internal identifier for the Risk Register\"},\"name\":{\"type\":\"string\",\"example\":\"Default Register\",\"description\":\"Name of the Risk Register\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Default Register for all Risks\",\"description\":\"Description of the Risk Register\"},\"owners\":{\"description\":\"Users assigned as Risk Register owners\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}},\"workspaces\":{\"description\":\"Workspaces associated with the Risk Register\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskRegisterWorkspaceResponsePublicV2Dto\"}},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Risk Register created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Risk Register last updated at\"}},\"required\":[\"id\",\"name\",\"description\",\"owners\",\"workspaces\",\"createdAt\",\"updatedAt\"]},\"RiskRegisterWorkspaceResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Workspace ID\"},\"name\":{\"type\":\"string\",\"example\":\"Drata\",\"description\":\"Workspace name\"}},\"required\":[\"id\",\"name\"]},\"RiskRegisterCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Default Register\",\"description\":\"Unique name for the Risk Register\"},\"description\":{\"type\":\"string\",\"maxLength\":60000,\"nullable\":true,\"example\":\"Register for all Risks\",\"description\":\"Description for the Risk Register\"},\"ownerIds\":{\"example\":[1,2,3],\"description\":\"List of User ids to be assigned to the Risk Register as owners\",\"type\":\"array\",\"items\":{\"type\":\"number\",\"minimum\":1}},\"workspaceIds\":{\"example\":[1,2],\"description\":\"List of Workspace IDs to associate with the Risk Register\",\"type\":\"array\",\"items\":{\"type\":\"number\",\"minimum\":1}}},\"required\":[\"name\"]},\"RiskRegistersResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"example\":[],\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskRegisterResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"RiskRegisterExpandEnum\":{\"type\":\"string\",\"enum\":[\"workspaces\"]},\"RiskNoteResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":123,\"description\":\"Note ID\"},\"comment\":{\"type\":\"string\",\"description\":\"The Note comment\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Note created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Note updated date timestamp\"},\"owner\":{\"description\":\"The User that created the Note, only returned when `expand[]=owner` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"comment\",\"createdAt\",\"updatedAt\"]},\"RiskNoteWriteRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"comment\":{\"type\":\"string\",\"maxLength\":768,\"example\":\"This is a note about the risk assessment findings.\",\"description\":\"The comment content for the note\"}},\"required\":[\"comment\"]},\"RiskNotesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskNoteResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"RiskNotesExpandEnum\":{\"type\":\"string\",\"enum\":[\"owner\"]},\"RiskLibraryCopyResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Array of created risk objects.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskCompactResponsePublicV2Dto\"}}},\"required\":[\"data\"]},\"RiskCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":100,\"description\":\"Unique identifier of the newly created Risk in the register\"},\"riskId\":{\"type\":\"string\",\"example\":\"AC-04\",\"description\":\"Human-readable Risk Identifier\"},\"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 passwords.\",\"description\":\"Description of the Risk\"},\"registerId\":{\"type\":\"number\",\"example\":5,\"description\":\"ID of the Risk Register where the Risk was created\"}},\"required\":[\"id\",\"riskId\",\"title\",\"description\",\"registerId\"]},\"RiskLibraryCopyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"bulkActionType\":{\"enum\":[\"COPY_BY_IDS\",\"COPY_BY_GROUPS\"],\"type\":\"string\",\"example\":\"COPY_BY_IDS\",\"description\":\"The copy action to perform on from Risk Library to the Risk Register.\"},\"riskIds\":{\"minItems\":1,\"example\":[\"AA-01\",\"AA-02\",\"AA-03\"],\"description\":\"An array of the Risk IDs that you want to copy from Risk Library to the Risk Register.\",\"type\":\"array\",\"items\":{\"type\":\"string\"}},\"riskGroups\":{\"minItems\":1,\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"WIZARD_CORE\",\"AI_DEVELOPMENT\",\"AI_USE\",\"PHYSICAL_SITE\",\"CLOUD_ENVIRONMENT\",\"UNSECURE_DEVICES\",\"DEVICE_DELIVERY\",\"SOFTWARE_DEVELOPMENT\",\"REGULATORY_REQUIREMENTS\"]},\"example\":[\"CLOUD_ENVIRONMENT\"],\"description\":\"An array of the Risk Groups that you want to copy from Risk Library to the Risk Register.\"},\"registerId\":{\"type\":\"number\",\"example\":1,\"description\":\"The Register ID to copy the Risks to.\"}},\"required\":[\"bulkActionType\",\"riskIds\",\"riskGroups\",\"registerId\"]},\"RiskLibraryItemResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Unique identifier for the Risk Library Item\"},\"riskId\":{\"type\":\"string\",\"example\":\"AC-04\",\"description\":\"Human-readable Risk Identifier\"},\"title\":{\"type\":\"string\",\"example\":\"Password Management - Password Cracking\",\"description\":\"Title of the Risk Library Item\"},\"description\":{\"type\":\"string\",\"example\":\"An attacker attempts to gain access to organizational information by guessing passwords.\",\"description\":\"Detailed description of the Risk Library Item\"},\"controls\":{\"description\":\"Associated Controls in compact format, only returned when `expand[]=controls` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskControlCompactResponsePublicV2Dto\"}},\"categories\":{\"description\":\"Associated Categories in compact format, only returned when `expand[]=categories` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskCategoryCompactResponsePublicV2Dto\"}}},\"required\":[\"id\",\"riskId\",\"title\",\"description\"]},\"RiskControlCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":10,\"description\":\"Unique identifier of the Control\"},\"code\":{\"type\":\"string\",\"example\":\"AC-2\",\"description\":\"Human-readable Control identifier\"},\"name\":{\"type\":\"string\",\"example\":\"Account Management\",\"description\":\"Control name\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Control was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date when the Control was last updated\"}},\"required\":[\"id\",\"code\",\"name\",\"createdAt\",\"updatedAt\"]},\"RiskLibraryResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/RiskLibraryItemResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"PaginationResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"cursor\":{\"type\":\"string\",\"nullable\":true,\"description\":\"When this is not null, it indicates there is additional data. Pass this value in to the `cursor` parameter to fetch the next page of data.\"}},\"required\":[\"cursor\"]},\"RiskLibraryExpandEnum\":{\"type\":\"string\",\"enum\":[\"controls\",\"categories\"]},\"DocumentResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Document ID\"},\"name\":{\"type\":\"string\",\"example\":\"Risk Assessment Document.pdf\",\"description\":\"The name of the Document file\"},\"downloadUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"http://localhost:5000/download/risk/1/document\",\"description\":\"The secure URL to download the Document\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Document created date timestamp\"}},\"required\":[\"id\",\"name\",\"downloadUrl\",\"createdAt\"]},\"RiskDocumentsUploadResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"documents\":{\"description\":\"List of uploaded Risk Documents\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DocumentResponsePublicV2Dto\"}}},\"required\":[\"documents\"]},\"RiskDocumentsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DocumentResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"PolicyVersionHtmlResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"content\":{\"type\":\"string\",\"nullable\":true,\"example\":\"<h1>Hello</h1>\",\"description\":\"The HTML content with signed URL images of a Policy Version\"}},\"required\":[\"content\"]},\"PolicyVersionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy Version ID\"},\"approvedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when this Policy Version was approved for use\"},\"changeSummary\":{\"type\":\"string\",\"nullable\":true,\"description\":\"A brief summary of the changes made in this Policy Version\"},\"changesExplanation\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Detailed explanation of what changes were made in this Policy Version compared to previous versions\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when this Policy Version was first created\"},\"current\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates whether this is the currently active Policy Version for the Policy\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Optional description providing details about this specific Policy Version\"},\"policyVersionStatus\":{\"nullable\":true,\"example\":\"PUBLISHED\",\"description\":\"Current status of the Policy Version (e.g., DRAFT, PUBLISHED, ARCHIVED)\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyVersionStatusEnum\"}]},\"publishedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when this Policy Version was published and made available to users\"},\"renewalDate\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Date when this Policy Version is scheduled for renewal\"},\"subVersion\":{\"type\":\"number\",\"example\":0,\"description\":\"Minor version number of the Policy Version (e.g., 0, 1, 2) used for incremental changes\"},\"type\":{\"format\":\"date\",\"example\":\"BUILDER\",\"description\":\"Type of policy this Policy Version belongs to (e.g., BUILDER, CUSTOM)\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyTypeEnum\"}]},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Timestamp when this Policy Version was last modified\"},\"version\":{\"type\":\"number\",\"example\":1,\"description\":\"Major version number of the Policy Version (e.g., 1, 2, 3)\"},\"gracePeriodSlas\":{\"description\":\"Service Level Agreements with grace period configurations for this Policy Version. Only returned when `expand[]=gracePeriodSLAs` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyGracePeriodSlaCompactResponsePublicV2Dto\"}},\"owner\":{\"description\":\"The user who owns and is responsible for this Policy Version. Only returned when `expand[]=owner` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"p3MatrixSlas\":{\"description\":\"P3 Matrix Service Level Agreements that define priority-based response times for this Policy Version. Only returned when `expand[]=p3MatrixSLAs` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyP3MatrixSlaCompactResponsePublicV2Dto\"}},\"policy\":{\"description\":\"The parent Policy that this Policy Version belongs to. Only returned when `expand[]=policy` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyCompactResponsePublicV2Dto\"}]},\"requiresAcknowledgment\":{\"type\":\"boolean\",\"nullable\":true,\"description\":\"Indicates whether users must acknowledge reading this Policy Version before proceeding\"},\"weekTimeFrameSlas\":{\"description\":\"Service Level Agreements based on weekly time frames associated with this Policy Version. Only returned when `expand[]=weekTimeFrameSLAs` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyWeekTimeFrameSlaCompactResponsePublicV2Dto\"}},\"downloadUrl\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Signed URL (valid 15 minutes) to download this Policy Version in its original format (PDF, DOCX, XLSX, etc.). Only returned when `expand[]=downloadUrl` is passed.\",\"example\":\"https://s3.amazonaws.com/bucket/file.pdf?signature=...\"},\"downloadPdfUrl\":{\"type\":\"string\",\"nullable\":true,\"description\":\"Signed URL (valid 15 minutes) to download this Policy Version as a PDF. Only returned when `expand[]=downloadPdfUrl` is passed.\",\"example\":\"https://s3.amazonaws.com/bucket/file.pdf?signature=...\"}},\"required\":[\"id\",\"approvedAt\",\"changeSummary\",\"changesExplanation\",\"createdAt\",\"current\",\"description\",\"policyVersionStatus\",\"publishedAt\",\"renewalDate\",\"subVersion\",\"type\",\"updatedAt\",\"version\"]},\"PolicyWeekTimeFrameSlaCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy Week Time Frame SLA ID\"},\"timeFrame\":{\"type\":\"string\",\"example\":\"1\",\"description\":\"Policy Week Time Frame SLA time frame\"},\"label\":{\"type\":\"string\",\"example\":\"Weekly Review\",\"description\":\"Policy Week Time Frame SLA label\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Updated date timestamp\"}},\"required\":[\"id\",\"timeFrame\",\"label\",\"createdAt\",\"updatedAt\"]},\"PolicyP3MatrixSlaCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy P3 Matrix SLA ID\"},\"label\":{\"type\":\"string\",\"example\":\"P3 Matrix Review\",\"description\":\"Policy P3 Matrix SLA label\"},\"timeFrame\":{\"type\":\"string\",\"example\":\"1\",\"description\":\"Policy P3 Matrix SLA time frame\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Updated date timestamp\"}},\"required\":[\"id\",\"label\",\"timeFrame\",\"createdAt\",\"updatedAt\"]},\"PolicyGracePeriodSlaCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy Grace Period SLA ID\"},\"label\":{\"type\":\"string\",\"example\":\"Grace Period Review\",\"description\":\"Policy Grace Period SLA label\"},\"gracePeriod\":{\"type\":\"string\",\"example\":\"1\",\"description\":\"Policy Grace Period SLA time frame\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Updated date timestamp\"}},\"required\":[\"id\",\"label\",\"gracePeriod\",\"createdAt\",\"updatedAt\"]},\"PolicyVersionsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyVersionResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"PolicyVersionStatusEnum\":{\"type\":\"string\",\"enum\":[\"NEEDS_APPROVAL\",\"APPROVED\",\"PUBLISHED\",\"DRAFT\",\"DISCARDED\"]},\"PolicyVersionExpandEnum\":{\"type\":\"string\",\"enum\":[\"owner\",\"weekTimeFrameSlas\",\"p3MatrixSlas\",\"gracePeriodSlas\",\"downloadUrl\",\"downloadPdfUrl\"]},\"PolicyResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Policy ID\"},\"name\":{\"type\":\"string\",\"example\":\"Acceptable Use Policy\",\"description\":\"The Policy name\"},\"scope\":{\"example\":\"ALL\",\"description\":\"The scope of Users the Policy is assigned to\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyScopeEnum\"}]},\"status\":{\"example\":\"ACTIVE\",\"description\":\"The current status of the Policy (e.g. ACTIVE, ARCHIVED, REPLACED)\",\"allOf\":[{\"$ref\":\"#/components/schemas/PolicyStatusEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy created date timestamp\"},\"currentVersionId\":{\"type\":\"number\",\"nullable\":true,\"example\":2,\"description\":\"The current published version ID\"},\"version\":{\"type\":\"string\",\"nullable\":true,\"example\":\"1\",\"description\":\"Policy version\"},\"subVersion\":{\"type\":\"string\",\"nullable\":true,\"example\":\"0\",\"description\":\"Policy sub-version\"},\"renewalDate\":{\"type\":\"string\",\"nullable\":true,\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy renewal date\"},\"publishedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy published date timestamp\"},\"approvedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Policy approved date timestamp\"},\"owner\":{\"description\":\"The current owner of the Policy, only returned when `expand[]=owner` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"groups\":{\"description\":\"Groups associated with this Policy, only returned when `expand[]=groups` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/GroupCompactResponsePublicV2Dto\"}},\"controls\":{\"description\":\"Controls for this Policy, only returned when `expand[]=controls` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlCompactResponsePublicV2Dto\"}},\"weekTimeFrameSlas\":{\"description\":\"Week Time Frame SLAs for this Policy, only returned when `expand[]=weekTimeFrameSLAs` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyWeekTimeFrameSlaCompactResponsePublicV2Dto\"}},\"gracePeriodSlas\":{\"description\":\"Grace Period SLAs for this Policy, only returned when `expand[]=gracePeriodSLAs` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyGracePeriodSlaCompactResponsePublicV2Dto\"}},\"p3MatrixSlas\":{\"description\":\"P3 Matrix SLAs for this Policy, only returned when `expand[]=p3MatrixSLAs` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyP3MatrixSlaCompactResponsePublicV2Dto\"}}},\"required\":[\"id\",\"name\",\"status\",\"createdAt\",\"currentVersionId\",\"version\",\"subVersion\",\"renewalDate\",\"publishedAt\",\"approvedAt\"]},\"GroupCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Group ID\"},\"name\":{\"type\":\"string\",\"example\":\"Engineering Team\",\"description\":\"Group name\"},\"externalId\":{\"type\":\"string\",\"example\":\"external-group-123\",\"description\":\"External ID from Group identity provider\"},\"source\":{\"type\":\"string\",\"example\":\"GOOGLE\",\"description\":\"Identity source. DEPRECATED: This field will be removed in a future release.\",\"deprecated\":true},\"connectionId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"The ID of the identity provider connection that synced this group. Use Get Connection to retrieve connection details including `clientType` and `clientAlias`.\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Updated date timestamp\"}},\"required\":[\"id\",\"name\",\"externalId\",\"source\",\"createdAt\",\"updatedAt\"]},\"PolicyExpandEnum\":{\"type\":\"string\",\"enum\":[\"groups\",\"controls\",\"weekTimeFrameSlas\",\"gracePeriodSlas\",\"p3MatrixSlas\",\"owner\"]},\"ExceptionResponsePublicDto\":{\"type\":\"object\",\"properties\":{\"statusCode\":{\"type\":\"number\"},\"message\":{\"type\":\"string\"},\"code\":{\"type\":\"number\"},\"debugInfo\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"message\":{\"type\":\"string\"},\"stack\":{\"type\":\"string\"}},\"required\":[\"name\",\"message\"]}},\"required\":[\"statusCode\",\"message\",\"code\"]},\"PoliciesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PolicyResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"PolicyStatusEnum\":{\"type\":\"string\",\"enum\":[\"ACTIVE\",\"ARCHIVED\",\"REPLACED\",\"UNACCEPTABLE\",\"OUTDATED\"]},\"PolicyListExpandEnum\":{\"type\":\"string\",\"enum\":[\"groups\",\"weekTimeFrameSlas\",\"gracePeriodSlas\",\"p3MatrixSlas\",\"owner\"]},\"PersonnelActionsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"number\",\"description\":\"The number of Personnel records that were affected by the action\",\"example\":42}},\"required\":[\"count\"]},\"PersonnelActionsRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"action\":{\"description\":\"The action to perform on Personnel\",\"example\":\"reset-sync\",\"allOf\":[{\"$ref\":\"#/components/schemas/PersonnelActionEnum\"}]},\"personnelIds\":{\"description\":\"Array of Personnel IDs to perform the action on. Required for `reset-sync` action. Must not be provided for `reset-sync-all` action.\",\"example\":[1,2,3],\"type\":\"array\",\"items\":{\"type\":\"number\"}}},\"required\":[\"action\"]},\"PersonnelActionEnum\":{\"type\":\"string\",\"enum\":[\"reset-sync\",\"reset-sync-all\"]},\"PersonnelModifyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"startedAt\":{\"type\":\"string\",\"example\":\"2020-07-06\",\"description\":\"The date when this person started working at the company. Note: Once manually set, automatic updates from identity providers (IDP) and HRIS systems will be ignored. Use the resync endpoint to restore automatic updates.\"},\"separatedAt\":{\"type\":\"string\",\"example\":\"2020-07-06\",\"description\":\"The date when this person was separated from the company system.\"},\"employmentStatus\":{\"example\":\"CURRENT_CONTRACTOR\",\"description\":\"The desired employment status to be updated\",\"allOf\":[{\"$ref\":\"#/components/schemas/EmploymentStatusEnum\"}]},\"notHumanReason\":{\"type\":\"string\",\"maxLength\":30000,\"example\":\"This is not a real personnel, but a placeholder for anyone in charge of X\",\"description\":\"Explains why the employment status of this personnel is marked as `OUT_OF_SCOPE`. This field is required if the `employmentStatus` is set to `OUT_OF_SCOPE`.\"},\"customFields\":{\"description\":\"Custom Fields for the Person. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}}},\"PersonResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Personnel ID\"},\"userId\":{\"type\":\"number\",\"example\":1,\"description\":\"User ID associated with this Personnel\"},\"user\":{\"description\":\"The User associated with this Personnel, only returned when `expand[]=user` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"employmentStatus\":{\"description\":\"The employment status of the Personnel\",\"allOf\":[{\"$ref\":\"#/components/schemas/EmploymentStatusEnum\"}]},\"notHumanReason\":{\"type\":\"string\",\"nullable\":true,\"example\":\"This is not a real personnel, but a placeholder for anyone in charge of X\",\"description\":\"Indicates why the employment status of this Personnel is marked as `OUT_OF_SCOPE`.\"},\"reasonProvider\":{\"nullable\":true,\"description\":\"The User who marked the employment status as `OUT_OF_SCOPE` and provided the `notHumanReason`, only returned when `expand[]=reasonProvider` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"complianceChecks\":{\"description\":\"Compliance checks for this Personnel, only returned when `expand[]=complianceChecks` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ComplianceCheckWithExclusionResponsePublicV2Dto\"}},\"startedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"The date when this Personnel was onboarded onto the company system\"},\"separatedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2023-12-31T00:00:00.000Z\",\"description\":\"The date when this Personnel was separated from the company system\"},\"statusUpdatedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"description\":\"The date when this Personnel was manually updated. If this value is set, changes in the IDP or HRIS will not be reflected in the employment status.\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"Personnel created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"Personnel updated date timestamp\"},\"customFields\":{\"description\":\"Custom Fields. Only returned when `expand[]=customFields` is passed. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldResponsePublicV2Dto\"}}},\"required\":[\"id\",\"userId\",\"employmentStatus\",\"startedAt\",\"statusUpdatedAt\",\"createdAt\",\"updatedAt\"]},\"ComplianceCheckWithExclusionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Compliance Check ID\"},\"type\":{\"description\":\"The type of Compliance Check\",\"allOf\":[{\"$ref\":\"#/components/schemas/ComplianceCheckTypeEnum\"}]},\"status\":{\"description\":\"The status of the Compliance Check\",\"allOf\":[{\"$ref\":\"#/components/schemas/ComplianceCheckStatusEnum\"}]},\"checkFrequency\":{\"description\":\"The frequency of the Compliance Check\",\"allOf\":[{\"$ref\":\"#/components/schemas/CheckFrequencyEnum\"}]},\"expiresAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"description\":\"The date when this Compliance Check expires\"},\"lastCheckedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"description\":\"The date when this Compliance Check was last performed\"},\"completionDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"description\":\"The date when this Compliance Check was completed\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"Compliance Check created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"Compliance Check updated date timestamp\"},\"exclusion\":{\"nullable\":true,\"description\":\"Exclusion details for this compliance check, only present when status is EXCLUDED\",\"allOf\":[{\"$ref\":\"#/components/schemas/ComplianceCheckExclusionResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"type\",\"status\",\"checkFrequency\",\"createdAt\",\"updatedAt\"]},\"ComplianceCheckExclusionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Compliance Check Exclusion ID\"},\"reason\":{\"type\":\"string\",\"description\":\"Reason for the Exclusion\",\"example\":\"Employee is on extended leave\"},\"createdById\":{\"type\":\"number\",\"description\":\"ID of the user who created the Exclusion\",\"example\":1},\"createdByEmail\":{\"type\":\"string\",\"description\":\"Email of the user who created the Exclusion\",\"example\":\"user@company.com\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Creation timestamp of the Exclusion\",\"example\":\"2025-07-01T16:45:55.246Z\"},\"startDate\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Start date of the Exclusion\",\"example\":\"2025-07-01T16:45:55.246Z\"},\"endDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"description\":\"End date of the Exclusion\",\"example\":\"2025-07-01T16:45:55.246Z\"}},\"required\":[\"id\",\"reason\",\"createdById\",\"createdByEmail\",\"createdAt\",\"startDate\",\"endDate\"]},\"CheckFrequencyEnum\":{\"type\":\"string\",\"enum\":[\"ONCE\",\"HOURLY\",\"QID\",\"DAILY\",\"WEEKLY\",\"BIWEEKLY\",\"MONTHLY\",\"QUARTERLY\",\"YEARLY\"]},\"ComplianceCheckStatusEnum\":{\"type\":\"string\",\"enum\":[\"MISCONFIGURED\",\"PASS\",\"FAIL\",\"EXCLUDED\"]},\"ComplianceCheckTypeEnum\":{\"type\":\"string\",\"enum\":[\"FULL_COMPLIANCE\",\"ACCEPTED_POLICIES\",\"IDENTITY_MFA\",\"BG_CHECK\",\"AGENT_INSTALLED\",\"PASSWORD_MANAGER\",\"HDD_ENCRYPTION\",\"ANTIVIRUS\",\"AUTO_UPDATES\",\"LOCK_SCREEN\",\"SECURITY_TRAINING\",\"LOCATION_SERVICES\",\"HIPAA_TRAINING\",\"OFFBOARDING\",\"NIST_AI_TRAINING\"]},\"PersonnelResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/PersonResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"PersonnelExpandEnum\":{\"type\":\"string\",\"enum\":[\"customFields\",\"complianceChecks\",\"reasonProvider\",\"user\"]},\"FrameworkRequirementsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/FrameworkRequirementResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"FrameworkRequirementResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Requirement was created\"},\"description\":{\"type\":\"string\",\"example\":\"The entity demonstrates a commitment to integrity and ethical values.\",\"description\":\"Requirement description\"},\"frameworkName\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"The framework name this Requirement is associated with\"},\"frameworkPill\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"A pill representing the framework\"},\"frameworkSlug\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"The framework slug this Requirement is associated with\"},\"frameworkTag\":{\"type\":\"string\",\"example\":\"SOC_2\",\"description\":\"The framework tag this Requirement is associated with\"},\"id\":{\"type\":\"number\",\"example\":58,\"description\":\"Requirement ID\"},\"name\":{\"type\":\"string\",\"example\":\"PI1.2\",\"description\":\"Requirement name\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Requirement was updated\"},\"additionalInfo\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to integrity.\",\"description\":\"Additional information surrounding the Requirement\"},\"additionalInfo2\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to ethical values.\",\"description\":\"Second additional information surrounding the Requirement\"},\"additionalInfo3\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to enforcing policies.\",\"description\":\"Third additional information surrounding the Requirement\"},\"archivedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Requirement was marked out of scope\"},\"externalId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"SOC 2\",\"description\":\"An external ID associated with this Requirement\"},\"longDescription\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to integrity and ethical values.\",\"description\":\"A long description of the Requirement \"},\"rationale\":{\"type\":\"string\",\"nullable\":true,\"example\":\"This requirement is not needed.\",\"description\":\"Requirement rationale for out of scope.\"},\"controls\":{\"description\":\"Controls mapped to this Requirement. Only included when `expand[]=controls` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/ControlsForRequirementSubcollectionResponsePublicV2Dto\"}]}},\"required\":[\"createdAt\",\"description\",\"frameworkName\",\"frameworkPill\",\"frameworkSlug\",\"frameworkTag\",\"id\",\"name\",\"updatedAt\",\"additionalInfo\",\"additionalInfo2\",\"additionalInfo3\",\"archivedAt\",\"externalId\",\"longDescription\",\"rationale\"]},\"ControlsForRequirementSubcollectionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Array of Controls mapped to this Requirement. Limited to a maximum of 10 items. Ordered by isReady, then by controlNumber.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlForRequirementCompactResponsePublicV2Dto\"}},\"totalCount\":{\"type\":\"number\",\"example\":47,\"description\":\"Total count of all Controls mapped to this Requirement.\"}},\"required\":[\"data\",\"totalCount\"]},\"ControlForRequirementCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Control ID\"},\"code\":{\"type\":\"string\",\"example\":\"DCF-1001\",\"description\":\"Control code\"},\"isReady\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if the Control is ready for compliance assessment. A Control is considered ready when it has at least one valid component (tests, evidence, policies, or reports) and no failing components (no failing tests, invalid evidence, unapproved policies, etc.). This is calculated in real-time based on the current state of all Control components.\"},\"controlNumber\":{\"type\":\"number\",\"example\":1,\"description\":\"Control number used for ordering\"},\"archivedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the control was marked out of scope\"}},\"required\":[\"id\",\"code\",\"isReady\",\"controlNumber\",\"archivedAt\"]},\"FrameworkTagEnum\":{\"type\":\"string\",\"enum\":[\"NONE\",\"SOC_2\",\"ISO27001\",\"CCPA\",\"GDPR\",\"HIPAA\",\"PCI\",\"SCF\",\"NIST80053\",\"NISTCSF\",\"CMMC\",\"NIST800171\",\"MSSSPA\",\"FFIEC\",\"ISO27701\",\"COBIT\",\"SOX_ITGC\",\"ISO270012022\",\"CCM\",\"CYBER_ESSENTIALS\",\"ISO270172015\",\"ISO270182019\",\"FEDRAMP\",\"NISTAI\",\"PCI4\",\"NISTCSF2\",\"NIS2\",\"DORA\",\"ISO420012023\",\"DRATA_ESSENTIALS\",\"NIST800171R3\",\"CIS8\",\"CYBER_ESSENTIALS_32\",\"FEDRAMP20X\",\"HITRUST\",\"MSSSPA11\",\"ESSENTIAL_EIGHT\",\"NYDFS\",\"TISAX\",\"ISO270182025\",\"CCPA2026\",\"ISO277012025\",\"CUSTOM\",\"ALL\"]},\"FrameworkRequirementsExpandEnum\":{\"type\":\"string\",\"enum\":[\"controls\"]},\"FrameworksResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/FrameworkResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"FrameworkResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":123,\"description\":\"Framework ID\"},\"name\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"Framework name\"},\"description\":{\"type\":\"string\",\"example\":\"Report on controls at a Service Organization\",\"description\":\"Framework description\"},\"slug\":{\"type\":\"string\",\"example\":\"soc-2\",\"description\":\"Framework slug used to identify the Framework\"},\"tag\":{\"type\":\"string\",\"example\":\"SOC_2\",\"description\":\"Framework tag\"},\"pill\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"Framework pill label\"},\"numInScopeControls\":{\"type\":\"number\",\"example\":42,\"description\":\"Number of in-scope controls\"},\"numInScopeRequirements\":{\"type\":\"number\",\"example\":42,\"description\":\"Number of in-scope Requirements\"},\"numReadyInScopeRequirements\":{\"type\":\"number\",\"example\":35,\"description\":\"Number of ready in-scope Requirements\"},\"isReady\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if the Framework is ready for compliance assessment\"},\"isEnabled\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if the Framework is enabled\"},\"color\":{\"type\":\"string\",\"example\":\"#174880\",\"description\":\"Framework color\"},\"bgColor\":{\"type\":\"string\",\"example\":\"#E8F4FF\",\"description\":\"Framework background color\"},\"activeLogo\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://cdn.acme.com/frameworks/soc2-active.svg\",\"description\":\"URL of the active logo\"},\"inactiveLogo\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://cdn.acme.com/frameworks/soc2-inactive.svg\",\"description\":\"URL of the inactive logo\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Framework created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Framework last updated date timestamp\"}},\"required\":[\"id\",\"name\",\"description\",\"slug\",\"tag\",\"pill\",\"numInScopeControls\",\"numInScopeRequirements\",\"numReadyInScopeRequirements\",\"isReady\",\"isEnabled\",\"color\",\"bgColor\",\"activeLogo\",\"inactiveLogo\",\"createdAt\",\"updatedAt\"]},\"EvidenceLibraryVersionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":789,\"description\":\"The unique identifier of the version (artifact). Use this value for API operations.\"},\"name\":{\"type\":\"string\",\"nullable\":true,\"example\":\"security-policy.pdf\",\"description\":\"The name of the Artifact\"},\"version\":{\"type\":\"number\",\"example\":1,\"description\":\"Artifact version number (sequential counter)\"},\"current\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if this Artifact is the current version\"},\"filedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Date when the artifact was filed/effective. May differ from `createdAt` for backdated evidence\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The timestamp when the Artifact was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The timestamp when the Artifact was last updated\"},\"downloadUrl\":{\"type\":\"string\",\"format\":\"uri\",\"example\":\"https://s3.amazonaws.com/bucket/file.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256...\",\"description\":\"A time-limited signed URL for downloading the file, only returned when `expand[]=downloadUrl` is passed. Valid for 10 minutes.\",\"nullable\":true}},\"required\":[\"id\",\"name\",\"version\",\"current\",\"filedAt\",\"createdAt\",\"updatedAt\"]},\"EvidenceLibraryVersionExpandEnum\":{\"type\":\"string\",\"enum\":[\"downloadUrl\"]},\"EvidenceLibraryModifyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"base64File\":{\"type\":\"string\",\"example\":\"{\\\"base64String\\\":\\\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg\\\",\\\"filename\\\":\\\"updated-security-certificate.pdf\\\"}\",\"description\":\"Artifact source as Base64-encoded file. When provided, this adds new artifact to the Evidence Library Item, making `filedAt`, `renewalScheduleType`,`renewalDate` (if `renewalScheduleType` is CUSTOM), and `ownerId` (if not already assigned) required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided. JSON string with artifact file in Base64 format (alternative to file upload).\"},\"controlIds\":{\"example\":[1,2,3],\"description\":\"List of control IDs to associate with this Evidence Library Item. Passing any value (including an empty array) will override existing controlIds. Omit this field to leave existing associations unchanged.\",\"nullable\":true,\"type\":\"array\",\"items\":{\"type\":\"number\"}},\"description\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"Updated annual security training completion certificate for all employees\",\"description\":\"Evidence Library Item description\"},\"filedAt\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"The date when the artifact was originally filed/created. Required when adding new artifact (`file`, `base64File`, `url`, or `ticketUrl`). Optional when updating the creation date of an existing artifact.\"},\"file\":{\"type\":\"string\",\"format\":\"binary\",\"description\":\"Artifact source as File. When provided, this adds new artifact to the Evidence Library Item, making `filedAt`, `renewalScheduleType`, `renewalDate` (if `renewalScheduleType` is CUSTOM), and `ownerId` (if not already assigned) required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided.Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .gif, .jpg, .jpeg, .png, .json, .csv, .md, .markdown, .txt, .html, .log, .zip, .msg, .mp4\"},\"implementationGuidance\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"Follow the company security training guidelines and ensure all employees complete the training within 30 days of onboarding.\",\"description\":\"Implementation guidance for this Evidence Library Item\"},\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Updated Security Training Certificate\",\"description\":\"Evidence Library Item name\"},\"ownerId\":{\"type\":\"number\",\"example\":1,\"description\":\"User ID of the Evidence Library Item owner. Can be updated independently at any time. Also required when adding new artifact (`file`, `base64File`, `url`, or `ticketUrl`) if the Evidence Library Item does not already have an owner assigned.\"},\"renewalDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Artifact renewal date. Required when `renewalScheduleType` is CUSTOM. Optional when updating the renewal date of an existing artifact. When `renewalScheduleType` is provided (other than CUSTOM), this date will be calculated automatically from today.\"},\"renewalScheduleType\":{\"example\":\"ONE_YEAR\",\"description\":\"Artifact renewal schedule type. Required when adding new artifact (`file`, `base64File`, `url`, or `ticketUrl`). Optional when updating the renewal schedule of an existing artifact. When provided (except CUSTOM), the renewal date will be calculated automatically from today. Use CUSTOM to set a specific renewal date via the `renewalDate` field.\",\"nullable\":true,\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalScheduleTypeEnum\"}]},\"ticketUrl\":{\"type\":\"string\",\"example\":\"https://acme.jira.com/browse/SEC-1234\",\"description\":\"Artifact source as ticket URL. When provided, this adds new artifact to the Evidence Library Item, making `filedAt`, `renewalScheduleType`, and `ownerId` (if not already assigned) required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided.\",\"nullable\":true},\"url\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://example.com/updated-security-policy\",\"description\":\"Artifact source as URL. When provided, this adds new artifact to the Evidence Library Item, making `filedAt`, `renewalScheduleType`, `renewalDate` (if `renewalScheduleType` is CUSTOM), and `ownerId` (if not already assigned) required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided.\"}}},\"EvidenceLibraryCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Evidence Library Item ID\"},\"name\":{\"type\":\"string\",\"example\":\"Security Policy Document\",\"description\":\"Evidence Library Item name\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"This document outlines our security policies and procedures.\",\"description\":\"Evidence Library Item description\"},\"implementationGuidance\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Follow the company security training guidelines and ensure all employees complete the training within 30 days of onboarding.\",\"description\":\"Implementation guidance for this Evidence Library Item\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Evidence created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Evidence last updated date timestamp\"},\"user\":{\"description\":\"User who created the evidence, only returned when `expand[]=user` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"versions\":{\"example\":[{\"id\":1,\"source\":\"https://example.com/evidence\",\"type\":\"URL\",\"current\":true,\"createdAt\":\"2025-07-01T16:45:55.246Z\"}],\"description\":\"Evidence versions data, only returned when `expand[]=renewalAndVersions` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EvidenceLibraryVersionCompactResponsePublicV2Dto\"}},\"renewalSchema\":{\"description\":\"Renewal schema for the evidence, only returned when `expand[]=renewalAndVersions` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalSchemaCompactResponsePublicV2Dto\"}]},\"controls\":{\"description\":\"Controls associated with this evidence, only returned when `expand[]=controls` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlCompactResponsePublicV2Dto\"}}},\"required\":[\"id\",\"name\",\"description\",\"implementationGuidance\",\"createdAt\",\"updatedAt\"]},\"RenewalSchemaCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Renewal Schema ID\"},\"renewalDate\":{\"type\":\"string\",\"nullable\":true,\"example\":\"2020-07-06\",\"description\":\"Renewal date\"},\"renewalScheduleType\":{\"example\":\"ONE_YEAR\",\"description\":\"The interval the evidence should be renewed on.\",\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalScheduleTypeEnum\"}]}},\"required\":[\"id\",\"renewalDate\",\"renewalScheduleType\"]},\"EvidenceLibraryVersionCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Evidence Library Item Version ID\"},\"source\":{\"type\":\"string\",\"example\":\"https://example.com/evidence\",\"description\":\"Source location or identifier for the evidence version. Contains file paths for uploaded files, URLs for web links, ticket URLs for ticket providers, or file identifiers for cloud storage\"},\"type\":{\"example\":\"URL\",\"description\":\"Evidence storage type indicating where and how the evidence is stored (S3, cloud storage providers, URLs, ticket systems, test results, etc.)\",\"allOf\":[{\"$ref\":\"#/components/schemas/LibraryDocumentVersionTypeEnum\"}]},\"current\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if this is the active version of the evidence. Only one version per evidence can be current at a time. Used to identify the latest/primary version.\"},\"createdAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Evidence version created date\"}},\"required\":[\"id\",\"source\",\"type\",\"current\",\"createdAt\"]},\"LibraryDocumentVersionTypeEnum\":{\"type\":\"string\",\"enum\":[\"URL\",\"S3_FILE\",\"TICKET_PROVIDER\",\"NONE\",\"GOOGLE_DRIVE\",\"ONE_DRIVE\",\"BOX\",\"DROPBOX\",\"SHARE_POINT\",\"TEST_RESULT\"]},\"EvidenceLibraryCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Security Training Certificate\",\"description\":\"Evidence Library Item name\"},\"base64File\":{\"type\":\"string\",\"example\":{\"base64String\":\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg\",\"filename\":\"security-certificate.pdf\"},\"description\":\"Artifact source as Base64-encoded file. When provided, `renewalScheduleType`, `filedAt`, and `ownerId` are required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided. JSON string with artifact file in Base64 format (alternative to file upload).\"},\"controlIds\":{\"nullable\":true,\"example\":[1,2,3],\"description\":\"List of control IDs to associate with this Evidence Library Item\",\"type\":\"array\",\"items\":{\"type\":\"number\"}},\"description\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"Annual security training completion certificate for all employees\",\"description\":\"Evidence Library Item description\"},\"filedAt\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"The date when the artifact was originally filed/created. Required when an artifact source is provided (`file`, `base64File`, `url`, or `ticketUrl`).\"},\"file\":{\"type\":\"string\",\"format\":\"binary\",\"description\":\"Artifact source as file. When provided, `renewalScheduleType`, `filedAt`, and `ownerId` are required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided. Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .gif, .jpg, .jpeg, .png, .json, .csv, .md, .markdown, .txt, .html, .log, .zip, .msg, .mp4\"},\"implementationGuidance\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":30000,\"example\":\"Follow the company security training guidelines and ensure all employees complete the training within 30 days of onboarding.\",\"description\":\"Implementation guidance for this Evidence Library Item\"},\"ownerId\":{\"type\":\"number\",\"example\":1,\"description\":\"User ID of the Evidence Library Item owner. Required when an artifact source is provided (`file`, `base64File`, `url`, or `ticketUrl`).\"},\"renewalDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"Artifact renewal date. Required only when `renewalScheduleType` is CUSTOM. When `renewalScheduleType` is provided (other than CUSTOM), this date will be calculated automatically from today.\"},\"renewalScheduleType\":{\"example\":\"ONE_YEAR\",\"description\":\"Allows the renewal date to be automatically calculated relative to today's date.Use `CUSTOM` to set a specific renewal date via the `renewalDate` field.\",\"allOf\":[{\"$ref\":\"#/components/schemas/RenewalScheduleTypeEnum\"}]},\"ticketUrl\":{\"type\":\"string\",\"example\":\"https://acme.jira.com/browse/SEC-1234\",\"description\":\"Artifact source as ticket URL. When provided, `renewalScheduleType`, `filedAt`, and `ownerId` are required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided.\",\"nullable\":true},\"url\":{\"type\":\"string\",\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://example.com/security-policy\",\"description\":\"Artifact source as URL. When provided, `renewalScheduleType`, `filedAt`, and `ownerId` are required. Only one artifact source (`file`, `base64File`, `url`, or `ticketUrl`) can be provided.\"}},\"required\":[\"name\"]},\"EvidenceLibraryListResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Array of Evidence Library items\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EvidenceLibraryCompactResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"EvidenceStatusEnum\":{\"type\":\"string\",\"enum\":[\"NEEDS_ARTIFACT\",\"ERROR\",\"READY\",\"EXPIRING_SOON\",\"EXPIRED\",\"NEEDS_SOURCE\",\"NEEDS_ATTENTION\"]},\"EvidenceLibraryExpandEnum\":{\"type\":\"string\",\"enum\":[\"user\",\"controls\",\"renewalSchemaAndVersions\"]},\"EventDownloadJobResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"jobId\":{\"type\":\"string\",\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"The unique job ID for tracking the Event PDF download generation\"},\"status\":{\"description\":\"The current status of the event PDF download job\",\"example\":\"Pending\",\"allOf\":[{\"$ref\":\"#/components/schemas/EvidenceJobStatusEnum\"}]},\"result\":{\"type\":\"string\",\"nullable\":true,\"description\":\"The signed URL to download the event PDF (only available when status is `COMPLETED`). URL expires after 10 minutes from generation.\",\"example\":\"https://s3.amazonaws.com/event-pdf.pdf?Signature=ABC123\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Timestamp when the job was created\",\"example\":\"2025-07-01T16:45:55.246Z\"},\"completedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"description\":\"Timestamp when the job was completed (only available when status is `COMPLETED` or `FAILED`)\",\"example\":\"2025-07-01T16:45:55.246Z\"},\"errorMessage\":{\"type\":\"string\",\"description\":\"Error message (only available when status is `FAILED`)\",\"example\":\"Failed to generate event PDF: insufficient permissions\"}},\"required\":[\"jobId\",\"status\",\"result\",\"createdAt\",\"completedAt\"]},\"EvidenceJobStatusEnum\":{\"type\":\"string\",\"enum\":[\"Pending\",\"Running\",\"Completed\",\"Failed\"]},\"EventResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"Event UUID\"},\"type\":{\"description\":\"The type of event\",\"allOf\":[{\"$ref\":\"#/components/schemas/EventTypeEnum\"}]},\"category\":{\"description\":\"The category of event\",\"allOf\":[{\"$ref\":\"#/components/schemas/EventCategoryEnum\"}]},\"source\":{\"description\":\"The source of the event (APP or AUTOPILOT)\",\"allOf\":[{\"$ref\":\"#/components/schemas/EventSourceEnum\"}]},\"description\":{\"type\":\"string\",\"example\":\"Wile E. Coyote updated the company info.\",\"description\":\"The description of the event\"},\"metadata\":{\"type\":\"object\",\"properties\":{\"dto\":{\"type\":\"object\",\"additionalProperties\":true,\"nullable\":true},\"targetEntity\":{\"type\":\"object\",\"additionalProperties\":true,\"nullable\":true},\"targetEntities\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"additionalProperties\":true,\"nullable\":true}},\"fileKey\":{\"type\":\"string\",\"nullable\":true},\"sourceData\":{\"type\":\"object\",\"additionalProperties\":true,\"nullable\":true},\"taskType\":{\"type\":\"number\",\"nullable\":true},\"request\":{\"type\":\"object\",\"additionalProperties\":true,\"nullable\":true},\"response\":{\"type\":\"object\",\"additionalProperties\":true,\"nullable\":true}},\"description\":\"The event metadata in JSON, only returned when `expand[]=metadata` is passed.\"},\"status\":{\"nullable\":true,\"description\":\"The result of the test if the event type is an Autopilot test, otherwise null\",\"allOf\":[{\"$ref\":\"#/components/schemas/CheckResultStatusEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Report created date timestamp\"},\"userId\":{\"type\":\"number\",\"nullable\":true,\"description\":\"The id of the user related to the event\"},\"user\":{\"nullable\":true,\"description\":\"The user related to the event, only returned when `expand[]=user` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]},\"connectionId\":{\"type\":\"number\",\"nullable\":true,\"description\":\"The id of the connection associated to the event\"},\"connection\":{\"nullable\":true,\"description\":\"The associated connection if this event has one, only returned when `expand[]=connection` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/ConnectionCompactResponsePublicV2Dto\"}]},\"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\"},\"testName\":{\"type\":\"string\",\"nullable\":true,\"description\":\"The name of the monitoring test associated with this event, only returned when `expand[]=testName` is passed.\"},\"testId\":{\"type\":\"string\",\"nullable\":true,\"description\":\"The identifier of the monitoring test associated with this event. This value may be duplicated across workspaces. Only returned when `expand[]=testId` is passed.\"},\"issues\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"additionalProperties\":true},\"description\":\"The issues associated to this event, if any, only returned when `expand[]=issues` or `expand[]=metadata` is passed.\"}},\"required\":[\"id\",\"type\",\"category\",\"source\",\"description\",\"status\",\"createdAt\",\"userId\",\"connectionId\",\"requestDescription\"]},\"EventsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/EventResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"EventCategoryEnum\":{\"type\":\"string\",\"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\",\"MULTIPLE_PRODUCT_SUPPORT\",\"PUBLIC_API_KEY\",\"SERVICE_PROVIDER\",\"TASK\",\"AUTOPILOT_RECIPE_SCHEDULE\",\"RESYNC\",\"EVIDENCE\",\"AUTOPILOT_RECIPE\",\"ACCESS_REVIEW\",\"DOCUMENT_SCANNED\",\"CLOUD_STORAGE\",\"VENDOR_PROFILE\",\"CODEBASE\",\"EXCEPTION_MANAGEMENT\",\"WORKFLOWS\",\"CUSTOM_CONNECTION\",\"TRUST_CENTER_REPORTS\",\"OUTBOUND_WEBHOOKS\",\"SAFEBASE_MIGRATION\",\"TRUST_ACCESS_REQUEST\",\"SAFEBASE_ONBOARDING\"]},\"EventSourceEnum\":{\"type\":\"string\",\"enum\":[\"APP\",\"AUTOPILOT\",\"PUBLIC_API\",\"VENDOR_QUESTIONNAIRE\",\"SCHEDULED\",\"WORKFLOW\",\"DRATA_POLICY\"]},\"EventTypeEnum\":{\"type\":\"string\",\"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_LINKED_TO_PERSONNEL\",\"BACKGROUND_UNLINKED_FROM_PERSONNEL\",\"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_REGISTERED_SCORED\",\"RISK_ALL_REGISTERED_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\",\"TICKET_CREATED_CONTROL\",\"TICKET_CREATED_MONITOR_INSTANCE\",\"PRE_APPROVED_DOMAIN_REMOVED\",\"PRE_APPROVED_DOMAIN_ADDED\",\"TICKET_CREATED_RISK\",\"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\",\"TICKET_UNLINKED_CONTROL\",\"TICKET_UNLINKED_MONITOR_INSTANCE\",\"TICKET_UNLINKED_RISK\",\"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_SECURITY_QUESTIONNAIRE_CREATED\",\"VENDOR_SECURITY_QUESTIONNAIRE_UPDATED\",\"VENDOR_SECURITY_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\",\"REVOKE_REQUEST\",\"WIZARD_STEP_SAVED\",\"NON_DISCLOSURE\",\"TASK_CREATED\",\"TASK_DELETED\",\"TASK_COMPLETED\",\"TASK_UNCOMPLETED\",\"TASK_UPDATED\",\"RISK_ASSESSMENT_OWNER_ASSIGNED\",\"RISK_ASSESSMENT_DUE_DATE_SET\",\"PERSONNEL_EXCLUSION_CREATED\",\"PERSONNEL_EXCLUSION_UPDATED\",\"PERSONNEL_EXCLUSION_ARCHIVED\",\"RISKS_DELETED\",\"RESYNC_DATA\",\"AUTOPILOT_SCHEDULE_CREATED\",\"AUTOPILOT_SCHEDULE_UPDATED\",\"AUTOPILOT_SCHEDULE_DELETED\",\"VULNERABILITY_DOWNLOAD_ALL\",\"AUTOPILOT_PERSONNEL_EXCLUSION_ARCHIVED\",\"PRE_APPROVED_EMAIL_REMOVED\",\"PRE_APPROVED_EMAIL_ADDED\",\"EVIDENCE_DELETED\",\"EVIDENCE_CREATED\",\"EVIDENCE_DOWNLOADED\",\"EVIDENCE_UPDATED\",\"EVIDENCE_ASSOCIATED_TO_CONTROL\",\"EVIDENCE_UNASSOCIATED_TO_CONTROL\",\"AUDITOR_ADDED_TO_AUDIT\",\"AUDITOR_REMOVED_FROM_AUDIT\",\"TRUST_CONTENT_SAVED\",\"EVIDENCE_DOWNLOAD_ALL\",\"AUDITHUB_REQUEST_MESSAGE_DELETED\",\"AUTOPILOT_SCHEDULE_REVERTED\",\"AUTOPILOT_RECIPE_CUSTOMIZED\",\"AUTOPILOT_RECIPE_REVERTED\",\"USER_ROLE_CREATED\",\"USER_ROLE_DELETED\",\"RESENT_EVIDENCE_SAMPLE_DOWNLOAD_EMAIL\",\"RESENT_EVIDENCE_SAMPLE_DOWNLOAD_EMAIL_MULTIPLE_WORKSPACE\",\"TICKET_CREATED_APPLICATION_USERS\",\"CUSTOMER_REQUEST_DETAILS_EDITED\",\"FILE_UPLOAD_REJECTED\",\"FILE_UPLOAD_UNSUPPORTED\",\"ACCESS_REVIEW_PERIOD_CREATED\",\"ACCESS_REVIEW_PERIOD_IN_PROGRESS\",\"ACCESS_REVIEW_PERIOD_COMPLETED\",\"ACCESS_REVIEW_APPLICATION_REVIEWER_UPDATED\",\"ACCESS_REVIEW_APPLICATION_REVIEWER_NOTIFIED\",\"PERSONNEL_REVIEW_STATUS_CHANGED\",\"ACCESS_REVIEW_TICKET_LINKED_TO_PERSONNEL\",\"ACCESS_REVIEW_MANUAL_EVIDENCE_UPLOADED\",\"ACCESS_REVIEW_APPLICATION_COMPLETED\",\"CONTROL_APPROVAL_ADDED\",\"CONTROL_APPROVAL_EDITED\",\"CONTROL_APPROVAL_REVIEW_ADDED\",\"CONTROL_APPROVAL_REVIEW_REMOVED\",\"CONTROL_APPROVAL_SENT_TO_APPROVERS\",\"CONTROL_APPROVAL_APPROVE\",\"CONTROL_APPROVAL_REQUEST_CHANGES\",\"CONTROL_APPROVAL_REMOVED\",\"CONTROL_APPROVAL_STATUS_CHANGED\",\"VENDOR_RISK_REPORT_GENERATED\",\"DEVICE_ASSIGNATION_AGENT\",\"DEVICE_ASSIGNATION_AGENT_DELETED\",\"GENERAL_TASK_CREATED\",\"GENERAL_TASK_DELETED\",\"GENERAL_TASK_COMPLETED\",\"GENERAL_TASK_UNCOMPLETED\",\"GENERAL_TASK_UPDATED\",\"CONTROL_TASK_CREATED\",\"CONTROL_TASK_DELETED\",\"CONTROL_TASK_COMPLETED\",\"CONTROL_TASK_UNCOMPLETED\",\"CONTROL_TASK_UPDATED\",\"RISK_TASK_CREATED\",\"RISK_TASK_DELETED\",\"RISK_TASK_COMPLETED\",\"RISK_TASK_UNCOMPLETED\",\"RISK_TASK_UPDATED\",\"CLOUD_FILE_USER_DISCONNECTED\",\"CLOUD_FILE_USER_CONNECTED\",\"DRATA_TO_DRATA_ENABLED\",\"DRATA_TO_DRATA_DISABLED\",\"AUTOPILOT_BACKGROUND_CHECK_LINKED_TO_PERSONNEL\",\"REQUIREMENT_INFO_EDITED\",\"FRAMEWORK_BASELINE_UPDATED\",\"COMPANY_NIST_AI_TRAINING_DATA_UPDATED\",\"NIST_AI_TRAINING_RESET\",\"CONTROL_APPROVAL_APPROVE_WITHOUT_DATELINE\",\"AP_INFRASTRUCTURE_FAILED_BACKUPS_ADDRESSED_IN_TIMELY_MANNER\",\"AP_AUTO_SCALE_SERVER_INSTANCES\",\"AP_INFRASTRUCTURE_CLOUD_DATA_MONITOR_CPU_LOAD\",\"AP_INFRASTRUCTURE_FAILED_BACKUP_ALERTS\",\"AP_INFRASTRUCTURE_CLOUDTRAIL_LOG_FILE_INTEGRITY\",\"POLICY_DETAILS_UPDATED\",\"RISK_SETTINGS_UPDATED\",\"AP_INFRASTRUCTURE_DAILY_BACKUP_JOB_STATUS_MONITORED\",\"AP_INFRASTRUCTURE_SQL_FREEABLE_MEMORY_MONITORED\",\"AP_CUSTOM_TEST\",\"AP_DRAFT_TEST\",\"USER_ROLE_RESTRICTED\",\"USER_ROLE_UNRESTRICTED\",\"CONTROL_APPROVAL_SCHEDULED\",\"CONTROL_APPROVAL_SCHEDULED_FAILED\",\"CONTROL_TEMPLATE_APPLIED\",\"CONTROL_INFORMATION_LINKED_ACROSS_OTHER_WORKSPACES\",\"CONTROL_INFORMATION_UNLINKED_FROM_OTHER_WORKSPACES\",\"FORCE_SYNC_ON_SOME\",\"USER_IDENTITY_ACCESS_REVIEW_LINK_UPDATED\",\"FRAMEWORK_SAQ_UPDATED\",\"SPECIAL_FORMER_PERSONNEL_ADDED\",\"AP_ENCRYPTION_IN_TRANSIT\",\"AP_EXCESSIVE_PRIVILEGES_ASSIGNED\",\"AP_EXTERNAL_EXPOSURE_OF_CLOUD_RESOURCES\",\"CONTROL_TEST_INSTANCE_DRAFT_TEST_CREATED\",\"CONTROL_TEST_INSTANCE_CUSTOM_TEST_EDITED\",\"CONTROL_TEST_INSTANCE_DRAFT_TEST_DELETED\",\"CONTROL_TEST_INSTANCE_DRAFT_TEST_PUBLISHED\",\"CONTROL_TEST_INSTANCE_DRAFT_TEST_LOGIC_EDITED\",\"HIPAA_TRAINING_UPDATED\",\"NIST_AI_TRAINING_UPDATED\",\"CONTROL_TEST_INSTANCE_PUBLISH_TEST_DELETED\",\"CODE_REPOSITORY_ADDED\",\"CODE_REPOSITORY_REMOVED\",\"CODE_REPOSITORY_SETTINGS_UPDATED\",\"AUTO_RESET_SETTING_UPDATED\",\"VENDOR_QUESTIONNAIRE_ANSWER_SAVED\",\"CUSTOM_FIELD_CREATED\",\"CUSTOM_FIELD_DELETED\",\"CUSTOM_FIELD_UPDATED\",\"CUSTOM_FIELD_PLACED\",\"CUSTOM_FIELD_UNPLACED\",\"CUSTOM_FIELD_SECTION_UPDATED\",\"CUSTOM_FORMULA_CALCULATED\",\"CUSTOM_FORMULA_CREATED\",\"CUSTOM_FORMULA_DELETED\",\"CUSTOM_FORMULA_UPDATED\",\"AP_INFRASTRUCTURE_IAM_PASSWORD_MINIMUM_LENGTH\",\"AP_INFRASTRUCTURE_BUCKET_ACCESS_LOGGING\",\"AP_INFRASTRUCTURE_RDS_MINIMUM_VERSION_UPGRADE\",\"AP_INFRASTRUCTURE_CMK_ROTATION\",\"AP_INFRASTRUCTURE_IAM_PASSWORD_REUSE\",\"VULNERABILITY_SLA_SETTING_CREATED\",\"VULNERABILITY_SLA_SETTING_UPDATED\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED\",\"AP_VULNERABILITY_HIGH_ADDRESSED\",\"FINDING_EXCLUDED\",\"FINDING_INCLUDED\",\"PROVIDER_CONNECTION_ERROR\",\"RISKS_DOWNLOADED\",\"RISKS_FILTERED_VIEW_DOWNLOADED\",\"AP_INFRASTRUCTURE_IAM_ACCESS_KEY_ROTATION\",\"AP_INFRASTRUCTURE_MFA_FOR_ROOT_ACCOUNT\",\"AP_INFRASTRUCTURE_EBS_VOLUME_ENCRYPTION\",\"AP_INFRASTRUCTURE_HARDWARE_MFA_FOR_ROOT_ACCOUNT\",\"AP_INFRASTRUCTURE_VPC_FLOW_LOGGING\",\"AP_INFRASTRUCTURE_S3_HTTP_REQUEST_DENIED\",\"AP_INFRASTRUCTURE_IAM_GROUP_BASED_ACCESS_CONTROL\",\"AP_INFRASTRUCTURE_IAM_UNUSED_CREDENTIALS\",\"AP_INFRASTRUCTURE_CLOUD_TRAIL_LOGS_ENCRYPTED\",\"AP_INFRASTRUCTURE_IAM_PRINCIPLE_OF_LEAST_PRIVILEGE\",\"AP_INFRASTRUCTURE_SECURITY_GROUPS_RESTRICT_PUBLIC_RDP_ACCESS\",\"AP_INFRASTRUCTURE_S3_OBJECT_LEVEL_LOGGING_FOR_RW_EVENTS\",\"AP_INFRASTRUCTURE_EFS_ENCRYPTED_AT_REST\",\"AP_INFRASTRUCTURE_RDS_PUBLIC_ACCESS_RESTRICTED\",\"AP_INFRASTRUCTURE_VPC_DEFAULT_SECURITY_GROUPS_RESTRICT_ALL_TRAFFIC\",\"AP_INFRASTRUCTURE_ACLS_PUBLIC_REMOTE_ADMIN_ACCESS_RESTRICTED\",\"CUSTOMER_REQUEST_DETAILS_EDITED_MULTIPLE_WORKSPACES\",\"FRAMEWORK_AUDIT_DETAILS_EDITED_MULTIPLE_WORKSPACES\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_SNYK\",\"AP_VULNERABILITY_HIGH_ADDRESSED_SNYK\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_TENABLE_VULNERABILITY_MANAGEMENT\",\"AP_VULNERABILITY_HIGH_ADDRESSED_TENABLE_VULNERABILITY_MANAGEMENT\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_QUALYS\",\"AP_VULNERABILITY_HIGH_ADDRESSED_QUALYS\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_SEMGREP\",\"AP_VULNERABILITY_HIGH_ADDRESSED_SEMGREP\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_SENTINEL_ONE_VMS\",\"AP_VULNERABILITY_HIGH_ADDRESSED_SENTINEL_ONE_VMS\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_CROWDSTRIKE_FALCON_EXPOSURE_MANAGEMENT\",\"AP_VULNERABILITY_HIGH_ADDRESSED_CROWDSTRIKE_FALCON_EXPOSURE_MANAGEMENT\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_MS_DEFENDER\",\"AP_VULNERABILITY_HIGH_ADDRESSED_MS_DEFENDER\",\"EVIDENCE_BULK_DELETED\",\"CONTROL_EVIDENCE_DOWNLOADED\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_RAPID7_VMS\",\"AP_VULNERABILITY_HIGH_ADDRESSED_RAPID7_VMS\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_SENTINELONE_SINGULARITY_VULNERABILITY_MANAGEMENT\",\"AP_VULNERABILITY_HIGH_ADDRESSED_SENTINELONE_SINGULARITY_VULNERABILITY_MANAGEMENT\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_MS_DEFENDER_VMS\",\"AP_VULNERABILITY_HIGH_ADDRESSED_MS_DEFENDER_VMS\",\"AP_INFRASTRUCTURE_CLASSIC_LOAD_BALANCER_LATENCY_MONITORED\",\"AP_INFRASTRUCTURE_CLASSIC_LOAD_BALANCER_SERVER_ERRORS_MONITORED\",\"AP_INFRASTRUCTURE_APPLICATION_LOAD_BALANCER_UNHEALTHY_HOSTS_MONITORED\",\"AP_INFRASTRUCTURE_CLASSIC_LOAD_BALANCER_UNHEALTHY_HOSTS_MONITORED\",\"AP_INFRASTRUCTURE_APPLICATION_LOAD_BALANCER_SERVER_ERRORS_MONITORED\",\"AP_INFRASTRUCTURE_APPLICATION_LOAD_BALANCER_TARGET_RESPONSE_TIME_MONITORED\",\"AP_INFRASTRUCTURE_APPLICATION_LOAD_BALANCER_REDIRECTS_HTTP_TO_HTTPS\",\"AP_INFRASTRUCTURE_LAMBDA_ERROR_RATE_MONITORED\",\"AP_INFRASTRUCTURE_EC2_INSTANCES_IMDSV1_DISABLED\",\"AP_INFRASTRUCTURE_SECURITY_GROUPS_HTTP_ACCESS_RESTRICTED\",\"AP_INFRASTRUCTURE_DATABASE_WRITES_IO_MONITORED\",\"AP_INFRASTRUCTURE_DYNAMODB_POINT_IN_TIME_ENABLED\",\"CAC_CODE_REVIEW_REQUESTED\",\"EXCEPTION_WORKFLOW_CREATED\",\"EXCEPTION_WORKFLOW_DELETED\",\"EXCEPTION_WORKFLOW_UPDATED\",\"EXCEPTION_REQUEST_CREATED\",\"RISK_SET_ACTIVE\",\"RISK_ARCHIVED\",\"RISK_ADDED_FROM_LIBRARY\",\"NOTIFICATION_WORKFLOW_CREATED\",\"WORKFLOW_PUBLISHED\",\"WORKFLOW_UNPUBLISHED\",\"WORKFLOW_DELETED\",\"WORKFLOW_ARCHIVED\",\"WORKFLOW_RESTORED\",\"WORKFLOW_DRAFT_SAVED\",\"RISK_CLOSED\",\"ENTITLEMENT_ENABLED\",\"ENTITLEMENT_DISABLED\",\"PROVIDER_WORKSPACE_CONNECTION_CREATED\",\"PROVIDER_WORKSPACE_CONNECTION_REMOVED\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_CREATE_POLICY_ASSIGNMENT\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_DELETE_POLICY_ASSIGNMENT\",\"AP_INFRASTRUCTURE_NSG_SSH_PUBLIC_ACCESS_RESTRICTED\",\"AP_INFRASTRUCTURE_STORAGE_ACCOUNTS_ACCESSED_VIA_PRIVATE_ENDPOINTS\",\"AP_INFRASTRUCTURE_WEB_APP_REDIRECTS_HTTP_TRAFFIC_TO_HTTPS\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_DELETE_PUBLIC_IP_ADDRESS\",\"AP_INFRASTRUCTURE_SQL_SERVERS_AUDITING\",\"AP_INFRASTRUCTURE_STORAGE_ACCOUNTS_SECURE_TLS_CONFIGURATION\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_MANAGE_PUBLIC_IP_ADDRESS_RULE\",\"CUSTOM_DATA_RECORD_REMOVED\",\"AP_INFRASTRUCTURE_AUDIT_LOGS_ENABLED_FOR_EKS_CLUSTER\",\"AP_INFRASTRUCTURE_PUBLIC_ACCESS_TO_CLUSTERS_CONTROL_PLANE_IS_RESTRICTED\",\"AP_INFRASTRUCTURE_PRIVATE_ACCESS_TO_CLUSTERS_CONTROL_PLANE_IS_RESTRICTED\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_MANAGE_NETWORK_SECURITY_GROUP\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_DELETE_NETWORK_SECURITY_GROUP\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_MANAGE_SECURITY_SOLUTION\",\"WORKFLOW_NOTIFICATION_SENT\",\"CUSTOM_RESOURCE_RECORD_CREATED\",\"RISK_MAPPED_TO_CONTROL\",\"RISK_UNMAPPED_FROM_CONTROL\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_ARNICA\",\"AP_VULNERABILITY_HIGH_ADDRESSED_ARNICA\",\"CUSTOM_RESOURCE_RECORD_UPDATED\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_DELETE_SECURITY_SOLUTION\",\"AP_INFRASTRUCTURE_POSTGRESQL_DATABASE_SERVER_LOG_CHECKPOINTS\",\"NEW_REPORT\",\"MAPPED_TESTS_RESET_ON_CONTROL\",\"CUSTOM_RESOURCE_RECORD_REMOVED\",\"ARTIFACT_BULK_DELETED\",\"EVIDENCE_BULK_OWNER_UPDATE\",\"MAPPED_POLICIES_RESET_ON_CONTROL\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_AIKIDO\",\"AP_VULNERABILITY_HIGH_ADDRESSED_AIKIDO\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_WIZ_VMS\",\"AP_VULNERABILITY_HIGH_ADDRESSED_WIZ_VMS\",\"AP_VULNERABILITY_HIGH_ADDRESSED_WIZ_CODE\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_WIZ_CODE\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_CREATE_OR_UPDATE_SQL_SERVER_FIREWALL_RULE\",\"AP_INFRASTRUCTURE_KEY_VAULTS_KEY_EXPIRATION\",\"AP_INFRASTRUCTURE_LOG_ALERT_FOR_DELETE_SQL_SERVER_FIREWALL_RULE\",\"AP_INFRASTRUCTURE_SQL_DATA_ENCRYPTION\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_MS_DEFENDER_VMS_GCC_HIGH\",\"AP_VULNERABILITY_HIGH_ADDRESSED_MS_DEFENDER_VMS_GCC_HIGH\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_ORCA_SECURITY\",\"AP_VULNERABILITY_HIGH_ADDRESSED_ORCA_SECURITY\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_UPWIND\",\"AP_VULNERABILITY_HIGH_ADDRESSED_UPWIND\",\"AP_VULNERABILITY_CRITICAL_ADDRESSED_GITLAB_VMS\",\"AP_VULNERABILITY_HIGH_ADDRESSED_GITLAB_VMS\",\"POLICY_VERSION_STATUS_DRAFT_CREATED\",\"POLICY_VERSION_STATUS_DRAFT_FINALIZED\",\"POLICY_VERSION_APPROVED\",\"POLICY_VERSION_PUBLISHED\",\"POLICY_VERSION_MODIFIED_RESTARTED_APPROVAL\",\"POLICY_DELETED\",\"POLICY_VERSION_ALERT_CONFIGURED\",\"POLICY_VERSION_STATUS_DRAFT_DELETED\",\"POLICY_VERSION_AUTO_ACKNOWLEDGMENT\",\"POLICY_OWNER_UPDATED\",\"FRAMEWORK_ENABLED\",\"FRAMEWORK_DISABLED\",\"CONTROLS_DISABLED\",\"CONTROLS_ARCHIVED\",\"POLICY_RENEW_WITHOUT_UPDATE\",\"POLICY_VERSION_REQUEST_CHANGES\",\"POLICY_VERSION_MODIFIED_NO_REQUIRED_APPROVAL\",\"POLICY_VERSION_APPROVED_BY_APPROVER\",\"POLICY_VERSION_DRAFT_FINALIZED\",\"POLICY_VERSION_APPROVAL_SETTINGS_UPDATED\",\"FRAMEWORK_LEVEL_IMPACT_UPDATED\",\"POLICY_VERSION_APPROVED_BY_APPROVER_TIER\",\"POLICY_VERSION_APPROVAL_OVERRIDE\",\"REQUEST_MESSAGE_SENT\",\"REQUEST_STATUS_CHANGED\",\"POLICY_VERSION_STATUS_CANCEL_APPROVAL\",\"WORKSPACE_DELETED\",\"GENERAL_TASK_RECURRING_DELETED\",\"CONTROL_TASK_RECURRING_DELETED\",\"RISK_TASK_RECURRING_DELETED\",\"TASK_RECURRING_DELETED\",\"WORKFLOW_WEBHOOK_SENT\",\"VENDOR_SECURITY_REVIEW_STARTED\",\"VENDOR_SECURITY_REVIEW_COMPLETED\",\"VENDOR_SECURITY_REVIEW_APPROVAL_STATUS_CHANGED\",\"VENDOR_SOC_REPORT_REVIEW_STARTED\",\"VENDOR_SOC_REPORT_REVIEW_COMPLETED\",\"VENDOR_SOC_REPORT_REVIEW_APPROVAL_STATUS_CHANGED\",\"CONTROLS_UNARCHIVED\",\"SAFEBASE_SYNC_PENDING\",\"SAFEBASE_SYNC_ERROR\",\"SAFEBASE_SYNC_COMPLETE\",\"SAFEBASE_MIGRATION_PENDING\",\"SAFEBASE_MIGRATION_MIGRATED\",\"SAFEBASE_MIGRATION_ERROR\",\"SAFEBASE_MIGRATION_COMPLETE\",\"TRUST_CENTER_INGRESS_DENIED\",\"CONNECTION_IDP_RANKING_UPDATED\",\"MONITOR_FINDINGS_ZIP_GENERATED\",\"MONITOR_FINDINGS_CSV_GENERATED\",\"FILE_UPLOAD_SIZE_EXCEEDED\",\"PASSWORD_PROTECTED_FILE\",\"COMPANY_OPT_IN_AI\",\"RISK_REGISTER_CREATED\",\"RISK_REGISTER_UPDATED\",\"RISK_REGISTER_DELETED\",\"SAFEBASE_ONBOARDING_ERROR\",\"SAFEBASE_ONBOARDING_CONFLICT\",\"SAFEBASE_ONBOARDING_COMPLETED\",\"RISKS_MOVED_TO_REGISTER\",\"CONNECTION_HRIS_RANKING_UPDATED\",\"EVIDENCE_BULK_RENEWAL_DATE_UPDATE\",\"AGENTIC_INITIAL_ASSESSMENT_REVIEW_COMPLETED\",\"VENDOR_SECURITY_REVIEW_EXECUTIVE_SUMMARY_GENERATED\",\"VENDOR_RECURRING_SECURITY_REVIEW_STARTED\",\"AI_VERSION_COMPARISON_GENERATED\",\"AP_INFRASTRUCTURE_AUTO_SCALING\",\"AP_INFRASTRUCTURE_BACKUP_RETENTION\",\"AP_INFRASTRUCTURE_TDE_ENABLED\",\"AP_INFRASTRUCTURE_VERSIONING_ENABLED\",\"AP_INFRASTRUCTURE_ZONE_REDUNDANCY\",\"AP_INFRASTRUCTURE_LOGGING_ENABLED\",\"AP_INFRASTRUCTURE_TLS_VERSION\",\"AP_INFRASTRUCTURE_VPC_CONFIGURATION\",\"AP_INFRASTRUCTURE_ENCRYPTION_IN_TRANSIT\",\"AP_INFRASTRUCTURE_SECURITY_GROUPS\",\"AP_INFRASTRUCTURE_BROAD_NETWORK_ACCESS_PATTERNS\",\"AP_INFRASTRUCTURE_PUBLIC_ACCESS_RESTRICTED\",\"AP_INFRASTRUCTURE_DENY_BY_DEFAULT\",\"AP_INFRASTRUCTURE_AUTOMATIC_SOFTWARE_UPDATES\",\"AP_INFRASTRUCTURE_LOG_INTEGRITY\",\"AP_INFRASTRUCTURE_TLS_CIPHERS\",\"AP_INFRASTRUCTURE_WAF_ENABLED\",\"AP_INFRASTRUCTURE_AUTOMATED_BACKUPS\",\"AP_INFRASTRUCTURE_SECURE_API_VERSION\",\"AP_INFRASTRUCTURE_LOG_RETENTION\",\"AP_INFRASTRUCTURE_DISABLE_DEFAULT_ACCOUNTS\",\"FRAMEWORK_CONTROL_MAPPING_RESET\",\"MAPPED_CONTROLS_RESET_ON_REQUIREMENT\",\"MAPPED_REQUIREMENTS_RESET_ON_CONTROL\",\"AUTOPILOT_USER_DELETED_ROLE\",\"AP_INFRASTRUCTURE_BROAD_POLICY_ACCESS_PATTERNS\",\"AP_INFRASTRUCTURE_RBAC\",\"AP_INFRASTRUCTURE_RUNTIME_CONFIGURATION\",\"AP_INFRASTRUCTURE_TAGGING\",\"AP_INFRASTRUCTURE_DELETION_PROTECTION\",\"AP_INFRASTRUCTURE_DATA_RETENTION\",\"AP_INFRASTRUCTURE_KEY_ROTATION\",\"AP_INFRASTRUCTURE_SECRET_ROTATION\",\"TICKET_DOWNLOAD\",\"AP_INFRASTRUCTURE_AUTOMATIC_REPAIRS\",\"AP_INFRASTRUCTURE_CONNECTION_DRAINING\",\"AP_INFRASTRUCTURE_HIGH_AVAILABILITY\",\"AP_INFRASTRUCTURE_POLICY_BASED_ACCESS_CONTROL\"]},\"EventExpandEnum\":{\"type\":\"string\",\"enum\":[\"connection\",\"issues\",\"metadata\",\"testId\",\"testName\",\"user\"]},\"EventSortTypeLimitedEnum\":{\"type\":\"string\",\"enum\":[\"createdAt\"]},\"DeviceResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Device Id\"},\"assetId\":{\"type\":\"number\",\"nullable\":true,\"example\":123,\"description\":\"Asset Id\"},\"osVersion\":{\"type\":\"string\",\"nullable\":true,\"example\":\"MacOS 10.15.6\",\"description\":\"The device operating system version\"},\"serialNumber\":{\"type\":\"string\",\"nullable\":true,\"example\":\"C02T6CDJGTFL\",\"description\":\"The device serial number\"},\"model\":{\"type\":\"string\",\"nullable\":true,\"example\":\"MacBook Pro\",\"description\":\"The device model\"},\"macAddress\":{\"type\":\"string\",\"nullable\":true,\"example\":\"65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E\",\"description\":\"The device MAC address\"},\"lastCheckedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Last time device data checked by the source\"},\"sourceType\":{\"example\":\"AGENT\",\"description\":\"The device source type\",\"allOf\":[{\"$ref\":\"#/components/schemas/MobileDeviceManagementSourceTypeEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The device created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The device updated date timestamp\"},\"deletedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The device deleted date timestamp\"},\"appsCount\":{\"type\":\"number\",\"nullable\":true,\"example\":20,\"description\":\"The number of applications installed\"},\"isDeviceCompliant\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Indicates whether the Device meets all compliance requirements, only returned when `expand[]=complianceChecks` is passed.\"},\"complianceChecks\":{\"example\":[],\"description\":\"The Device compliance checks list, only returned when `expand[]=complianceChecks` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceComplianceCheckResponsePublicV2Dto\"}},\"identifiers\":{\"example\":[],\"description\":\"The Device identifiers list, only returned when `expand[]=identifiers` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceIdentifierResponsePublicV2Dto\"}},\"documents\":{\"example\":[],\"description\":\"The Device documents list, only returned when `expand[]=documents` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceDocumentResponsePublicV2Dto\"}},\"screenLockTime\":{\"type\":\"number\",\"nullable\":true,\"example\":30,\"description\":\"Denotes device actual screenLock time\"},\"screenLockExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":{\"minutesIdleBeforeSleep\":\"2\",\"minutesSleepingBeforePasswordIsRequired\":\"2\"},\"description\":\"Screen lock explanation\"},\"antivirusEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual antivirus status\"},\"antivirusExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"No matching app was found\",\"description\":\"Antivirus explanation\"},\"autoUpdateEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual auto-update status\"},\"autoUpdateExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"No compliances found\",\"description\":\"Auto update explanation\"},\"passwordManagerEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual password manager status\"},\"passwordManagerExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":{\"passwordManagerApps\":[\"1password 7\"]},\"description\":\"Password manager explanation\"},\"encryptionEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"Denotes device actual encryption status\"},\"encryptionExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"No encryption provided\",\"description\":\"Encryption explanation\"},\"firewallEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual firewall status\"},\"firewallExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"{}\",\"description\":\"Firewall explanation\"},\"asset\":{\"nullable\":true,\"description\":\"The Asset associated with this Device, only returned when `expand[]=asset` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/AssetCompactResponsePublicV2Dto\"}]},\"userId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"User Id\"},\"personnelId\":{\"type\":\"number\",\"example\":1,\"description\":\"Personnel Id\"},\"externalId\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"Unique identifier for the device in the external system where it originated\"}},\"required\":[\"id\",\"assetId\",\"osVersion\",\"serialNumber\",\"model\",\"macAddress\",\"lastCheckedAt\",\"sourceType\",\"createdAt\",\"updatedAt\",\"deletedAt\",\"appsCount\",\"screenLockTime\",\"screenLockExplanation\",\"antivirusEnabled\",\"antivirusExplanation\",\"autoUpdateEnabled\",\"autoUpdateExplanation\",\"passwordManagerEnabled\",\"passwordManagerExplanation\",\"encryptionEnabled\",\"encryptionExplanation\",\"firewallEnabled\",\"firewallExplanation\",\"personnelId\",\"externalId\"]},\"AssetCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Assessment ID\"},\"name\":{\"type\":\"string\",\"example\":\"MacBook Pro - Space Black 16-inch\",\"description\":\"The name of the asset\"},\"description\":{\"type\":\"string\",\"example\":\"MacBook Pro Space Black - with 16-inch Liquid Retina XDR display\",\"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\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the asset was approved (if applicable)\"},\"removedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the asset stopped being tracked\"},\"company\":{\"type\":\"string\",\"example\":\"Acme, Inc\",\"description\":\"The owning company of the asset\"},\"notes\":{\"type\":\"string\",\"nullable\":true,\"description\":\"The asset notes\"},\"assetReferenceType\":{\"type\":\"string\",\"nullable\":true,\"example\":\"PERSONNEL\",\"description\":\"The asset reference type\"},\"uniqueId\":{\"type\":\"string\",\"example\":\"C02T6CDJGTFL\",\"description\":\"Unique Id associated with this asset\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"asset created timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"asset update timestamp\"},\"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\",\"company\",\"assetReferenceType\",\"uniqueId\",\"createdAt\",\"updatedAt\"]},\"DeviceIdentifierResponsePublicV2Dto\":{\"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\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Identifier createdAt timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Identifier updatedAt timestamp\"}},\"required\":[\"id\",\"type\",\"identifier\",\"createdAt\",\"updatedAt\"]},\"DeviceComplianceCheckResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"checkFrequency\":{\"example\":\"DAILY\",\"description\":\"How often should this check be run for Compliance\",\"allOf\":[{\"$ref\":\"#/components/schemas/CheckFrequencyEnum\"}]},\"completionDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the user completed the Compliance Check\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Compliance Check creation timestamp\"},\"expiresAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this Compliance Check is due for a re-verification\"},\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Device Compliance Check ID\"},\"lastCheckedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Compliance Check last checked timestamp\"},\"status\":{\"example\":\"PASS\",\"description\":\"Denotes actual Compliance Check status\",\"allOf\":[{\"$ref\":\"#/components/schemas/ComplianceCheckStatusEnum\"}]},\"type\":{\"example\":\"PASSWORD_MANAGER\",\"description\":\"The Compliance Check type\",\"allOf\":[{\"$ref\":\"#/components/schemas/ComplianceCheckTypeEnum\"}]},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Compliance Check updated timestamp\"}},\"required\":[\"checkFrequency\",\"completionDate\",\"createdAt\",\"expiresAt\",\"id\",\"lastCheckedAt\",\"status\",\"type\",\"updatedAt\"]},\"DeviceCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"personnelId\":{\"description\":\"Personnel integer ID or user's email address prefixed with `email:`\",\"oneOf\":[{\"type\":\"number\",\"example\":1,\"description\":\"Personnel ID\"},{\"type\":\"string\",\"example\":\"email:user@example.com\",\"description\":\"Email of the Personnel's User, prefixed with 'email:'\"}]},\"alias\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"danielm-01\",\"description\":\"Name of the device.\"},\"antivirusEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Flag to indicate antivirus software is installed and enabled\"},\"antivirusExplanation\":{\"type\":\"object\",\"example\":{\"antivirusApps\":[\"Crowdstrike windows sensor\"]},\"description\":\"Any additional information to explain the antivirusEnabled value\"},\"appList\":{\"description\":\"List of installed applications\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/AppTypeRequestPublicV2Dto\"}},\"autoUpdateEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Flag to indicate auto-update enabled or disabled\"},\"autoUpdateExplanation\":{\"type\":\"object\",\"example\":\"Disabled\",\"description\":\"Any additional information to explain the autoUpdateEnabled value\"},\"browserExtensions\":{\"description\":\"List of installed browser extensions\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/AppTypeRequestPublicV2Dto\"}},\"externalId\":{\"type\":\"string\",\"example\":\"cbd51402-2da0-4e97-9c69-6daaef50a715\",\"description\":\"An externally-sourced unique identifier for a device\"},\"firewallEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Flag to indicate the firewall is enabled or disabled\"},\"firewallExplanation\":{\"type\":\"object\",\"example\":\"On\",\"description\":\"Any additional information to explain the firewallEnabled value\"},\"passwordManagerEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Flag to indicate a password manager is in use\"},\"encryptionEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Flag to indicate hard disk is encrypted\"},\"encryptionExplanation\":{\"type\":\"object\",\"example\":{\"bootPartitionEncryptionDetails\":{\"partitionFileVault2Percent\":100,\"partitionFileVault2State\":\"ENCRYPTED\",\"partitionName\":\"Macintosh HD (Boot Partition)\"}},\"description\":\"Any additional information to explain the encryptionEnabled value\"},\"model\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Mac16,1\",\"description\":\"Hardware model\"},\"serialNumber\":{\"type\":\"string\",\"example\":\"BKH8RXT4T9\",\"description\":\"Hardware serial number\"},\"macAddress\":{\"type\":\"string\",\"nullable\":true,\"example\":\"01-23-45-67-89-AB\",\"description\":\"MAC address\"},\"passwordManagerExplanation\":{\"type\":\"object\",\"example\":{\"passwordManagerApps\":[\"1password\"]},\"description\":\"Any additional information to explain the hasPasswordManager value\"},\"platformName\":{\"example\":\"MACOS\",\"description\":\"The Operating System (OS) platform name of the device\",\"allOf\":[{\"$ref\":\"#/components/schemas/AgentPlatformEnum\"}]},\"platformVersion\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The Operating System (OS) platform version of the device\"},\"screenLockEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Flag to indicate hard disk is encrypted\"},\"screenLockExplanation\":{\"type\":\"object\",\"example\":\"ScreenLock delay is immediate\",\"description\":\"Any additional information to explain the screenLockTime value\"},\"screenLockTime\":{\"type\":\"number\",\"example\":15,\"description\":\"Amount of time before display is turned off\"},\"windowsServices\":{\"description\":\"List of applicable Windows services\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/WindowsServiceRequestPublicV2Dto\"}}},\"required\":[\"personnelId\",\"platformName\",\"platformVersion\"]},\"WindowsServiceRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"description\":{\"type\":\"string\",\"example\":\"Security feature that monitors and controls network traffic entering and exiting the device\",\"description\":\"Windows service description.\"},\"name\":{\"type\":\"string\",\"example\":\"Windows Firewall\",\"description\":\"Windows service name\"},\"startType\":{\"type\":\"string\",\"example\":\"Automatic\",\"description\":\"Windows service\"},\"status\":{\"type\":\"string\",\"example\":\"Running\",\"description\":\"Windows service status\"}},\"required\":[\"description\",\"name\",\"startType\",\"status\"]},\"AgentPlatformEnum\":{\"type\":\"string\",\"enum\":[\"MACOS\",\"WINDOWS\",\"LINUX\",\"UNIX\",\"ANDROID\"]},\"AppTypeRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Microsoft Defender Antivirus\",\"description\":\"Name of application\"},\"version\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"1.421.12.0\",\"description\":\"Version of application\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Microsoft Defender Antivirus\",\"description\":\"Protects against new malware and attack techniques.\"}},\"required\":[\"name\",\"version\"]},\"DeviceAppsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"The set of installed apps for this device based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceAppResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"DeviceAppResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Installed app Id\"},\"installedApp\":{\"type\":\"string\",\"example\":\"Adobe Photoshop version 3.3 license 1a2b3c4d\",\"description\":\"The app description\"}},\"required\":[\"id\",\"installedApp\"]},\"DeviceResponseIdPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Device Id\"},\"assetId\":{\"type\":\"number\",\"nullable\":true,\"example\":123,\"description\":\"Asset Id\"},\"osVersion\":{\"type\":\"string\",\"nullable\":true,\"example\":\"MacOS 10.15.6\",\"description\":\"The device operating system version\"},\"serialNumber\":{\"type\":\"string\",\"nullable\":true,\"example\":\"C02T6CDJGTFL\",\"description\":\"The device serial number\"},\"model\":{\"type\":\"string\",\"nullable\":true,\"example\":\"MacBook Pro\",\"description\":\"The device model\"},\"macAddress\":{\"type\":\"string\",\"nullable\":true,\"example\":\"65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E\",\"description\":\"The device MAC address\"},\"lastCheckedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Last time device data checked by the source\"},\"sourceType\":{\"example\":\"AGENT\",\"description\":\"The device source type\",\"allOf\":[{\"$ref\":\"#/components/schemas/MobileDeviceManagementSourceTypeEnum\"}]},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The device created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The device updated date timestamp\"},\"deletedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"The device deleted date timestamp\"},\"appsCount\":{\"type\":\"number\",\"nullable\":true,\"example\":20,\"description\":\"The number of applications installed\"},\"isDeviceCompliant\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Indicates whether the Device meets all compliance requirements, only returned when `expand[]=complianceChecks` is passed.\"},\"complianceChecks\":{\"example\":[],\"description\":\"The Device compliance checks list, only returned when `expand[]=complianceChecks` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceComplianceCheckResponsePublicV2Dto\"}},\"identifiers\":{\"example\":[],\"description\":\"The Device identifiers list, only returned when `expand[]=identifiers` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceIdentifierResponsePublicV2Dto\"}},\"documents\":{\"example\":[],\"description\":\"The Device documents list, only returned when `expand[]=documents` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceDocumentResponsePublicV2Dto\"}},\"screenLockTime\":{\"type\":\"number\",\"nullable\":true,\"example\":30,\"description\":\"Denotes device actual screenLock time\"},\"screenLockExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":{\"minutesIdleBeforeSleep\":\"2\",\"minutesSleepingBeforePasswordIsRequired\":\"2\"},\"description\":\"Screen lock explanation\"},\"antivirusEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual antivirus status\"},\"antivirusExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"No matching app was found\",\"description\":\"Antivirus explanation\"},\"autoUpdateEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual auto-update status\"},\"autoUpdateExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"No compliances found\",\"description\":\"Auto update explanation\"},\"passwordManagerEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual password manager status\"},\"passwordManagerExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":{\"passwordManagerApps\":[\"1password 7\"]},\"description\":\"Password manager explanation\"},\"encryptionEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"Denotes device actual encryption status\"},\"encryptionExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"No encryption provided\",\"description\":\"Encryption explanation\"},\"firewallEnabled\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Denotes device actual firewall status\"},\"firewallExplanation\":{\"type\":\"object\",\"nullable\":true,\"example\":\"{}\",\"description\":\"Firewall explanation\"},\"asset\":{\"nullable\":true,\"description\":\"The Asset associated with this Device, only returned when `expand[]=asset` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/AssetCompactResponsePublicV2Dto\"}]},\"userId\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"User Id\"},\"personnelId\":{\"type\":\"number\",\"example\":1,\"description\":\"Personnel Id\"},\"externalId\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"Unique identifier for the device in the external system where it originated\"},\"apps\":{\"description\":\"Apps associated with the given device, only returned when `expand[]=apps` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceAppResponsePublicV2Dto\"}}},\"required\":[\"id\",\"assetId\",\"osVersion\",\"serialNumber\",\"model\",\"macAddress\",\"lastCheckedAt\",\"sourceType\",\"createdAt\",\"updatedAt\",\"deletedAt\",\"appsCount\",\"screenLockTime\",\"screenLockExplanation\",\"antivirusEnabled\",\"antivirusExplanation\",\"autoUpdateEnabled\",\"autoUpdateExplanation\",\"passwordManagerEnabled\",\"passwordManagerExplanation\",\"encryptionEnabled\",\"encryptionExplanation\",\"firewallEnabled\",\"firewallExplanation\",\"personnelId\",\"externalId\"]},\"DevicesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"MobileDeviceManagementSourceTypeEnum\":{\"type\":\"string\",\"enum\":[\"AGENT\",\"JAMF\",\"INTUNE\",\"KANDJI\",\"JUMPCLOUD\",\"HEXNODE_UEM\",\"UNKNOWN\",\"RIPPLING\",\"WORKSPACE_ONE\",\"KOLIDE\",\"CUSTOM\",\"INTUNE_GCC_HIGH\",\"CUSTOM_XFA\",\"NINJAONE\"]},\"DeviceExpandEnum\":{\"type\":\"string\",\"enum\":[\"asset\",\"complianceChecks\",\"documents\",\"identifiers\"]},\"DeviceDocumentResponsePublicV2Dto\":{\"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\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Device document created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Device document updated date timestamp\"},\"downloadUrl\":{\"description\":\"The signed URL to download the Device Document, only returned when `expand[]=downloadUrl` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/SignedUrlResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"type\",\"name\",\"fileUrl\",\"createdAt\",\"updatedAt\"]},\"DeviceDocumentCreateRequestPublicV2Dto\":{\"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\",\"description\":\"Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .gif, .jpg, .jpeg, .png\"},\"base64File\":{\"type\":\"string\",\"example\":{\"base64String\":\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg\",\"filename\":\"excellent-filename\"},\"description\":\"JSON string with external evidence in Base64 format.\"}},\"required\":[\"type\"]},\"DeviceDocumentsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"documents\":{\"description\":\"Full list of device documents\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/DeviceDocumentResponsePublicV2Dto\"}}},\"required\":[\"documents\"]},\"DeviceDocumentExpandEnum\":{\"type\":\"string\",\"enum\":[\"downloadUrl\"]},\"DeviceDocumentTypeEnum\":{\"type\":\"string\",\"enum\":[\"PASSWORD_MANAGER_EVIDENCE\",\"AUTO_UPDATES_EVIDENCE\",\"HARD_DRIVE_ENCRYPTION_EVIDENCE\",\"ANTIVIRUS_EVIDENCE\",\"LOCK_SCREEN_EVIDENCE\"]},\"CustomUserIdentityUpdateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"email\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"format\":\"email\",\"example\":\"jane.doe@acme.com\",\"description\":\"Primary email address. Used to match this record to an existing Drata user during identity sync.\"},\"secondaryEmail\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"format\":\"email\",\"example\":\"jane.doe@personal.com\",\"description\":\"Secondary email address.\"},\"firstName\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Jane\",\"description\":\"First name.\"},\"lastName\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Doe\",\"description\":\"Last name.\"},\"jobTitle\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Senior Software Engineer\",\"description\":\"Job title.\"},\"managerId\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"emp-050\",\"description\":\"The customer's own identifier for this person's manager. Not a Drata User ID.\"},\"managerName\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Bob Manager\",\"description\":\"Manager's full name.\"},\"startedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2022-03-01T00:00:00.000Z\",\"description\":\"Employment start date.\"},\"separatedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2024-12-31T00:00:00.000Z\",\"description\":\"Employment end date. Set `separatedAt` to indicate the employee has left rather than deleting the record.\"},\"isContractor\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"If `true`, this person is a `CURRENT_CONTRACTOR`; `false` means `CURRENT_EMPLOYEE`. `null` means employment type is `UNKNOWN` — the person will appear as `UNKNOWN` in Drata until an explicit value is provided.\"}}},\"CustomUserIdentityResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1001,\"description\":\"Drata-assigned internal ID. Use this in PUT, DELETE, and single-record GET requests.\"},\"identityId\":{\"type\":\"string\",\"example\":\"emp-001\",\"description\":\"Customer-defined stable identifier (upsert key).\"},\"email\":{\"type\":\"string\",\"nullable\":true,\"format\":\"email\",\"example\":\"jane.doe@acme.com\",\"description\":\"Primary email address.\"},\"secondaryEmail\":{\"type\":\"string\",\"nullable\":true,\"format\":\"email\",\"example\":null,\"description\":\"Secondary email address.\"},\"firstName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Jane\",\"description\":\"First name.\"},\"lastName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Doe\",\"description\":\"Last name.\"},\"jobTitle\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Software Engineer\",\"description\":\"Job title.\"},\"managerId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"emp-050\",\"description\":\"The customer's own identifier for this person's manager. Not a Drata User ID.\"},\"managerName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Bob Manager\",\"description\":\"Manager's full name.\"},\"startedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2022-03-01T00:00:00.000Z\",\"description\":\"Employment start date.\"},\"separatedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":null,\"description\":\"Employment end date.\"},\"isContractor\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"If `true`, this person is a `CURRENT_CONTRACTOR`; `false` means `CURRENT_EMPLOYEE`. `null` means employment type is `UNKNOWN` — the person will appear as `UNKNOWN` in Drata until an explicit value is provided.\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2026-03-26T10:00:00.000Z\",\"description\":\"Record created timestamp.\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2026-03-26T10:00:00.000Z\",\"description\":\"Record last updated timestamp.\"}},\"required\":[\"id\",\"identityId\",\"email\",\"secondaryEmail\",\"firstName\",\"lastName\",\"jobTitle\",\"managerId\",\"managerName\",\"startedAt\",\"separatedAt\",\"isContractor\",\"createdAt\",\"updatedAt\"]},\"CustomUserIdentitiesCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"identities\":{\"minItems\":1,\"description\":\"List of HR user identity records to upsert. All `identityId` values within a single batch must be unique.\",\"maxItems\":300,\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomUserIdentityRecordPublicV2Dto\"}}},\"required\":[\"identities\"]},\"CustomUserIdentityRecordPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"identityId\":{\"type\":\"string\",\"example\":\"emp-001\",\"description\":\"Customer-defined stable identifier for this record (e.g. employee ID, HRIS record ID). Used as the upsert key for batch submissions.\"},\"email\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"format\":\"email\",\"example\":\"jane.doe@acme.com\",\"description\":\"Primary email address. Used to match this record to an existing Drata user during identity sync.\"},\"secondaryEmail\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"format\":\"email\",\"example\":\"jane.doe@personal.com\",\"description\":\"Secondary email address.\"},\"firstName\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Jane\",\"description\":\"First name.\"},\"lastName\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Doe\",\"description\":\"Last name.\"},\"jobTitle\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Software Engineer\",\"description\":\"Job title.\"},\"managerId\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"emp-050\",\"description\":\"The customer's own identifier for this person's manager (e.g. the manager's identityId in the customer's HRIS system). Not a Drata User ID.\"},\"managerName\":{\"type\":\"string\",\"nullable\":true,\"maxLength\":191,\"example\":\"Bob Manager\",\"description\":\"Manager's full name.\"},\"startedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2022-03-01T00:00:00.000Z\",\"description\":\"Employment start date.\"},\"separatedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2024-12-31T00:00:00.000Z\",\"description\":\"Employment end date. Set `separatedAt` to indicate the employee has left rather than deleting the record.\"},\"isContractor\":{\"type\":\"boolean\",\"nullable\":true,\"example\":false,\"description\":\"If `true`, this person is a `CURRENT_CONTRACTOR`; `false` means `CURRENT_EMPLOYEE`. `null` means employment type is `UNKNOWN` — the person will appear as `UNKNOWN` in Drata until an explicit value is provided.\"}},\"required\":[\"identityId\"]},\"CustomUserIdentitiesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"List of HR user identity records based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomUserIdentityResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"ControlsRequirementComparisonResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Array of control requirement comparisons\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlRequirementComparisonResponsePublicV2Dto\"}}},\"required\":[\"data\"]},\"ControlRequirementComparisonResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"controlId\":{\"type\":\"number\",\"example\":123,\"description\":\"Control ID\"},\"alignedRequirements\":{\"description\":\"Requirements found in both tenant and global mappings\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ShortRequirementResponsePublicV2Dto\"}},\"userMappedRequirements\":{\"description\":\"Requirements found only in tenant mappings\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ShortRequirementResponsePublicV2Dto\"}},\"templateMappedRequirements\":{\"description\":\"Requirements found only in global template mappings\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ShortRequirementResponsePublicV2Dto\"}}},\"required\":[\"controlId\",\"alignedRequirements\",\"userMappedRequirements\",\"templateMappedRequirements\"]},\"ShortRequirementResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":123,\"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\"},\"frameworkTag\":{\"type\":\"string\",\"example\":\"SOC_2\",\"description\":\"The framework tag this requirement is associated with\"},\"isOutOfScope\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Whether the requirement is marked as out of scope\"}},\"required\":[\"id\",\"name\",\"description\",\"frameworkTag\",\"isOutOfScope\"]},\"ControlsResetMappingsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"results\":{\"description\":\"Results for each control reset operation\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlResetResultPublicV2Dto\"}}},\"required\":[\"results\"]},\"ControlResetResultPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"controlId\":{\"type\":\"number\",\"description\":\"Control ID\",\"example\":123},\"success\":{\"type\":\"boolean\",\"description\":\"Whether the reset was successful\",\"example\":true},\"error\":{\"type\":\"string\",\"description\":\"Error message if reset failed\",\"nullable\":true,\"example\":\"Cannot reset requirement mappings for Custom Control\"}},\"required\":[\"controlId\",\"success\"]},\"ControlsResetMappingsRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"controlIds\":{\"maxItems\":100,\"example\":[123,456,789],\"description\":\"Array of control IDs to reset requirement mappings for (max 100)\",\"type\":\"array\",\"items\":{\"type\":\"number\"}}},\"required\":[\"controlIds\"]},\"ControlRequirementsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlRequirementResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"ControlRequirementResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the requirement was created\"},\"description\":{\"type\":\"string\",\"example\":\"The entity demonstrates a commitment to integrity and ethical values.\",\"description\":\"Requirement description\"},\"frameworkName\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"The framework name this requirement is associated with\"},\"frameworkPill\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"A pill representing the framework\"},\"frameworkSlug\":{\"type\":\"string\",\"example\":\"SOC 2\",\"description\":\"The framework slug this requirement is associated with\"},\"frameworkTag\":{\"type\":\"string\",\"example\":\"SOC_2\",\"description\":\"The framework tag this requirement is associated with\"},\"id\":{\"type\":\"number\",\"example\":\"58\",\"description\":\"Requirement ID\"},\"name\":{\"type\":\"string\",\"example\":\"PI1.2\",\"description\":\"Requirement name\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the requirement was updated\"},\"additionalInfo\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to integrity.\",\"description\":\"Additional information surrounding requirement\"},\"additionalInfo2\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to ethical values.\",\"description\":\"Second additional information surrounding requirement\"},\"additionalInfo3\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to enforcing policies.\",\"description\":\"Third additional information surrounding requirement\"},\"archivedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the requirement was marked out of scope\"},\"externalId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"SOC 2\",\"description\":\"An external ID associated with this requirement\"},\"longDescription\":{\"type\":\"string\",\"nullable\":true,\"example\":\"The entity demonstrates a commitment to integrity and ethical values.\",\"description\":\"A long description of the requirement \"},\"rationale\":{\"type\":\"string\",\"nullable\":true,\"example\":\"This requirement is not needed.\",\"description\":\"Requirement rationale for out of scope.\"}},\"required\":[\"createdAt\",\"description\",\"frameworkName\",\"frameworkPill\",\"frameworkSlug\",\"frameworkTag\",\"id\",\"name\",\"updatedAt\",\"additionalInfo\",\"additionalInfo2\",\"additionalInfo3\",\"archivedAt\",\"externalId\",\"longDescription\",\"rationale\"]},\"ControlModifyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Quarterly User Access Reviews\",\"description\":\"The name of the Control\"},\"description\":{\"type\":\"string\",\"maxLength\":30000,\"example\":\"Access to critical systems is reviewed on a quarterly basis to ensure that only authorized users retain access.\",\"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\":\"On a quarterly schedule, generate access reports from identity providers.\",\"description\":\"The activity of the Control\"},\"customFields\":{\"description\":\"Custom Fields for the Control. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}},\"required\":[\"name\",\"description\"]},\"ControlExpandEnum\":{\"type\":\"string\",\"enum\":[\"customFields\",\"flags\",\"frameworkTags\",\"owners\",\"requirements\",\"topics\"]},\"ControlResponsePublicV2Dto\":{\"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\"},\"slug\":{\"type\":\"string\",\"nullable\":true,\"example\":\"databases-monitored-and-alarmed\",\"description\":\"Control slug\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Drata has implemented tools to monitor Drata's databases and notify appropriate personnel of any events or incidents based on\\n             predetermined criteria. Incidents are escalated per policy.\",\"description\":\"Control description\"},\"question\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Does the organization implement tools to monitor its databases and notify appropriate personnel of incidents based on predetermined\\n             criteria?\",\"description\":\"Control question\"},\"activity\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Ensure tools are implemented to monitor databases\",\"description\":\"Control activity\"},\"archivedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Control was archived or null if it's still active\"},\"frameworkTags\":{\"type\":\"array\",\"example\":[\"SOC_2\"],\"description\":\"Framework tags associated with the Control, only returned when `expand[]=frameworkTags` is passed.\",\"items\":{\"$ref\":\"#/components/schemas/FrameworkTagEnum\"}},\"topics\":{\"type\":\"array\",\"example\":[1,2],\"description\":\"Trust Service Criteria associated with the control, only returned when `expand[]=topics` is passed.\",\"items\":{\"$ref\":\"#/components/schemas/TrustServiceCriteriaEnum\"}},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Control was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Date the Control was last updated\"},\"controlTemplateId\":{\"type\":\"number\",\"nullable\":true,\"example\":\"123\",\"description\":\"Control template ID, used to determine if the control is custom\"},\"flags\":{\"description\":\"The status flags associated with this Control, only returned when `expand[]=flags` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/ControlFlagsResponsePublicV2Dto\"}]},\"owners\":{\"description\":\"Control Owners with pagination information.\",\"allOf\":[{\"$ref\":\"#/components/schemas/OwnersSubcollectionResponsePublicV2Dto\"}]},\"requirements\":{\"description\":\"Control Requirements, only returned when `expand[]=requirements` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlRequirementResponsePublicV2Dto\"}},\"customFields\":{\"description\":\"Custom Fields, only returned when `expand[]=customFields` is passed. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldResponsePublicV2Dto\"}}},\"required\":[\"id\",\"name\",\"code\",\"slug\",\"description\",\"question\",\"activity\",\"archivedAt\",\"createdAt\",\"updatedAt\",\"controlTemplateId\"]},\"OwnersSubcollectionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Array of owners. Limited to a maximum of 10 items.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}},\"totalCount\":{\"type\":\"number\",\"example\":15,\"description\":\"Total count of all owners for this control.\"}},\"required\":[\"data\",\"totalCount\"]},\"ControlFlagsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"hasEvidence\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Indicates if the Control has any linked Polices, Reports, External Evidence, or Control Tests\"},\"hasPolicy\":{\"type\":\"boolean\",\"nullable\":true,\"example\":true,\"description\":\"Indicates if the Control has any linked Polices\"},\"isReady\":{\"type\":\"boolean\",\"nullable\":true,\"example\":\"true\",\"description\":\"Indicates if the Control is ready\"},\"hasTicket\":{\"type\":\"boolean\",\"nullable\":true,\"example\":\"true\",\"description\":\"Indicates if the Control is associated with a Task Management Ticket\"},\"hasOwner\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Indicates if the Control has any Owners\"},\"isMonitored\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Indicates if the Control has a Test\"}},\"required\":[\"hasEvidence\",\"hasPolicy\",\"isReady\",\"hasTicket\",\"hasOwner\",\"isMonitored\"]},\"TrustServiceCriteriaEnum\":{\"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\"]},\"ControlCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Quarterly User Access Reviews\",\"description\":\"The name of the Control\"},\"description\":{\"type\":\"string\",\"maxLength\":30000,\"example\":\"Access to critical systems is reviewed on a quarterly basis to ensure that only authorized users retain access.\",\"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\":\"On a quarterly schedule, generate access reports from identity providers.\",\"description\":\"The activity of the Control\"},\"customFields\":{\"description\":\"Custom Fields for the Control\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}},\"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\"}},\"ownersIds\":{\"example\":[1,2,3],\"description\":\"Array of User IDs to make owners of the Control\",\"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. Accepted file extensions: .pdf, .docx, .odt, .doc, .xlsx, .ods, .pptx, .odp, .gif, .jpg, .jpeg, .png\",\"example\":[\"-F 'file=<<Your-Relative-File-Path>>'\"],\"type\":\"array\",\"items\":{\"type\":\"string\",\"format\":\"binary\"}},\"externalEvidenceMetadata\":{\"type\":\"string\",\"example\":[{\"originalFile\":\"user-access-review-q1-2025.pdf\",\"filename\":\"excellent-filename.pdf\",\"description\":\"The file contains the results of the quarterly user access review for Q1 2015.\",\"creationDate\":\"2025-01-06 12:00:00.000000\",\"name\":\"Q1 2025 User Access Review\",\"renewalDate\":\"2026-01-06\",\"renewalScheduleType\":\"ONE_YEAR\"}],\"description\":\"JSON string of metadata of uploaded evidence\"},\"base64Files\":{\"type\":\"string\",\"example\":[{\"base64String\":\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg\",\"filename\":\"excellent-filename\"}],\"description\":\"JSON string with array of external evidence in Base64 format.\"}},\"required\":[\"name\",\"description\"]},\"ControlsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"ControlsExpandEnum\":{\"type\":\"string\",\"enum\":[\"customFields\",\"flags\",\"frameworkTags\",\"owners\",\"requirements\",\"topics\"]},\"ControlOwnersModifyResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"ownerIds\":{\"description\":\"User IDs of the Control's owners\",\"type\":\"array\",\"items\":{\"type\":\"number\"}}},\"required\":[\"ownerIds\"]},\"ControlOwnerModifyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"ownerUserIds\":{\"example\":[1,2,3],\"description\":\"User IDs of the Control's owners\",\"type\":\"array\",\"items\":{\"type\":\"number\"}}},\"required\":[\"ownerUserIds\"]},\"UserCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"User ID\"},\"email\":{\"type\":\"string\",\"example\":\"email@example.com\",\"description\":\"User email\"},\"firstName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Sally\",\"description\":\"User first name\"},\"lastName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Smith\",\"description\":\"User last name\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User created at\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"User last updated at\"}},\"required\":[\"id\",\"email\",\"firstName\",\"lastName\",\"createdAt\",\"updatedAt\"]},\"ControlOwnerCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"ownerId\":{\"type\":\"number\",\"example\":56,\"description\":\"Owner ID\"}},\"required\":[\"ownerId\"]},\"ControlOwnersResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"NoteRequestPublicDto\":{\"type\":\"object\",\"properties\":{\"comment\":{\"type\":\"string\",\"maxLength\":191,\"example\":\"Note comment\",\"description\":\"The text of the note\"}},\"required\":[\"comment\"]},\"ControlNoteResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"Note ID\"},\"ownerId\":{\"type\":\"number\",\"example\":60,\"description\":\"Note Owner ID\"},\"comment\":{\"type\":\"string\",\"description\":\"The main comment of the Note\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Note created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Note updated date timestamp\"},\"owner\":{\"description\":\"The User that created the Note, only returned when `expand[]=owner` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"ownerId\",\"comment\",\"createdAt\",\"updatedAt\"]},\"ControlNoteCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"comment\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The text of the Note\"}},\"required\":[\"comment\"]},\"ControlNotesResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/ControlNoteResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"ControlNotesExpandEnum\":{\"type\":\"string\",\"enum\":[\"owner\"]},\"CompanyResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"accountId\":{\"type\":\"string\",\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"The account ID for the company\"},\"domain\":{\"type\":\"string\",\"example\":\"domain.com\",\"description\":\"Company's domain\"},\"name\":{\"type\":\"string\",\"example\":\"Acme\",\"description\":\"Company's common name\"},\"legalName\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Acme Inc.\",\"description\":\"Company's full legal name\"},\"year\":{\"type\":\"number\",\"nullable\":true,\"example\":2014,\"description\":\"Year the company was founded\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"We make tools\",\"description\":\"The description of the company\"},\"phoneNumber\":{\"type\":\"string\",\"nullable\":true,\"example\":\"800-555-5555\",\"description\":\"Company's phone number\"},\"address\":{\"type\":\"string\",\"nullable\":true,\"example\":\"742 Evergreen Terrace, Springfield, OH 45501\",\"description\":\"The address of the company\"},\"privacyUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://domain.com/privacy\",\"description\":\"Company's privacy URL\"},\"termsUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://domain.com/terms\",\"description\":\"Company's terms of use URL\"},\"supportUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://help.domain.com\",\"description\":\"Company's support/help URL\"},\"jobsUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://jobs.domain.com\",\"description\":\"The URL where your open jobs are publicly posted online\"},\"securityEmail\":{\"type\":\"string\",\"nullable\":true,\"example\":\"security@domain.com\",\"description\":\"Company's security/compliance email\"},\"logoUrl\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://domain.com/logo.png\",\"description\":\"Company avatar URL\"},\"securityTraining\":{\"nullable\":true,\"example\":\"DRATA_PROVIDED\",\"description\":\"Security Awareness Training option\",\"allOf\":[{\"$ref\":\"#/components/schemas/SecurityTrainingTypeEnum\"}]},\"hipaaTraining\":{\"nullable\":true,\"example\":\"DRATA_PROVIDED\",\"description\":\"HIPAA Training option\",\"allOf\":[{\"$ref\":\"#/components/schemas/HipaaTrainingTypeEnum\"}]},\"backgroundCheck\":{\"nullable\":true,\"example\":\"CERTN\",\"description\":\"The backgroup check provider used for new hires\",\"allOf\":[{\"$ref\":\"#/components/schemas/BackgroundCheckTypeEnum\"}]},\"securityReport\":{\"description\":\"Information about the security report\",\"allOf\":[{\"$ref\":\"#/components/schemas/SecurityReportResponsePublicV2Dto\"}]},\"adminOnboardedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Company completed onboarded date timestamp\"},\"renewalPeriodStartDate\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Company entered annual renewal time date timestamp\"},\"securityTrainingLink\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://security-training.domain.com\",\"description\":\"Link to custom security training\"},\"hipaaTrainingLink\":{\"type\":\"string\",\"nullable\":true,\"example\":\"https://hipaa-training.domain.com\",\"description\":\"Link to custom HIPAA Training\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Account created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Account updated date timestamp\"},\"agentEnabled\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Is the Drata Agent enabled\"},\"manualUploadEnabled\":{\"type\":\"boolean\",\"example\":false,\"description\":\"Can manual evidence (Device and User Documents) be uploaded?\"},\"drataSupportAccess\":{\"nullable\":true,\"description\":\"Indicates the access Drata Support has access to this account\",\"allOf\":[{\"$ref\":\"#/components/schemas/DrataSupportAccessResponsePublicV2Dto\"}]},\"entitlements\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"description\":{\"type\":\"string\"},\"type\":{\"type\":\"string\"},\"featureId\":{\"type\":\"number\",\"nullable\":true},\"metadata\":{\"type\":\"object\",\"additionalProperties\":true}}},\"description\":\"The enabled features on this account\"},\"language\":{\"description\":\"Account language\",\"allOf\":[{\"$ref\":\"#/components/schemas/LanguageEnum\"}]}},\"required\":[\"accountId\",\"domain\",\"name\",\"legalName\",\"year\",\"description\",\"phoneNumber\",\"address\",\"privacyUrl\",\"termsUrl\",\"supportUrl\",\"jobsUrl\",\"securityEmail\",\"logoUrl\",\"securityTraining\",\"hipaaTraining\",\"backgroundCheck\",\"securityReport\",\"adminOnboardedAt\",\"renewalPeriodStartDate\",\"createdAt\",\"updatedAt\",\"agentEnabled\",\"manualUploadEnabled\",\"drataSupportAccess\",\"entitlements\",\"language\"]},\"LanguageEnum\":{\"type\":\"string\",\"enum\":[\"ENGLISH_US\",\"SPANISH_LA\",\"GERMAN_DE\",\"FRENCH_FR\",\"ITALIAN_IT\",\"DUTCH_NL\",\"PSEUDO\",\"PSEUDOX\"]},\"DrataSupportAccessResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"enabledAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the admin enabled access for Drata Support\"},\"expiresAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the time window expires for Drata Support\"},\"type\":{\"type\":\"string\",\"example\":\"READ_ONLY\",\"description\":\"The type of access granted for Drata Support\"}},\"required\":[\"enabledAt\",\"expiresAt\",\"type\"]},\"SecurityReportResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"visibility\":{\"example\":\"PASSING\",\"description\":\"The type of tests to return in the security report based on the result status\",\"allOf\":[{\"$ref\":\"#/components/schemas/ReportVisibilityTypeEnum\"}]},\"sharing\":{\"type\":\"boolean\",\"example\":true,\"description\":\"Indicates if the security report can be shared publicly\"},\"shareToken\":{\"type\":\"string\",\"nullable\":true,\"example\":\"aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"The token used to share the security report\"}},\"required\":[\"visibility\",\"sharing\",\"shareToken\"]},\"ReportVisibilityTypeEnum\":{\"type\":\"string\",\"enum\":[\"ALL\",\"PASSING\",\"MONITORING\"]},\"BackgroundCheckTypeEnum\":{\"type\":\"string\",\"enum\":[\"KARMACHECK\",\"MANUAL\",\"CERTN\",\"CHECKR\",\"HRIS_RIPPLING\",\"STERLING\",\"HIRERIGHT\",\"VETTY\"]},\"HipaaTrainingTypeEnum\":{\"type\":\"string\",\"enum\":[\"DRATA_PROVIDED\",\"LINK_PROVIDED\",\"MANUAL\",\"NOT_REQUIRED\",\"KNOWBE4\",\"MANUAL_EVIDENCE_FIRST\"]},\"SecurityTrainingTypeEnum\":{\"type\":\"string\",\"enum\":[\"ESET\",\"LINK_PROVIDED\",\"DRATA_PROVIDED\",\"MANUAL\",\"CURRICULA\",\"KNOWBE4\",\"STACKONE_EASY_LLAMA\",\"MANUAL_EVIDENCE_FIRST\",\"STACKONE_CORNERSTONE\",\"STACKONE_DOCEBO\",\"STACKONE_GO1\",\"STACKONE_LINKEDIN_LEARNING\",\"STACKONE_SAP_LEARNING\",\"STACKONE_WORKDAY_LEARNING\",\"STACKONE_360LEARNING\",\"STACKONE_BRAINIER\",\"STACKONE_COURSERA\",\"STACKONE_XYLEME\",\"STACKONE_INFOSEC\",\"STACKONE_UDEMY\",\"STACKONE_PEOPLE_FLUENT\"]},\"PersonCompactResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Personnel ID\"},\"employmentStatus\":{\"description\":\"The employment status of the Personnel\",\"allOf\":[{\"$ref\":\"#/components/schemas/EmploymentStatusEnum\"}]},\"userId\":{\"type\":\"number\",\"example\":1,\"description\":\"User ID associated with this Personnel\"},\"email\":{\"type\":\"string\",\"example\":\"john.doe@example.com\",\"description\":\"Email of the user associated with this Personnel\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"Personnel created date timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2023-01-01T00:00:00.000Z\",\"description\":\"Personnel updated date timestamp\"}},\"required\":[\"id\",\"employmentStatus\",\"userId\",\"email\",\"createdAt\",\"updatedAt\"]},\"BackgroundCheckCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"userId\":{\"type\":\"number\",\"example\":1,\"description\":\"The ID of the User for whom the Background Check is being uploaded\"},\"url\":{\"type\":\"string\",\"maxLength\":768,\"format\":\"uri\",\"example\":\"https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd\",\"description\":\"The URL of the Background Check document or report\"},\"filedAt\":{\"type\":\"string\",\"format\":\"date\",\"example\":\"2020-07-06\",\"description\":\"The date when this Background Check data was completed.\"}},\"required\":[\"userId\",\"url\",\"filedAt\"]},\"AssetModifyRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"description\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The Asset description\"},\"notes\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The Asset notes\"},\"customFields\":{\"description\":\"Custom Fields for the Asset. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}}},\"AssetResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Asset ID\"},\"name\":{\"type\":\"string\",\"example\":\"MacBook Pro 16-inch\",\"description\":\"The name of the asset\"},\"description\":{\"type\":\"string\",\"example\":\"MacBook Pro 16-inch with 14-Core CPU 32-Core GPU 36GB Unified Memory 1TB SSD Storage\",\"description\":\"The description of the asset\"},\"assetType\":{\"example\":\"PHYSICAL\",\"description\":\"The Asset type\",\"allOf\":[{\"$ref\":\"#/components/schemas/AssetTypeEnum\"}]},\"assetProvider\":{\"example\":\"AGENT\",\"description\":\"The Asset source provider\",\"allOf\":[{\"$ref\":\"#/components/schemas/AssetProviderEnum\"}]},\"removedAt\":{\"type\":\"string\",\"nullable\":true,\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When the Asset stopped being tracked\"},\"assetClassTypes\":{\"example\":\"AssetClassTypeResponsePublicV2Dto[]\",\"description\":\"Asset class types associated with this Asset.  This field is only returned when `expand[]=assetClassTypes` is passed.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/AssetClassTypeResponsePublicV2Dto\"}},\"owner\":{\"description\":\"The User that owns the Asset, only returned when `expand[]=owner` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserResponsePublicV2Dto\"}]},\"notes\":{\"type\":\"string\",\"nullable\":true,\"description\":\"The Asset notes\"},\"assetReferenceType\":{\"nullable\":true,\"example\":\"PERSONNEL\",\"description\":\"The Asset reference type\",\"allOf\":[{\"$ref\":\"#/components/schemas/AssetReferenceTypeEnum\"}]},\"associatedId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"C02T6CDJGTFL\",\"description\":\"An ID associated with this Asset\"},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Asset created timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"Asset updated timestamp\"},\"device\":{\"nullable\":true,\"description\":\"The Device associated to this Asset, only returned when `expand[]=device`, `expand[]=complianceChecks`, or `expand[]=identifiers` is passed.\",\"allOf\":[{\"$ref\":\"#/components/schemas/DeviceResponsePublicV2Dto\"}]},\"externalId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"i-0c844e3b433e4e3f\",\"description\":\"An externally sourced unique identifier for a virtual Asset\"},\"externalOwnerId\":{\"type\":\"string\",\"nullable\":true,\"example\":\"account-353\",\"description\":\"Used to track the source of virtual assets, typically an account id.\"},\"customFields\":{\"description\":\"Custom Fields, only returned when `expand[]=customFields` is passed. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldResponsePublicV2Dto\"}}},\"required\":[\"id\",\"name\",\"description\",\"assetType\",\"assetProvider\",\"removedAt\",\"notes\",\"assetReferenceType\",\"associatedId\",\"createdAt\",\"updatedAt\",\"device\",\"externalId\"]},\"AssetReferenceTypeEnum\":{\"type\":\"string\",\"enum\":[\"PERSONNEL\",\"WORKSTATION\",\"REPORT\",\"POLICY\",\"OTHER\",\"VIRTUAL\"]},\"AssetClassTypeResponsePublicV2Dto\":{\"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\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"asset class type created timestamp\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"asset class type update timestamp\"}},\"required\":[\"id\",\"assetClassType\",\"createdAt\",\"updatedAt\"]},\"AssetCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The Asset name\"},\"description\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The Asset description\"},\"notes\":{\"type\":\"string\",\"maxLength\":191,\"description\":\"The Asset notes\"},\"assetClassTypes\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/AssetClassTypeEnum\"},\"example\":[\"HARDWARE\",\"PERSONNEL\"],\"description\":\"The Asset class types\"},\"assetType\":{\"example\":\"PHYSICAL\",\"description\":\"The Asset type\",\"allOf\":[{\"$ref\":\"#/components/schemas/AssetTypeEnum\"}]},\"ownerId\":{\"type\":\"number\",\"example\":1,\"description\":\"The owner ID\"},\"associatedId\":{\"type\":\"string\",\"example\":\"C02T6CDJGTFL\",\"description\":\"An ID associated with this Asset\"},\"removedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"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\"},\"customFields\":{\"description\":\"Custom Fields for the Asset. \\n\\n💎 Requires your account have the Custom Fields and Formulas feature. Contact your CSM for help upgrading.\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomFieldSubmitRequestPublicV2Dto\"}}},\"required\":[\"name\",\"description\",\"assetClassTypes\",\"assetType\",\"ownerId\"]},\"AssetsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"Data set based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/AssetResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"EmploymentStatusEnum\":{\"type\":\"string\",\"enum\":[\"CURRENT_EMPLOYEE\",\"FORMER_EMPLOYEE\",\"CURRENT_CONTRACTOR\",\"FORMER_CONTRACTOR\",\"OUT_OF_SCOPE\",\"UNKNOWN\",\"SPECIAL_FORMER_EMPLOYEE\",\"SPECIAL_FORMER_CONTRACTOR\",\"FUTURE_HIRE\",\"SERVICE_ACCOUNT\"],\"x-enumDescriptions\":{\"CURRENT_EMPLOYEE\":\"Current Employee\",\"FORMER_EMPLOYEE\":\"Former Employee\",\"CURRENT_CONTRACTOR\":\"Current Contractor\",\"FORMER_CONTRACTOR\":\"Former Contractor\",\"FUTURE_HIRE\":\"Future Hire – Based on the HRIS data\",\"UNKNOWN\":\"Unknown – The personnel did not match an HRIS record\",\"OUT_OF_SCOPE\":\"Out of Scope – Manually marked as out of scope\",\"SERVICE_ACCOUNT\":\"Service Account – Automatically marked as out of scope\",\"SPECIAL_FORMER_EMPLOYEE\":\"Special Former Employee – Deprecated status for manually created personnel\",\"SPECIAL_FORMER_CONTRACTOR\":\"Special Former Contractor – Deprecated status for manually created personnel\"}},\"AssetProviderEnum\":{\"type\":\"string\",\"enum\":[\"DRATA_DEV\",\"AGENT\",\"DRATA\",\"GOOGLE\",\"MICROSOFT_365\",\"JAMF\",\"INTUNE\",\"OKTA_IDENTITY\",\"KANDJI\",\"JUMPCLOUD\",\"HEXNODE_UEM\",\"RIPPLING\",\"AWS\",\"MERGEDEV_ONELOGIN\",\"MERGEDEV_JUMPCLOUD\",\"WORKSPACE_ONE\",\"CSV_IDP\",\"AWS_GOV_CLOUD\",\"AZURE\",\"GCP\",\"MICROSOFT_365_GCC_HIGH\",\"MERGEDEV_CYBERARK\",\"KOLIDE\",\"MERGEDEV_PINGONE\",\"AWS_ORG_UNITS\",\"INTUNE_GCC_HIGH\",\"CUSTOM_XFA\",\"NINJAONE\"]},\"AssetTypeEnum\":{\"type\":\"string\",\"enum\":[\"PHYSICAL\",\"VIRTUAL\"]},\"AssetClassTypeEnum\":{\"type\":\"string\",\"enum\":[\"HARDWARE\",\"POLICY\",\"DOCUMENT\",\"PERSONNEL\",\"SOFTWARE\",\"CODE\",\"CONTAINER\",\"COMPUTE\",\"NETWORKING\",\"DATABASE\",\"STORAGE\"]},\"AssetExpandEnum\":{\"type\":\"string\",\"enum\":[\"device\",\"assetClassTypes\",\"complianceChecks\",\"customFields\",\"identifiers\",\"owner\"]},\"CustomConnectionUpdateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"clientAlias\":{\"type\":\"string\",\"nullable\":true,\"example\":\"My Updated Custom Connection\",\"description\":\"Alias for the Custom Connection\"},\"description\":{\"type\":\"string\",\"example\":\"Updated description for Custom Connection\",\"description\":\"Description for Custom Connection\"}}},\"CustomConnectionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"number\",\"example\":1,\"description\":\"Custom Connection ID\"},\"clientAlias\":{\"type\":\"string\",\"nullable\":true,\"example\":\"My Custom Connection\",\"description\":\"Alias for the Custom Connection\"},\"description\":{\"type\":\"string\",\"nullable\":true,\"example\":\"Custom connection for managing Employee Data\",\"description\":\"Description of the Custom Connection\"},\"providerTypes\":{\"type\":\"array\",\"example\":[\"MDM\"],\"description\":\"Provider types associated with the Custom Connection\",\"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\",\"EDR\",\"USER_ACCESS_REVIEW\",\"CSPM\",\"CODEBASE\",\"CYBER_INSURANCE\",\"CRM\",\"CUSTOM\",\"AUTOMATION_TOOLS\",\"SECURITY_REVIEWS\",\"PROCUREMENT\"]}},\"createdAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this Custom Connection was created\"},\"updatedAt\":{\"type\":\"string\",\"format\":\"date-time\",\"example\":\"2025-07-01T16:45:55.246Z\",\"description\":\"When this Custom Connection was last updated\"},\"createdById\":{\"type\":\"number\",\"nullable\":true,\"example\":1,\"description\":\"The user or API key ID that established the Custom Connection\"},\"createdByUser\":{\"description\":\"The user or API key that established the Custom Connection\",\"allOf\":[{\"$ref\":\"#/components/schemas/UserCompactResponsePublicV2Dto\"}]}},\"required\":[\"id\",\"clientAlias\",\"description\",\"createdAt\",\"updatedAt\"]},\"CustomConnectionCreateRequestPublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"example\":\"My Custom Connection\",\"description\":\"Name for the Custom Connection\"},\"providerTypes\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"MDM\",\"HRIS\"]},\"example\":[\"MDM\"],\"description\":\"Provider types for the Custom Connection. Supported types: MDM, HRIS.\"}},\"required\":[\"name\",\"providerTypes\"]},\"ExceptionResponseDto\":{\"type\":\"object\",\"properties\":{\"statusCode\":{\"type\":\"number\"},\"message\":{\"type\":\"string\"},\"code\":{\"type\":\"number\"},\"debugInfo\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"message\":{\"type\":\"string\"},\"stack\":{\"type\":\"string\"}},\"required\":[\"name\",\"message\"]}},\"required\":[\"statusCode\",\"message\",\"code\"]},\"ExceptionResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"statusCode\":{\"type\":\"number\"},\"message\":{\"type\":\"string\"},\"code\":{\"type\":\"number\"},\"debugInfo\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"message\":{\"type\":\"string\"},\"stack\":{\"type\":\"string\"}},\"required\":[\"name\",\"message\"]}},\"required\":[\"name\",\"statusCode\",\"message\",\"code\"]},\"CustomConnectionsResponsePublicV2Dto\":{\"type\":\"object\",\"properties\":{\"data\":{\"description\":\"List of Custom Connections based on the pagination limits\",\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/CustomConnectionResponsePublicV2Dto\"}},\"pagination\":{\"$ref\":\"#/components/schemas/PaginationTotalCountResponsePublicV2Dto\"}},\"required\":[\"data\",\"pagination\"]},\"CustomConnectionExpandEnum\":{\"type\":\"string\",\"enum\":[\"createdByUser\"]},\"SortDirectionEnum\":{\"type\":\"string\",\"enum\":[\"ASC\",\"DESC\"]},\"SortTypeLimitedEnum\":{\"type\":\"string\",\"enum\":[\"createdAt\",\"updatedAt\",\"name\"]}}}}},\"options\":{\"hideTryItPanel\":false,\"pagination\":\"section\",\"jsonSampleExpandLevel\":\"all\",\"generateCodeSamples\":{\"languages\":[{\"lang\":\"Node.js\"},{\"lang\":\"JavaScript\"},{\"lang\":\"curl\"},{\"lang\":\"Python\"},{\"lang\":\"C#\"},{\"lang\":\"Java\"},{\"lang\":\"PHP\"}],\"skipOptionalParameters\":true},\"disableSearch\":true,\"ctrlFHijack\":false,\"disableSidebar\":true,\"theme\":{\"overrides\":{\"DownloadButton\":{\"custom\":\"\"},\"NextSectionButton\":{\"custom\":\"\"}},\"codeBlock\":{\"tokens\":{}},\"schema\":{\"constraints\":{},\"examples\":{}},\"rightPanel\":{\"textColor\":\"#eeeeee\"},\"typography\":{\"heading1\":{},\"heading2\":{},\"heading3\":{},\"rightPanelHeading\":{}}}}}","redocHasSecurityDefinitions":false,"redocInfoPageLink":"/openapi/reference/v2/overview/","redocItemId":"tag/HRIS-User-Identities","redocHasInfoPage":false,"settings":{"jsonSampleExpandLevel":"all","generateCodeSamples":{"languages":[{"lang":"Node.js"},{"lang":"JavaScript"},{"lang":"curl"},{"lang":"Python"},{"lang":"C#"},{"lang":"Java"},{"lang":"PHP"}],"skipOptionalParameters":true},"pagination":"section"},"requestLogin":false,"lastModified":"2025-08-14T02:31:55.000Z"},"seo":{"title":"HRIS User Identities"}}},"pageContext":{"id":"c3fc8c1b-948d-500b-8e10-37c4fc61cd32tag/HRIS-User-Identities/__redocly content/openapi/reference/v2/tag/HRIS-User-Identities/","seo":{"title":"HRIS User Identities","description":"HR user identity records for a Custom HRIS connection. Use the batch upsert endpoint to submit employee records keyed by your own `identityId`, then use the update endpoint to reflect employment changes (e.g. set `separatedAt` when an employee leaves). Deleting a record is intended for data submitted in error, not for offboarding. Changes are not applied immediately — they are incorporated the next time identity sync runs, which happens nightly by default. A sync can also be triggered manually from the Personnel page.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"openapi/reference.page.yaml#tag/HRIS-User-Identities/","pageBaseUrl":"/openapi/reference","type":"redoc-operation","toc":{"enable":true,"maxDepth":4,"headings":null},"data":{},"catalogInfo":null,"link":"/openapi/reference/v2/tag/HRIS-User-Identities/","sidebarName":"training","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":[{"definitionId":"drata-v2","id":"v2","title":"API V2 – Beta 🧪","isDefault":true,"apiId":null},{"definitionId":"drata-v1","id":"v1","title":"API V1","isDefault":false,"apiId":null}],"apiVersionId":"v2","isDefaultApiVersion":true}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}