From 13e350cc97a529ab5b536a26105cdc9e34605758 Mon Sep 17 00:00:00 2001 From: speakeasybot Date: Fri, 4 Sep 2026 00:04:14 +0000 Subject: [PATCH 1/2] ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.796.4 --- .speakeasy/gen.lock | 124 ++++++++------- .speakeasy/gen.yaml | 2 +- .speakeasy/workflow.lock | 12 +- README.md | 4 +- RELEASES.md | 12 +- docs/models/components/Audit.md | 2 +- docs/models/components/AuditSegment.md | 2 +- .../components/AuditSegmentFramework.md | 10 +- docs/models/components/FrameworkCodes.md | 7 +- .../components/FrameworkCodesByFramework.md | 9 ++ docs/models/components/InformationRequest.md | 37 ++--- .../ListInformationRequestsRequest.md | 13 +- docs/sdks/audits/README.md | 37 +++-- gradle.properties | 2 +- .../vanta/vanta_auditor_api/AsyncAudits.java | 100 ++++-------- .../com/vanta/vanta_auditor_api/Audits.java | 100 ++++-------- .../vanta_auditor_api/SDKConfiguration.java | 4 +- .../models/components/Audit.java | 8 +- .../models/components/AuditSegment.java | 8 +- .../components/AuditSegmentFramework.java | 100 ++---------- .../models/components/FrameworkCodes.java | 84 +++++++++-- .../components/FrameworkCodesByFramework.java | 142 ++++++++++++++++++ .../models/components/InformationRequest.java | 135 +++++++++++++---- .../ListInformationRequestsRequest.java | 98 +++++++++++- ...ListInformationRequestsRequestBuilder.java | 77 +--------- ...ListInformationRequestsRequestBuilder.java | 77 +--------- 26 files changed, 656 insertions(+), 550 deletions(-) create mode 100644 docs/models/components/FrameworkCodesByFramework.md create mode 100644 src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodesByFramework.java diff --git a/.speakeasy/gen.lock b/.speakeasy/gen.lock index 05d91f0..d8e1b9d 100644 --- a/.speakeasy/gen.lock +++ b/.speakeasy/gen.lock @@ -1,19 +1,19 @@ lockVersion: 2.0.0 id: f42d74f5-5725-46fa-b13c-649b7ef895c3 management: - docChecksum: 65b3580e318574e8fd8d0308fe79cf06 + docChecksum: 88cc51407c4fac91d3b97d5ea4c6b0e8 docVersion: 1.0.0 - speakeasyVersion: 1.796.3 - generationVersion: 2.934.1 - releaseVersion: 0.7.1 - configChecksum: 2b8c9802827b910b635d24c0916b3018 + speakeasyVersion: 1.796.4 + generationVersion: 2.935.1 + releaseVersion: 0.7.2 + configChecksum: c0ed2acaa4fbceacda408167adf6703a repoURL: https://github.com/VantaInc/vanta-auditor-api-sdk-java.git installationURL: https://github.com/VantaInc/vanta-auditor-api-sdk-java published: true persistentEdits: - generation_id: 882dbdf8-0a91-4553-9972-9942baa2d0b6 - pristine_commit_hash: 9632032cfdfd80ac883e9f45d790a4089fdbf7eb - pristine_tree_hash: 2de15a6093a0c041efa72412ba5b58b88cf08ab2 + generation_id: 1a5602ad-ae86-4e63-b4d6-ca19b1f09684 + pristine_commit_hash: dba4c8bc3635607c1d22ddc3c9245ab50584073a + pristine_tree_hash: 2abbf4c8fedc78bd11560f6d08fa497a45dfce59 features: java: additionalDependencies: 0.1.0 @@ -100,8 +100,8 @@ trackedFiles: pristine_git_object: 37adc35fae5e6b36a4495d0cf0260b2195b69ae5 docs/models/components/Audit.md: id: e4a55898fa16 - last_write_checksum: sha1:3edb467619f745eb79b54d48b76d4a50a61b55f2 - pristine_git_object: f56469986b91f75e95f694950d0bf596418af42e + last_write_checksum: sha1:08e0ef04d66ec90faf70bbde148b9a7f721e4a2d + pristine_git_object: bdb6f03160bdf44d8724fa6bdd5466ae1513b242 docs/models/components/AuditControlAssessment.md: id: 912f37d45d66 last_write_checksum: sha1:400f9eb6db331443a1ba46cd209e8f6623b690cc @@ -168,12 +168,12 @@ trackedFiles: pristine_git_object: 5f34594955e094c06537ecf2bedd2cece208cd87 docs/models/components/AuditSegment.md: id: 2ec5e0fc5495 - last_write_checksum: sha1:55ad414d312eba8dd42589f547c75a92ee5a0a7f - pristine_git_object: 45a75abe67659f8c4ce07bfeb816736877a840fc + last_write_checksum: sha1:a0ce05e2e08b14686d6b5ae9122ea153f17ec3c7 + pristine_git_object: ba0149015558f5d703718806408232c194007c27 docs/models/components/AuditSegmentFramework.md: id: 7d6e4ca56896 - last_write_checksum: sha1:5b2b565a8efcc896de1e21f25275b6239c83fa78 - pristine_git_object: e7531e008a16d9b7c7f418fb36ab11eae0bc18ca + last_write_checksum: sha1:bdf9b760996ba5501249ba7a2146a33b0c92febb + pristine_git_object: 72bfc2e6fc30cd3c8bd59a1c93ceb35b7350bcbe docs/models/components/AuditSegmentKind.md: id: fa89e8965792 last_write_checksum: sha1:53486d7e6dcda6fb121159fadda60e6e45d04075 @@ -424,8 +424,12 @@ trackedFiles: pristine_git_object: a47b5cfa253019bea5ecde255f947aa6ccb47ffd docs/models/components/FrameworkCodes.md: id: 95af211ac639 - last_write_checksum: sha1:eab723ca6d5b7323f844ac5e0a6f1f0ee6d446ab - pristine_git_object: 66cf07ffa6541bd60e3ebeae52569b5a073c05ed + last_write_checksum: sha1:9e3ebbaf69480b620dacd6ddfdf357d497d5746f + pristine_git_object: 446b84b9e6bcfbedd1ab7d5245572d0694e9f8d5 + docs/models/components/FrameworkCodesByFramework.md: + id: 02c4338d00ca + last_write_checksum: sha1:013f9c9764df26230f59a1c267eb31a5962c5365 + pristine_git_object: f9ac3f891023a1ba9e318556fc93128dfef34219 docs/models/components/FrameworkId.md: id: 65038e295e4e last_write_checksum: sha1:f0447dd0286977462abed262eeabc5bbb96c95cd @@ -448,8 +452,8 @@ trackedFiles: pristine_git_object: 9bb93e4dfc387061026170d128c1cf069af6e7f3 docs/models/components/InformationRequest.md: id: 470109d2da90 - last_write_checksum: sha1:577d147cd0707b89edb589e44b3468863ca53c81 - pristine_git_object: c29b80b3f5175cc9ea06ae5d2bdc6975973c6971 + last_write_checksum: sha1:242726d55a109f047dc3ce1b4f7f84613a046fa2 + pristine_git_object: 4aad85b8c15c077bd0328d128bb483bb7a0db96c docs/models/components/InformationRequestActivityLog.md: id: c0627c069348 last_write_checksum: sha1:b20a2bc78e680aa7bcee9748f440d5f61507752e @@ -1484,8 +1488,8 @@ trackedFiles: pristine_git_object: d0d75e5df0210e44818e6f601668cf79fbc03440 docs/models/operations/ListInformationRequestsRequest.md: id: d3301faa918a - last_write_checksum: sha1:a0ea1e7a7e5dbcd576da3f073e2a8be78e8f0e0c - pristine_git_object: a084ac24e0e9133796f8cbce677334061328d022 + last_write_checksum: sha1:1f06e8d0fba0fd4773bda563e78c24a3186aafbb + pristine_git_object: 1f48952c9795cf850abb7ced124f041a8ca22b96 docs/models/operations/ListInformationRequestsResponse.md: id: f12439c42421 last_write_checksum: sha1:0fa2af758234efa1181fbf196d19c7ef9cc6f024 @@ -1632,16 +1636,16 @@ trackedFiles: pristine_git_object: 0808108fb53faaa59313b7f3a8cb82e6a32884ad docs/sdks/audits/README.md: id: b976aa226e19 - last_write_checksum: sha1:e714a7b340d005a48f904963f27d384bc91803e7 - pristine_git_object: e2d9ba6f25574f39f6e540d4321f8df8f8d13b98 + last_write_checksum: sha1:8d5319e99ab764f9e38ef32737c0b58a59fbaa27 + pristine_git_object: 3452d7f898c5fcfc4e7d185edda93f5de2ab26a9 docs/utils/Blob.md: id: 3d9a7c4ad67a last_write_checksum: sha1:46ba9a381c8983c4a89c495fbca109cc66851754 pristine_git_object: de7d1b163d5926363b94e775645373b750f65b30 gradle.properties: id: 2afbb999f001 - last_write_checksum: sha1:56dfbd6c5f9f24875c597f0ec5527e69a379bd62 - pristine_git_object: d6a5dc753b9f0665a0a89b7668fdabc2d02fcea8 + last_write_checksum: sha1:9087a66a8e90607669ef5f1ea963bea15440ca3f + pristine_git_object: 923901adb673f11db2872346d6cfe75a3f47884f gradle/wrapper/gradle-wrapper.jar: id: ec27dae6e852 last_write_checksum: sha1:f725fb1467084142d74fd7cd8eab691ab3442611 @@ -1672,8 +1676,8 @@ trackedFiles: pristine_git_object: 8ce3f1ca13fe3131d31dd8f7d40fdab23067fc82 src/main/java/com/vanta/vanta_auditor_api/AsyncAudits.java: id: 2d0875e33c27 - last_write_checksum: sha1:de788b5d9ed5ab099fbe80abc0e8b24d55e513bb - pristine_git_object: 6dab85bce57ce989df3092324c650c065290edc2 + last_write_checksum: sha1:c7fb3d895484ef5da983c9a15dcd63835735979f + pristine_git_object: 2f53f11f2917e5ee33d7d9d48ac0f40f580c4fb6 src/main/java/com/vanta/vanta_auditor_api/AsyncVanta.java: id: b47385b1c356 last_write_checksum: sha1:883518392f570199c37a5f9005cddce689f136ce @@ -1684,12 +1688,12 @@ trackedFiles: pristine_git_object: a412b060afc9232b17567b476a1d1a1f776618f1 src/main/java/com/vanta/vanta_auditor_api/Audits.java: id: 0ee418adaca4 - last_write_checksum: sha1:e90777c4359480b2ac2438779867505fddd31c1d - pristine_git_object: 252b3b6b301263817e6ffbb6df53a9ea3adee561 + last_write_checksum: sha1:2654878620fa613e63e755c355e8180d70880009 + pristine_git_object: 051bd78ea9a9f49bd232bf9e92792109ef548f51 src/main/java/com/vanta/vanta_auditor_api/SDKConfiguration.java: id: ce55360c720c - last_write_checksum: sha1:5c1bb78414b00f9f6ce88cc7cdd6c9cfb4d5b84b - pristine_git_object: 0b48cb21cf92615720f264a8b901d95bb9bec4b7 + last_write_checksum: sha1:757fac7cd38462b7a31b4c1695c53f7be32b625f + pristine_git_object: bd74339bf8f18778d7660209a003c530454f1459 src/main/java/com/vanta/vanta_auditor_api/SecuritySource.java: id: 18c0da44b51f last_write_checksum: sha1:55dc5f4240c7317c9a5a4080b6e17dc1b6fdd403 @@ -1756,8 +1760,8 @@ trackedFiles: pristine_git_object: 3a4fdac4fc082d27feb5e8b3735b3ec7581f11f4 src/main/java/com/vanta/vanta_auditor_api/models/components/Audit.java: id: 1a12e3b13579 - last_write_checksum: sha1:7acb4d600e460e619a6dcd3205fe0b10f4a2db0d - pristine_git_object: 8d65e09fa30f470f626ebfb488d189fe1e952bba + last_write_checksum: sha1:1214c1a8f819c40b5e4ee061c46b17f647be230e + pristine_git_object: 7336bcbebfa9f8033c70d691b819d9bc4ba97f7a src/main/java/com/vanta/vanta_auditor_api/models/components/AuditControlAssessment.java: id: c2f1a0337769 last_write_checksum: sha1:e048eff160ec5174412f14d9274154e656e92cb5 @@ -1824,12 +1828,12 @@ trackedFiles: pristine_git_object: c67ecc16985baf5c0a4319fe6cf634aed262eb93 src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegment.java: id: 5631c07fa915 - last_write_checksum: sha1:023b9edab11ffe0e3d9078936a5eb53dd0f8bf72 - pristine_git_object: 18aea97c3b0bfe865be17db6390ec75261459e62 + last_write_checksum: sha1:c0158c6b37194e7c0762c1219a7ec0b883971894 + pristine_git_object: 93f3094d2f01df3b43342f0bdcefc7d28fa812bf src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegmentFramework.java: id: 5a8fc21d4fc8 - last_write_checksum: sha1:52b612225c9f181fccf5dcb0cfadc030dbbad4a9 - pristine_git_object: faa38200422de5ff8b7eab6d4867667a5bb279ca + last_write_checksum: sha1:78e34d4e9cba65f5a1dc816c2b3632736031ea26 + pristine_git_object: 19a8ef7386ec3b810ef1172eaf6ff69f8d7599b3 src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegmentKind.java: id: aa52f0330e69 last_write_checksum: sha1:ff72bd6191961b86540665d99a0c29aff66c42a9 @@ -2080,8 +2084,12 @@ trackedFiles: pristine_git_object: d3abff90e68638d3d2290999ff8a1be6855ea41d src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodes.java: id: 5a059559a02f - last_write_checksum: sha1:ae65969665341a71698d1bc59563abfc390b3d61 - pristine_git_object: 64292c487c403a624d52b7e3ba491df6f39318e1 + last_write_checksum: sha1:9e2cb2968302966e6fbb1e6516b3984c7af2d591 + pristine_git_object: c0edcc1dcc42c664f963d553df5dec5a9ec775f8 + src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodesByFramework.java: + id: b17ded1b3953 + last_write_checksum: sha1:d0f59850e71b5afa2446462a7c2ea5c905d1a6ea + pristine_git_object: 0973146012ce13e54542975559add7a415a96d21 src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkId.java: id: 77a079faae9a last_write_checksum: sha1:cf69bcd47af969bfba970e9df83240b59ba5d0ae @@ -2104,8 +2112,8 @@ trackedFiles: pristine_git_object: 6bee16d60c3a0353416c2c511fdaeb15086d9f6c src/main/java/com/vanta/vanta_auditor_api/models/components/InformationRequest.java: id: f4893ae2ac96 - last_write_checksum: sha1:4122d7feafde230d698ca3e18bdc7b00963eb697 - pristine_git_object: 7fe718085d1fd8229bfcd6f5209f221b822d2ae7 + last_write_checksum: sha1:b5b69d3f31ade38c8f157d76b84ff86083a59c79 + pristine_git_object: a6b2947af470881334cad7fd4a99feea146b2006 src/main/java/com/vanta/vanta_auditor_api/models/components/InformationRequestActivityLog.java: id: 90cc6c274b1b last_write_checksum: sha1:4fc0418121a5c2ff4c6ffa2e834af4bcc08ec4fb @@ -3008,8 +3016,8 @@ trackedFiles: pristine_git_object: 58d08c7cfa1682b8a9e0e07e2423c7d87aaf6b19 src/main/java/com/vanta/vanta_auditor_api/models/operations//async/ListInformationRequestsRequestBuilder.java: id: ebbcd59cb776 - last_write_checksum: sha1:c8910ceb1e04b1673baa6c73f09fface65f246a0 - pristine_git_object: 3ddd2e3dfa44e441e2d98b7741b6ff29a28cbd20 + last_write_checksum: sha1:3e706bf9980e9332de6920a3e5898653424829cb + pristine_git_object: d1d760c1c222b77dad3460ec307d90484b6582de src/main/java/com/vanta/vanta_auditor_api/models/operations//async/ListIntegrationsRequestBuilder.java: id: df90da4986b8 last_write_checksum: sha1:afb0424113a1511c5c55f50e90de671945daee76 @@ -3540,12 +3548,12 @@ trackedFiles: pristine_git_object: bfac7c7eef3b263fad05a73e50616ba32f2bb65d src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequest.java: id: 861131a1b6cb - last_write_checksum: sha1:f77630f7bd21c86f3beb91da35928ed5ece3294e - pristine_git_object: f9d6e133a7713a5a270772a4f596fc2e2c66063c + last_write_checksum: sha1:03006f56608c811b34eed8270b0d4dbda0b2ab70 + pristine_git_object: 916b902e7707225fd57255a81ad8094153ee3230 src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequestBuilder.java: id: 25c8d2cfc171 - last_write_checksum: sha1:d8a9ec51af35de91a9bc95d6a642512c38b88569 - pristine_git_object: 235a967517ea24ff8aeb908b6b52e8a7a74de174 + last_write_checksum: sha1:44ffc7826b5e5ba9a2e34e0f0ea3bdce19ef9aa1 + pristine_git_object: ac6b19d7bee35611804b8ece2fe8dc6170c36924 src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsResponse.java: id: 8e4249c55061 last_write_checksum: sha1:55ef7a0d466b277c53f8983d834796053b96aea1 @@ -4490,7 +4498,7 @@ examples: pageSize: 10 responses: "200": - application/json: {"results": {"data": [{"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"id": "soc2", "displayName": "SOC 2 Type II", "shortName": "SOC 2"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]}], "pageInfo": {"endCursor": "YXJyYXljb25uZWN0aW9uOjE=", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "YXJyYXljb25uZWN0aW9uOjA="}}} + application/json: {"results": {"data": [{"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"displayName": "SOC 2 Type II"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]}], "pageInfo": {"endCursor": "YXJyYXljb25uZWN0aW9uOjE=", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "YXJyYXljb25uZWN0aW9uOjA="}}} ListAuditEvidenceUrls: Example 1: parameters: @@ -4588,7 +4596,7 @@ examples: auditId: "" responses: "200": - application/json: {"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"id": "soc2", "displayName": "SOC 2 Type II", "shortName": "SOC 2"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]} + application/json: {"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"displayName": "SOC 2 Type II"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]} ListInformationRequestsForControl: Example 1: parameters: @@ -4599,7 +4607,7 @@ examples: pageSize: 10 responses: "200": - application/json: {"results": {"data": [{"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": ["SOC2_CC6.1"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}}], "pageInfo": {"endCursor": "Njg5MGU0NzNkY2UxZGE1Z", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "Njg5MGU0NzNkY2UxZGE1Z"}}} + application/json: {"results": {"data": [{"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": [], "segmentIds": ["65fc81a3359c8508c9af880f"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}}], "pageInfo": {"endCursor": "Njg5MGU0NzNkY2UxZGE1Z", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "Njg5MGU0NzNkY2UxZGE1Z"}}} GetFrameworkCodes: Example 1: parameters: @@ -4607,7 +4615,7 @@ examples: auditId: "" responses: "200": - application/json: {"frameworkCodes": ["CC1.1", "CC1.2", "CC1.3", "CC2.1", "CC2.2", "CC3.1", "CC3.2", "CC4.1", "CC4.2", "CC5.1", "CC5.2", "CC6.1", "CC6.2", "CC7.1", "CC7.2", "CC8.1", "CC8.2"]} + application/json: {"frameworkCodes": ["164.308", "164.312", "164.314", "CC1.1", "CC1.2", "CC1.3", "CC2.1", "CC2.2", "CC3.1", "CC3.2", "CC4.1", "CC4.2", "CC5.1", "CC5.2", "CC6.1", "CC6.2", "CC7.1", "CC7.2", "CC8.1", "CC8.2"], "codesByFramework": [{"framework": "SOC 2 Type II", "codes": ["CC1.1", "CC1.2", "CC1.3", "CC2.1", "CC2.2", "CC3.1", "CC3.2", "CC4.1", "CC4.2", "CC5.1", "CC5.2", "CC6.1", "CC6.2", "CC7.1", "CC7.2", "CC8.1", "CC8.2"]}, {"framework": "HIPAA", "codes": ["164.308", "164.312", "164.314"]}]} ListInformationRequests: Example 1: parameters: @@ -4617,7 +4625,7 @@ examples: pageSize: 10 responses: "200": - application/json: {"results": {"data": [{"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": ["SOC2_CC6.1"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}}], "pageInfo": {"endCursor": "Njg5MGU0NzNkY2UxZGE1Z", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "Njg5MGU0NzNkY2UxZGE1Z"}}} + application/json: {"results": {"data": [{"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": [], "segmentIds": ["65fc81a3359c8508c9af880f"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}}], "pageInfo": {"endCursor": "Njg5MGU0NzNkY2UxZGE1Z", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "Njg5MGU0NzNkY2UxZGE1Z"}}} CreateInformationRequest: Example 1: parameters: @@ -4627,7 +4635,7 @@ examples: application/json: {"uniqueId": "", "title": "", "requestType": "SAMPLE", "frameworkCodes": []} responses: "201": - application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": ["SOC2_CC6.1"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} + application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": [], "segmentIds": ["65fc81a3359c8508c9af880f"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} GetInformationRequest: Example 1: parameters: @@ -4636,7 +4644,7 @@ examples: requestId: "" responses: "200": - application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": ["SOC2_CC6.1"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} + application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": [], "segmentIds": ["65fc81a3359c8508c9af880f"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} UpdateInformationRequest: Example 1: parameters: @@ -4647,7 +4655,7 @@ examples: application/json: {} responses: "200": - application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": ["SOC2_CC6.1"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} + application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": [], "segmentIds": ["65fc81a3359c8508c9af880f"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} DeleteInformationRequest: speakeasy-default-delete-information-request: parameters: @@ -4664,7 +4672,7 @@ examples: application/json: {"auditorEmail": ""} responses: "200": - application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": ["SOC2_CC6.1"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} + application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": [], "segmentIds": ["65fc81a3359c8508c9af880f"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} ListInformationRequestActivity: Example 1: parameters: @@ -4750,7 +4758,7 @@ examples: application/json: {"auditorEmail": "", "reason": ""} responses: "200": - application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": ["SOC2_CC6.1"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} + application/json: {"id": "6890e473dce1da5d8406f5e7", "uniqueId": "1466132", "additionalControlIds": [], "approvalStatus": "NEEDS_EVIDENCE", "cadence": "ANNUALLY", "frameworkCodes": [], "segmentIds": ["65fc81a3359c8508c9af880f"], "description": "Provide the data deletion evidence for a sample of terminated customers", "dueDate": "2025-10-28T00:00:00.000Z", "evidenceCaptureDate": "2025-10-28T00:00:00.000Z", "requestId": null, "requestType": "SAMPLE", "title": "Terminated Customer Deletion Evidence", "creationDate": "2025-08-01T12:34:56.000Z", "modificationDate": "2025-08-02T08:00:00.000Z", "deletionDate": null, "ownerAssignment": {"displayName": "John Doe", "id": "507f1f77bcf86cd799439011", "type": "user"}} ListAuditIssues: Example 1: parameters: @@ -4778,7 +4786,7 @@ examples: auditId: "" responses: "200": - application/json: {"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"id": "soc2", "displayName": "SOC 2 Type II", "shortName": "SOC 2"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]} + application/json: {"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"displayName": "SOC 2 Type II"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]} ListCodeChanges: Example 1: parameters: @@ -4996,7 +5004,7 @@ examples: application/json: {"sourceAuditId": "", "displayName": "Orpha.Schoen", "auditStartDate": "2024-01-02T08:34:53.150Z", "auditEndDate": "2024-10-06T07:06:05.931Z", "earlyAccessStartsAt": "2025-05-31T02:08:59.254Z", "allowAuditorEmails": ["", "", ""]} responses: "200": - application/json: {"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"id": "soc2", "displayName": "SOC 2 Type II", "shortName": "SOC 2"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]} + application/json: {"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56.000Z", "auditEndDate": "2024-03-14T21:25:56.000Z", "earlyAccessStartsAt": "2024-03-07T21:25:56.000Z", "framework": "SOC 2 Type II", "displayName": "Q1 2024 SOC 2 Audit", "allowAuditorEmails": ["sam@auditor.com"], "allowAllAuditors": true, "deletionDate": null, "creationDate": "2024-03-07T21:25:56.000Z", "modificationDate": "2024-03-07T21:25:56.000Z", "completionDate": "2024-03-07T21:25:56.000Z", "auditFocus": "EXTERNAL", "auditorRequestListMetadata": {"requestsSharedWithCustomer": "2024-03-07T21:25:56.000Z"}, "segments": [{"id": "65fc81a3359c8508c9af8810", "kind": "PROGRAM", "displayName": "SOC 2 Type II", "framework": {"displayName": "SOC 2 Type II"}, "businessUnit": null, "system": null, "soc2Deliverable": {"reportType": "soc2type2", "tscs": ["SECURITY", "AVAILABILITY"]}}]} UpsertAssessmentForControl: Example 1: parameters: diff --git a/.speakeasy/gen.yaml b/.speakeasy/gen.yaml index 9c76d85..314ca34 100644 --- a/.speakeasy/gen.yaml +++ b/.speakeasy/gen.yaml @@ -29,7 +29,7 @@ generation: generateNewTests: false skipResponseBodyAssertions: false java: - version: 0.7.1 + version: 0.7.2 additionalDependencies: [] additionalPlugins: [] artifactID: vanta-auditor-api diff --git a/.speakeasy/workflow.lock b/.speakeasy/workflow.lock index 2e5a679..4659a93 100644 --- a/.speakeasy/workflow.lock +++ b/.speakeasy/workflow.lock @@ -1,9 +1,9 @@ -speakeasyVersion: 1.796.3 +speakeasyVersion: 1.796.4 sources: Conduct an audit: sourceNamespace: conduct-an-audit - sourceRevisionDigest: sha256:b85d80fa982253b86c39caf974f326b63cd53fa1adcff3bc5dd9064ed67d942b - sourceBlobDigest: sha256:0026fc0f213208248eb15bde758f8e30038ebaf9565bda530f2165f57fe26068 + sourceRevisionDigest: sha256:b0ba0c4fec0d2695d468690c7b83e3d6327f920ae83fae38b96db5c33a5abf27 + sourceBlobDigest: sha256:b0049e2a84958e83af38b029b8350485874c851d9daf443484d510342fbbfd9a tags: - latest - 1.0.0 @@ -11,10 +11,10 @@ targets: vanta: source: Conduct an audit sourceNamespace: conduct-an-audit - sourceRevisionDigest: sha256:b85d80fa982253b86c39caf974f326b63cd53fa1adcff3bc5dd9064ed67d942b - sourceBlobDigest: sha256:0026fc0f213208248eb15bde758f8e30038ebaf9565bda530f2165f57fe26068 + sourceRevisionDigest: sha256:b0ba0c4fec0d2695d468690c7b83e3d6327f920ae83fae38b96db5c33a5abf27 + sourceBlobDigest: sha256:b0049e2a84958e83af38b029b8350485874c851d9daf443484d510342fbbfd9a codeSamplesNamespace: conduct-an-audit-java-code-samples - codeSamplesRevisionDigest: sha256:cb4dc035743d1e56038584a553b2a5101d5c3eb9570c4737612b2f6932982d96 + codeSamplesRevisionDigest: sha256:7d467109c72fa6d42706f016681f366a298566f6d66d2866ebe0c506916050fb workflow: workflowVersion: 1.0.0 speakeasyVersion: latest diff --git a/README.md b/README.md index fbe47cb..edbff28 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ The samples below show how a published SDK artifact is used: Gradle: ```groovy -implementation 'com.vanta:vanta-auditor-api:0.7.1' +implementation 'com.vanta:vanta-auditor-api:0.7.2' ``` Maven: @@ -57,7 +57,7 @@ Maven: com.vanta vanta-auditor-api - 0.7.1 + 0.7.2 ``` diff --git a/RELEASES.md b/RELEASES.md index 447432b..209bf5a 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -348,4 +348,14 @@ Based on: ### Generated - [java v0.7.1] . ### Releases -- [Maven Central v0.7.1] https://central.sonatype.com/artifact/com.vanta/vanta-auditor-api/0.7.1 - . \ No newline at end of file +- [Maven Central v0.7.1] https://central.sonatype.com/artifact/com.vanta/vanta-auditor-api/0.7.1 - . + +## 2026-09-04 00:02:54 +### Changes +Based on: +- OpenAPI Doc +- Speakeasy CLI 1.796.4 (2.935.1) https://github.com/speakeasy-api/speakeasy +### Generated +- [java v0.7.2] . +### Releases +- [Maven Central v0.7.2] https://central.sonatype.com/artifact/com.vanta/vanta-auditor-api/0.7.2 - . \ No newline at end of file diff --git a/docs/models/components/Audit.md b/docs/models/components/Audit.md index f564699..bdb6f03 100644 --- a/docs/models/components/Audit.md +++ b/docs/models/components/Audit.md @@ -12,7 +12,7 @@ | `auditStartDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | The start of the audit window. This is also when data collection for audit starts. | | `auditEndDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | The end of the audit window. | | `earlyAccessStartsAt` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | Timestamp at which auditors gain access to the audit. Occurs before the audit window begins | -| ~~`framework`~~ | *String* | :heavy_check_mark: | : warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.

Legacy singular framework display name from the audit type. Incomplete for
a multi-framework audit — use `segments` for framework identity. | +| ~~`framework`~~ | *String* | :heavy_check_mark: | : warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.

Legacy singular framework display name from the audit type. Incomplete for
a multi-framework audit — use `segments` instead. | | `displayName` | *String* | :heavy_check_mark: | The display name for the audit. Returns the custom audit name if set,
otherwise returns the framework name. | | `allowAuditorEmails` | List\<*String*> | :heavy_check_mark: | Emails of auditors with access to audit | | `allowAllAuditors` | *boolean* | :heavy_check_mark: | Set to true if all auditors in audit firm have access | diff --git a/docs/models/components/AuditSegment.md b/docs/models/components/AuditSegment.md index 45a75ab..ba01490 100644 --- a/docs/models/components/AuditSegment.md +++ b/docs/models/components/AuditSegment.md @@ -17,7 +17,7 @@ is set for system segments and null otherwise. | `id` | *String* | :heavy_check_mark: | The unique identifier for the segment. | | `kind` | [AuditSegmentKind](../../models/components/AuditSegmentKind.md) | :heavy_check_mark: | N/A | | `displayName` | *String* | :heavy_check_mark: | The segment's display label. Do not reconstruct this from framework + BU. | -| `framework` | [AuditSegmentFramework](../../models/components/AuditSegmentFramework.md) | :heavy_check_mark: | The framework reached through a segment. | +| `framework` | [AuditSegmentFramework](../../models/components/AuditSegmentFramework.md) | :heavy_check_mark: | The framework this segment is in. | | `businessUnit` | [Optional\](../../models/components/BusinessUnit.md) | :heavy_check_mark: | The business unit this program segment is scoped to, or null when the
segment is not BU-scoped or the BU cannot be resolved. | | `system` | [Optional\](../../models/components/System.md) | :heavy_check_mark: | The information system this system segment is scoped to, or null on
program segments. | | `soc2Deliverable` | [Optional\](../../models/components/Soc2Deliverable.md) | :heavy_check_mark: | SOC 2 report type and Trust Services Criteria for this segment, or null. | \ No newline at end of file diff --git a/docs/models/components/AuditSegmentFramework.md b/docs/models/components/AuditSegmentFramework.md index e7531e0..72bfc2e 100644 --- a/docs/models/components/AuditSegmentFramework.md +++ b/docs/models/components/AuditSegmentFramework.md @@ -1,12 +1,10 @@ # AuditSegmentFramework -The framework reached through a segment. +The framework this segment is in. ## Fields -| Field | Type | Required | Description | -| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | -| `id` | *String* | :heavy_check_mark: | The stable identifier of the framework (for example `soc2`). | -| `displayName` | *String* | :heavy_check_mark: | The human-readable framework name. | -| `shortName` | *String* | :heavy_check_mark: | The short framework name used in compact UI. | \ No newline at end of file +| Field | Type | Required | Description | +| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ | +| `displayName` | *String* | :heavy_check_mark: | Display name of the framework. | \ No newline at end of file diff --git a/docs/models/components/FrameworkCodes.md b/docs/models/components/FrameworkCodes.md index 66cf07f..446b84b 100644 --- a/docs/models/components/FrameworkCodes.md +++ b/docs/models/components/FrameworkCodes.md @@ -5,6 +5,7 @@ Framework codes response resource ## Fields -| Field | Type | Required | Description | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `frameworkCodes` | List\<*String*> | :heavy_check_mark: | Array of valid framework codes for the audit's framework (e.g., "CC6.1", "CC6.2").
These represent the different framework sections available for creating information requests. | \ No newline at end of file +| Field | Type | Required | Description | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ~~`frameworkCodes`~~ | List\<*String*> | :heavy_check_mark: | : warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.

Valid framework codes for this audit. | +| `codesByFramework` | List\<[FrameworkCodesByFramework](../../models/components/FrameworkCodesByFramework.md)> | :heavy_check_mark: | Valid codes grouped by each distinct in-scope framework. A code that exists
on two frameworks appears in both groups. Two segments that share a
framework contribute one group. `framework` is the display name. | \ No newline at end of file diff --git a/docs/models/components/FrameworkCodesByFramework.md b/docs/models/components/FrameworkCodesByFramework.md new file mode 100644 index 0000000..f9ac3f8 --- /dev/null +++ b/docs/models/components/FrameworkCodesByFramework.md @@ -0,0 +1,9 @@ +# FrameworkCodesByFramework + + +## Fields + +| Field | Type | Required | Description | +| ------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- | +| `framework` | *String* | :heavy_check_mark: | Display name of the in-scope framework these codes belong to. | +| `codes` | List\<*String*> | :heavy_check_mark: | Valid codes for this framework, sorted. | \ No newline at end of file diff --git a/docs/models/components/InformationRequest.md b/docs/models/components/InformationRequest.md index c29b80b..4aad85b 100644 --- a/docs/models/components/InformationRequest.md +++ b/docs/models/components/InformationRequest.md @@ -9,21 +9,22 @@ for issues. ## Fields -| Field | Type | Required | Description | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `id` | *String* | :heavy_check_mark: | The unique identifier for the information request within Vanta's system.
This is the primary identifier used in all API endpoints.
Format: ObjectId as a string (e.g., "6890e473dce1da5d8406f5e7") | -| `uniqueId` | *String* | :heavy_check_mark: | External unique ID to prevent duplicates across different audit systems.
Used for idempotency when syncing data between external audit management
systems and Vanta. Unlike `id`, this value is provided by the external system. | -| `additionalControlIds` | List\<*String*> | :heavy_check_mark: | Additional control IDs beyond those automatically mapped from framework codes.
Allows manual association with specific controls when automatic mapping
is insufficient. Each ID should reference a valid control in your audit framework. | -| `approvalStatus` | [InformationRequestApprovalStatus](../../models/components/InformationRequestApprovalStatus.md) | :heavy_check_mark: | Current approval status of the information request, tracking its lifecycle through the audit process.

The status progresses through the workflow: initial state → awaiting review → approved or flagged.
Status can move between awaiting review and flagged states as evidence is reviewed and resubmitted. | -| `cadence` | [Optional\](../../models/components/Cadence.md) | :heavy_check_mark: | How frequently this information request recurs (e.g., annual password
policy reviews). Null for one-time requests. | -| `frameworkCodes` | List\<*String*> | :heavy_check_mark: | The framework codes this request addresses.
Links the request to specific compliance requirements. Can be an empty array
if no framework codes are associated. These codes correspond to standards like SOC 2, ISO 27001, etc. | -| `description` | *Optional\* | :heavy_check_mark: | Detailed description explaining what evidence is needed and why.
Should provide clear instructions to help the customer understand what
to submit. | -| `dueDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | The deadline by which the customer must fulfill this request.
Null if no specific deadline is set. Format: ISO 8601 UTC timestamp. | -| `evidenceCaptureDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | The earliest date for which evidence should be captured.
Evidence dated before this date may not be accepted.
Null if not restricted. Format: ISO 8601 UTC timestamp. | -| `requestId` | *Optional\* | :heavy_check_mark: | Non-unique external reference ID for this request.
Unlike `uniqueId` which must be unique, `requestId` is for display/reference
purposes only (e.g., "REQ-123"). Null if not provided. | -| `requestType` | [InformationRequestType](../../models/components/InformationRequestType.md) | :heavy_check_mark: | Type of information request, defining what scope of evidence is needed.

- POINT_IN_TIME: Evidence for a specific moment (e.g., current state of a policy)
- POPULATION: Evidence covering all items in a category (e.g., all employees)
- SAMPLE: Evidence for a representative sample (e.g., 10 random customer records) | -| `title` | *String* | :heavy_check_mark: | Short, descriptive title summarizing what is being requested. | -| `creationDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | Timestamp when the request was created in the system.
Format: ISO 8601 UTC timestamp. | -| `modificationDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | Timestamp when the request was last modified.
Format: ISO 8601 UTC timestamp. | -| `deletionDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | Timestamp when the request was soft-deleted. Null if the request has not
been deleted. Soft deletes allow retaining history while hiding the request
from normal operations.
Format: ISO 8601 UTC timestamp. | -| `ownerAssignment` | [Optional\](../../models/components/OwnerAssignment.md) | :heavy_check_mark: | Resource owner (user or team) assigned to this information request.
Returns null if no resource owner is assigned. | \ No newline at end of file +| Field | Type | Required | Description | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `id` | *String* | :heavy_check_mark: | The unique identifier for the information request within Vanta's system.
This is the primary identifier used in all API endpoints.
Format: ObjectId as a string (e.g., "6890e473dce1da5d8406f5e7") | +| `uniqueId` | *String* | :heavy_check_mark: | External unique ID to prevent duplicates across different audit systems.
Used for idempotency when syncing data between external audit management
systems and Vanta. Unlike `id`, this value is provided by the external system. | +| `additionalControlIds` | List\<*String*> | :heavy_check_mark: | Additional control IDs beyond those automatically mapped from framework codes.
Allows manual association with specific controls when automatic mapping
is insufficient. Each ID should reference a valid control in your audit framework. | +| `approvalStatus` | [InformationRequestApprovalStatus](../../models/components/InformationRequestApprovalStatus.md) | :heavy_check_mark: | Current approval status of the information request, tracking its lifecycle through the audit process.

The status progresses through the workflow: initial state → awaiting review → approved or flagged.
Status can move between awaiting review and flagged states as evidence is reviewed and resubmitted. | +| `cadence` | [Optional\](../../models/components/Cadence.md) | :heavy_check_mark: | How frequently this information request recurs (e.g., annual password
policy reviews). Null for one-time requests. | +| ~~`frameworkCodes`~~ | List\<*String*> | :heavy_check_mark: | : warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.

Always empty on read. To find requests for a control, use
`GET /audits/{auditId}/controls/{controlId}/information-requests`.
For request assignment, use `segmentIds`. | +| `segmentIds` | List\<*String*> | :heavy_check_mark: | Audit segments this request is assigned to. Empty means unassigned.
Resolved against the current audit scope — stale IDs are dropped.

This field is a current-scope projection, not a stored watermark. An
audit-scope change that drops or adds IDs here does not update
creationDate, modificationDate, or deletionDate, so it does not appear in
`changedSinceDate` delta sync on its own. Re-fetch the list without that
parameter, or GET the request by id, to see the current projection. | +| `description` | *Optional\* | :heavy_check_mark: | Detailed description explaining what evidence is needed and why.
Should provide clear instructions to help the customer understand what
to submit. | +| `dueDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | The deadline by which the customer must fulfill this request.
Null if no specific deadline is set. Format: ISO 8601 UTC timestamp. | +| `evidenceCaptureDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | The earliest date for which evidence should be captured.
Evidence dated before this date may not be accepted.
Null if not restricted. Format: ISO 8601 UTC timestamp. | +| `requestId` | *Optional\* | :heavy_check_mark: | Non-unique external reference ID for this request.
Unlike `uniqueId` which must be unique, `requestId` is for display/reference
purposes only (e.g., "REQ-123"). Null if not provided. | +| `requestType` | [InformationRequestType](../../models/components/InformationRequestType.md) | :heavy_check_mark: | Type of information request, defining what scope of evidence is needed.

- POINT_IN_TIME: Evidence for a specific moment (e.g., current state of a policy)
- POPULATION: Evidence covering all items in a category (e.g., all employees)
- SAMPLE: Evidence for a representative sample (e.g., 10 random customer records) | +| `title` | *String* | :heavy_check_mark: | Short, descriptive title summarizing what is being requested. | +| `creationDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | Timestamp when the request was created in the system.
Format: ISO 8601 UTC timestamp. | +| `modificationDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | Timestamp when the request was last modified.
Format: ISO 8601 UTC timestamp. | +| `deletionDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_check_mark: | Timestamp when the request was soft-deleted. Null if the request has not
been deleted. Soft deletes allow retaining history while hiding the request
from normal operations.
Format: ISO 8601 UTC timestamp. | +| `ownerAssignment` | [Optional\](../../models/components/OwnerAssignment.md) | :heavy_check_mark: | Resource owner (user or team) assigned to this information request.
Returns null if no resource owner is assigned. | \ No newline at end of file diff --git a/docs/models/operations/ListInformationRequestsRequest.md b/docs/models/operations/ListInformationRequestsRequest.md index a084ac2..1f48952 100644 --- a/docs/models/operations/ListInformationRequestsRequest.md +++ b/docs/models/operations/ListInformationRequestsRequest.md @@ -3,9 +3,10 @@ ## Fields -| Field | Type | Required | Description | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `auditId` | *String* | :heavy_check_mark: | N/A | -| `pageSize` | *Optional\* | :heavy_minus_sign: | Maximum number of information requests to return per page. | -| `pageCursor` | *Optional\* | :heavy_minus_sign: | Pagination cursor from a previous response. Provide to fetch the next page of results. | -| `changedSinceDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_minus_sign: | Includes all information requests that have changed since changedSinceDate.
Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. | \ No newline at end of file +| Field | Type | Required | Description | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `auditId` | *String* | :heavy_check_mark: | N/A | +| `pageSize` | *Optional\* | :heavy_minus_sign: | Maximum number of information requests to return per page. | +| `pageCursor` | *Optional\* | :heavy_minus_sign: | Pagination cursor from a previous response. Provide to fetch the next page of results. | +| `changedSinceDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_minus_sign: | Includes all information requests that have changed since changedSinceDate.
Considers creationDate, modificationDate, and deletionDate timestamps when determining changes.
Does not include requests whose only change is the derived `segmentIds`
projection after an audit-scope change. | +| `segmentIdsMatchesAny` | List\<*String*> | :heavy_minus_sign: | Return requests whose stored segment assignment includes any of these
IDs (OR). Omit to return all. A match can still come back with
`segmentIds: []` if the stored ID is no longer in the audit's scope. | \ No newline at end of file diff --git a/docs/sdks/audits/README.md b/docs/sdks/audits/README.md index e2d9ba6..3452d7f 100644 --- a/docs/sdks/audits/README.md +++ b/docs/sdks/audits/README.md @@ -73,7 +73,7 @@ Each audit includes `segments`, the audit's scope. A live single-framework audit has one entry; a live multi-framework audit has one entry per in-scope framework (and business unit or system, when applicable). Soft-deleted audits return an empty list. The top-level `framework` field -is deprecated; use `segments` for framework identity. +is deprecated; use `segments` for in-scope frameworks. Rate limit: 250 requests / minute. @@ -223,7 +223,7 @@ The response includes `segments`, the audit's scope. A live single-framework audit has one entry; a live multi-framework audit has one entry per in-scope framework (and business unit or system, when applicable). Soft-deleted audits return an empty list. The top-level `framework` field -is deprecated; use `segments` for framework identity. +is deprecated; use `segments` for in-scope frameworks. Rate limit: 250 requests / minute. @@ -871,8 +871,9 @@ public class Application { Returns a paginated list of active information requests linked to a specific control within an IRL audit. An information request is linked to a control -either via its framework codes (`criteriaIds`) or via a direct association -(`additionalControlIds`). +via its framework codes (`criteriaIds`), a direct association +(`additionalControlIds`), or an owned AuditControl row attached in Vanta +(`additionalAuditControlIds`). Soft-deleted information requests are not included in the response. To synchronize deletions, use `GET /audits/{auditId}/information-requests`, @@ -1372,9 +1373,9 @@ public class Application { Retrieves all valid framework codes for the specified audit. This endpoint helps users discover which framework codes are available for creating and updating information requests for this audit. Use this endpoint to: -- Discover available framework codes before creating information requests -- Validate framework codes against the audit's framework -- Get context about what framework codes are available for the audit type +- Discover available framework codes (`frameworkCodes`, the original flat list) +- Validate framework codes against the audit's frameworks +- See which codes belong to which in-scope framework (`codesByFramework`) Rate limit: 50 requests / minute. @@ -1448,6 +1449,11 @@ Delta sync usage: 4. Process updates and soft-deletes by checking the `deletionDate` field 5. Update your last sync timestamp to the current time +`segmentIds` on each returned request is resolved against the audit's +current scope. A scope-only change (a segment leaving or joining the audit +without the request row being written) is not a delta-sync event. Re-fetch +without `changedSinceDate`, or GET by id, to see the current projection. + Rate limit: 50 requests / minute. ### Example Usage @@ -1457,6 +1463,7 @@ Rate limit: 50 requests / minute. package hello.world; import com.vanta.vanta_auditor_api.Vanta; +import com.vanta.vanta_auditor_api.models.operations.ListInformationRequestsRequest; import com.vanta.vanta_auditor_api.models.operations.ListInformationRequestsResponse; import java.lang.Exception; @@ -1468,9 +1475,12 @@ public class Application { .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", "")) .build(); - ListInformationRequestsResponse res = sdk.audits().listInformationRequests() + ListInformationRequestsRequest req = ListInformationRequestsRequest.builder() .auditId("") - .pageSize(10) + .build(); + + ListInformationRequestsResponse res = sdk.audits().listInformationRequests() + .request(req) .call(); if (res.paginatedResponseInformationRequest().isPresent()) { @@ -1482,12 +1492,9 @@ public class Application { ### Parameters -| Parameter | Type | Required | Description | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `auditId` | *String* | :heavy_check_mark: | N/A | -| `pageSize` | *Optional\* | :heavy_minus_sign: | Maximum number of information requests to return per page. | -| `pageCursor` | *Optional\* | :heavy_minus_sign: | Pagination cursor from a previous response. Provide to fetch the next page of results. | -| `changedSinceDate` | [OffsetDateTime](https://docs.oracle.com/javase/8/docs/api/java/time/OffsetDateTime.html) | :heavy_minus_sign: | Includes all information requests that have changed since changedSinceDate.
Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. | +| Parameter | Type | Required | Description | +| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | +| `request` | [ListInformationRequestsRequest](../../models/operations/ListInformationRequestsRequest.md) | :heavy_check_mark: | The request object to use for the request. | ### Response diff --git a/gradle.properties b/gradle.properties index d6a5dc7..923901a 100644 --- a/gradle.properties +++ b/gradle.properties @@ -1,4 +1,4 @@ groupId=com.vanta artifactId=vanta-auditor-api -version=0.7.1 +version=0.7.2 org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g diff --git a/src/main/java/com/vanta/vanta_auditor_api/AsyncAudits.java b/src/main/java/com/vanta/vanta_auditor_api/AsyncAudits.java index 6dab85b..2f53f11 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/AsyncAudits.java +++ b/src/main/java/com/vanta/vanta_auditor_api/AsyncAudits.java @@ -289,7 +289,7 @@ public Audits sync() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -312,7 +312,7 @@ public ListAuditsRequestBuilder list() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -337,7 +337,7 @@ public CompletableFuture listDirect() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -449,7 +449,7 @@ public CompletableFuture duplicate(DuplicateAuditRequest requ * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -472,7 +472,7 @@ public GetAuditRequestBuilder getAudit() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -1031,8 +1031,9 @@ public CompletableFuture deleteCommentForContro * *

Returns a paginated list of active information requests linked to a specific * control within an IRL audit. An information request is linked to a control - * either via its framework codes (`criteriaIds`) or via a direct association - * (`additionalControlIds`). + * via its framework codes (`criteriaIds`), a direct association + * (`additionalControlIds`), or an owned AuditControl row attached in Vanta + * (`additionalAuditControlIds`). * *

Soft-deleted information requests are not included in the response. To * synchronize deletions, use `GET /audits/{auditId}/information-requests`, @@ -1060,8 +1061,9 @@ public ListInformationRequestsForControlRequestBuilder listInformationRequestsFo * *

Returns a paginated list of active information requests linked to a specific * control within an IRL audit. An information request is linked to a control - * either via its framework codes (`criteriaIds`) or via a direct association - * (`additionalControlIds`). + * via its framework codes (`criteriaIds`), a direct association + * (`additionalControlIds`), or an owned AuditControl row attached in Vanta + * (`additionalAuditControlIds`). * *

Soft-deleted information requests are not included in the response. To * synchronize deletions, use `GET /audits/{auditId}/information-requests`, @@ -1093,8 +1095,9 @@ public CompletableFuture listInformat * *

Returns a paginated list of active information requests linked to a specific * control within an IRL audit. An information request is linked to a control - * either via its framework codes (`criteriaIds`) or via a direct association - * (`additionalControlIds`). + * via its framework codes (`criteriaIds`), a direct association + * (`additionalControlIds`), or an owned AuditControl row attached in Vanta + * (`additionalAuditControlIds`). * *

Soft-deleted information requests are not included in the response. To * synchronize deletions, use `GET /audits/{auditId}/information-requests`, @@ -1527,9 +1530,9 @@ public CompletableFuture getEvidenceUrls( * which framework codes are available for creating and updating information requests for this audit. * *

Use this endpoint to: - * - Discover available framework codes before creating information requests - * - Validate framework codes against the audit's framework - * - Get context about what framework codes are available for the audit type + * - Discover available framework codes (`frameworkCodes`, the original flat list) + * - Validate framework codes against the audit's frameworks + * - See which codes belong to which in-scope framework (`codesByFramework`) * *

Rate limit: 50 requests / minute. * @@ -1546,9 +1549,9 @@ public GetFrameworkCodesRequestBuilder getFrameworkCodes() { * which framework codes are available for creating and updating information requests for this audit. * *

Use this endpoint to: - * - Discover available framework codes before creating information requests - * - Validate framework codes against the audit's framework - * - Get context about what framework codes are available for the audit type + * - Discover available framework codes (`frameworkCodes`, the original flat list) + * - Validate framework codes against the audit's frameworks + * - See which codes belong to which in-scope framework (`codesByFramework`) * *

Rate limit: 50 requests / minute. * @@ -1594,6 +1597,11 @@ public CompletableFuture getFrameworkCodes(String aud * 4. Process updates and soft-deletes by checking the `deletionDate` field * 5. Update your last sync timestamp to the current time * + *

`segmentIds` on each returned request is resolved against the audit's + * current scope. A scope-only change (a segment leaving or joining the audit + * without the request row being written) is not a delta-sync event. Re-fetch + * without `changedSinceDate`, or GET by id, to see the current projection. + * *

Rate limit: 50 requests / minute. * * @return The async call builder @@ -1628,63 +1636,17 @@ public ListInformationRequestsRequestBuilder listInformationRequests() { * 4. Process updates and soft-deletes by checking the `deletionDate` field * 5. Update your last sync timestamp to the current time * - *

Rate limit: 50 requests / minute. - * - * @param auditId - * @return {@code CompletableFuture} - The async response - */ - public CompletableFuture listInformationRequests(String auditId) { - return listInformationRequests( - auditId, Optional.empty(), Optional.empty(), - Optional.empty()); - } - - /** - * List information requests for an audit - * - *

Retrieves a paginated list of all information requests for an audit, enabling - * external audit management systems to display and track evidence requests. - * - *

This endpoint always includes soft-deleted records (where `deletionDate !== null`). - * Clients should check the `deletionDate` field to identify and handle deleted records - * appropriately in their systems. - * - *

This endpoint supports delta synchronization via the `changedSinceDate` parameter, - * allowing efficient polling for changes without retrieving the entire dataset. - * - *

Pagination usage: - * 1. Make initial request with desired `pageSize` - * 2. Check `results.pageInfo.hasNextPage` to see if more data exists - * 3. If true, use `results.pageInfo.endCursor` as `pageCursor` in next request - * 4. Repeat until `hasNextPage` is false - * - *

Delta sync usage: - * 1. Store the timestamp of your last sync - * 2. Pass that timestamp as `changedSinceDate` - * 3. Only requests created, modified, or deleted since that timestamp are returned - * 4. Process updates and soft-deletes by checking the `deletionDate` field - * 5. Update your last sync timestamp to the current time + *

`segmentIds` on each returned request is resolved against the audit's + * current scope. A scope-only change (a segment leaving or joining the audit + * without the request row being written) is not a delta-sync event. Re-fetch + * without `changedSinceDate`, or GET by id, to see the current projection. * *

Rate limit: 50 requests / minute. * - * @param auditId - * @param pageSize Maximum number of information requests to return per page. - * @param pageCursor Pagination cursor from a previous response. Provide to fetch the next page of results. - * @param changedSinceDate Includes all information requests that have changed since changedSinceDate. - * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * @param request The request object containing all the parameters for the API call. * @return {@code CompletableFuture} - The async response */ - public CompletableFuture listInformationRequests( - String auditId, Optional pageSize, - Optional pageCursor, Optional changedSinceDate) { - ListInformationRequestsRequest request = - ListInformationRequestsRequest - .builder() - .auditId(auditId) - .pageSize(pageSize) - .pageCursor(pageCursor) - .changedSinceDate(changedSinceDate) - .build(); + public CompletableFuture listInformationRequests(ListInformationRequestsRequest request) { AsyncRequestOperation operation = new ListInformationRequests.Async(sdkConfiguration, _headers); return operation.doRequest(request) diff --git a/src/main/java/com/vanta/vanta_auditor_api/Audits.java b/src/main/java/com/vanta/vanta_auditor_api/Audits.java index 252b3b6..051bd78 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/Audits.java +++ b/src/main/java/com/vanta/vanta_auditor_api/Audits.java @@ -287,7 +287,7 @@ public AsyncAudits async() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -310,7 +310,7 @@ public ListAuditsRequestBuilder list() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -335,7 +335,7 @@ public ListAuditsResponse listDirect() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -445,7 +445,7 @@ public DuplicateResponse duplicate(DuplicateAuditRequest request) { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -468,7 +468,7 @@ public GetAuditRequestBuilder getAudit() { * audit has one entry; a live multi-framework audit has one entry per * in-scope framework (and business unit or system, when applicable). * Soft-deleted audits return an empty list. The top-level `framework` field - * is deprecated; use `segments` for framework identity. + * is deprecated; use `segments` for in-scope frameworks. * *

Rate limit: 250 requests / minute. * @@ -1017,8 +1017,9 @@ public DeleteCommentForControlResponse deleteCommentForControl( * *

Returns a paginated list of active information requests linked to a specific * control within an IRL audit. An information request is linked to a control - * either via its framework codes (`criteriaIds`) or via a direct association - * (`additionalControlIds`). + * via its framework codes (`criteriaIds`), a direct association + * (`additionalControlIds`), or an owned AuditControl row attached in Vanta + * (`additionalAuditControlIds`). * *

Soft-deleted information requests are not included in the response. To * synchronize deletions, use `GET /audits/{auditId}/information-requests`, @@ -1046,8 +1047,9 @@ public ListInformationRequestsForControlRequestBuilder listInformationRequestsFo * *

Returns a paginated list of active information requests linked to a specific * control within an IRL audit. An information request is linked to a control - * either via its framework codes (`criteriaIds`) or via a direct association - * (`additionalControlIds`). + * via its framework codes (`criteriaIds`), a direct association + * (`additionalControlIds`), or an owned AuditControl row attached in Vanta + * (`additionalAuditControlIds`). * *

Soft-deleted information requests are not included in the response. To * synchronize deletions, use `GET /audits/{auditId}/information-requests`, @@ -1079,8 +1081,9 @@ public ListInformationRequestsForControlResponse listInformationRequestsForContr * *

Returns a paginated list of active information requests linked to a specific * control within an IRL audit. An information request is linked to a control - * either via its framework codes (`criteriaIds`) or via a direct association - * (`additionalControlIds`). + * via its framework codes (`criteriaIds`), a direct association + * (`additionalControlIds`), or an owned AuditControl row attached in Vanta + * (`additionalAuditControlIds`). * *

Soft-deleted information requests are not included in the response. To * synchronize deletions, use `GET /audits/{auditId}/information-requests`, @@ -1505,9 +1508,9 @@ public ListAuditEvidenceUrlsResponse getEvidenceUrls( * which framework codes are available for creating and updating information requests for this audit. * *

Use this endpoint to: - * - Discover available framework codes before creating information requests - * - Validate framework codes against the audit's framework - * - Get context about what framework codes are available for the audit type + * - Discover available framework codes (`frameworkCodes`, the original flat list) + * - Validate framework codes against the audit's frameworks + * - See which codes belong to which in-scope framework (`codesByFramework`) * *

Rate limit: 50 requests / minute. * @@ -1524,9 +1527,9 @@ public GetFrameworkCodesRequestBuilder getFrameworkCodes() { * which framework codes are available for creating and updating information requests for this audit. * *

Use this endpoint to: - * - Discover available framework codes before creating information requests - * - Validate framework codes against the audit's framework - * - Get context about what framework codes are available for the audit type + * - Discover available framework codes (`frameworkCodes`, the original flat list) + * - Validate framework codes against the audit's frameworks + * - See which codes belong to which in-scope framework (`codesByFramework`) * *

Rate limit: 50 requests / minute. * @@ -1571,6 +1574,11 @@ public GetFrameworkCodesResponse getFrameworkCodes(String auditId) { * 4. Process updates and soft-deletes by checking the `deletionDate` field * 5. Update your last sync timestamp to the current time * + *

`segmentIds` on each returned request is resolved against the audit's + * current scope. A scope-only change (a segment leaving or joining the audit + * without the request row being written) is not a delta-sync event. Re-fetch + * without `changedSinceDate`, or GET by id, to see the current projection. + * *

Rate limit: 50 requests / minute. * * @return The call builder @@ -1605,64 +1613,18 @@ public ListInformationRequestsRequestBuilder listInformationRequests() { * 4. Process updates and soft-deletes by checking the `deletionDate` field * 5. Update your last sync timestamp to the current time * - *

Rate limit: 50 requests / minute. - * - * @param auditId - * @return The response from the API call - * @throws RuntimeException subclass if the API call fails - */ - public ListInformationRequestsResponse listInformationRequests(String auditId) { - return listInformationRequests(auditId, Optional.empty(), Optional.empty(), - Optional.empty()); - } - - /** - * List information requests for an audit - * - *

Retrieves a paginated list of all information requests for an audit, enabling - * external audit management systems to display and track evidence requests. - * - *

This endpoint always includes soft-deleted records (where `deletionDate !== null`). - * Clients should check the `deletionDate` field to identify and handle deleted records - * appropriately in their systems. - * - *

This endpoint supports delta synchronization via the `changedSinceDate` parameter, - * allowing efficient polling for changes without retrieving the entire dataset. - * - *

Pagination usage: - * 1. Make initial request with desired `pageSize` - * 2. Check `results.pageInfo.hasNextPage` to see if more data exists - * 3. If true, use `results.pageInfo.endCursor` as `pageCursor` in next request - * 4. Repeat until `hasNextPage` is false - * - *

Delta sync usage: - * 1. Store the timestamp of your last sync - * 2. Pass that timestamp as `changedSinceDate` - * 3. Only requests created, modified, or deleted since that timestamp are returned - * 4. Process updates and soft-deletes by checking the `deletionDate` field - * 5. Update your last sync timestamp to the current time + *

`segmentIds` on each returned request is resolved against the audit's + * current scope. A scope-only change (a segment leaving or joining the audit + * without the request row being written) is not a delta-sync event. Re-fetch + * without `changedSinceDate`, or GET by id, to see the current projection. * *

Rate limit: 50 requests / minute. * - * @param auditId - * @param pageSize Maximum number of information requests to return per page. - * @param pageCursor Pagination cursor from a previous response. Provide to fetch the next page of results. - * @param changedSinceDate Includes all information requests that have changed since changedSinceDate. - * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * @param request The request object containing all the parameters for the API call. * @return The response from the API call * @throws RuntimeException subclass if the API call fails */ - public ListInformationRequestsResponse listInformationRequests( - String auditId, Optional pageSize, - Optional pageCursor, Optional changedSinceDate) { - ListInformationRequestsRequest request = - ListInformationRequestsRequest - .builder() - .auditId(auditId) - .pageSize(pageSize) - .pageCursor(pageCursor) - .changedSinceDate(changedSinceDate) - .build(); + public ListInformationRequestsResponse listInformationRequests(ListInformationRequestsRequest request) { RequestOperation operation = new ListInformationRequests.Sync(sdkConfiguration, _headers); return operation.handleResponse(operation.doRequest(request)); diff --git a/src/main/java/com/vanta/vanta_auditor_api/SDKConfiguration.java b/src/main/java/com/vanta/vanta_auditor_api/SDKConfiguration.java index 0b48cb2..bd74339 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/SDKConfiguration.java +++ b/src/main/java/com/vanta/vanta_auditor_api/SDKConfiguration.java @@ -19,8 +19,8 @@ public class SDKConfiguration { private static final String LANGUAGE = "java"; public static final String OPENAPI_DOC_VERSION = "1.0.0"; - public static final String SDK_VERSION = "0.7.1"; - public static final String GEN_VERSION = "2.934.1"; + public static final String SDK_VERSION = "0.7.2"; + public static final String GEN_VERSION = "2.935.1"; private static final String BASE_PACKAGE = "com.vanta.vanta_auditor_api"; public static final String USER_AGENT = String.format("speakeasy-sdk/%s %s %s %s %s", diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/components/Audit.java b/src/main/java/com/vanta/vanta_auditor_api/models/components/Audit.java index 8d65e09..7336bcb 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/components/Audit.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/components/Audit.java @@ -66,7 +66,7 @@ public class Audit { /** * Legacy singular framework display name from the audit type. Incomplete for - * a multi-framework audit — use `segments` for framework identity. + * a multi-framework audit — use `segments` instead. * * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ @@ -280,7 +280,7 @@ public Optional earlyAccessStartsAt() { /** * Legacy singular framework display name from the audit type. Incomplete for - * a multi-framework audit — use `segments` for framework identity. + * a multi-framework audit — use `segments` instead. * * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ @@ -465,7 +465,7 @@ public Audit withEarlyAccessStartsAt(Optional earlyAccessStartsA /** * Legacy singular framework display name from the audit type. Incomplete for - * a multi-framework audit — use `segments` for framework identity. + * a multi-framework audit — use `segments` instead. * * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ @@ -811,7 +811,7 @@ public Builder earlyAccessStartsAt(Optional earlyAccessStartsAt) /** * Legacy singular framework display name from the audit type. Incomplete for - * a multi-framework audit — use `segments` for framework identity. + * a multi-framework audit — use `segments` instead. * * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegment.java b/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegment.java index 18aea97..93f3094 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegment.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegment.java @@ -44,7 +44,7 @@ public class AuditSegment { private String displayName; /** - * The framework reached through a segment. + * The framework this segment is in. */ @JsonProperty("framework") private AuditSegmentFramework framework; @@ -129,7 +129,7 @@ public String displayName() { } /** - * The framework reached through a segment. + * The framework this segment is in. */ @JsonIgnore public AuditSegmentFramework framework() { @@ -195,7 +195,7 @@ public AuditSegment withDisplayName(String displayName) { } /** - * The framework reached through a segment. + * The framework this segment is in. */ public AuditSegment withFramework(AuditSegmentFramework framework) { Utils.checkNotNull(framework, "framework"); @@ -353,7 +353,7 @@ public Builder displayName(String displayName) { /** - * The framework reached through a segment. + * The framework this segment is in. */ public Builder framework(AuditSegmentFramework framework) { Utils.checkNotNull(framework, "framework"); diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegmentFramework.java b/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegmentFramework.java index faa3820..19a8ef7 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegmentFramework.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/components/AuditSegmentFramework.java @@ -13,80 +13,37 @@ /** * AuditSegmentFramework * - *

The framework reached through a segment. + *

The framework this segment is in. */ public class AuditSegmentFramework { /** - * The stable identifier of the framework (for example `soc2`). - */ - @JsonProperty("id") - private String id; - - /** - * The human-readable framework name. + * Display name of the framework. */ @JsonProperty("displayName") private String displayName; - /** - * The short framework name used in compact UI. - */ - @JsonProperty("shortName") - private String shortName; - @JsonCreator public AuditSegmentFramework( - @JsonProperty("id") String id, - @JsonProperty("displayName") String displayName, - @JsonProperty("shortName") String shortName) { - Utils.checkNotNull(id, "id"); + @JsonProperty("displayName") String displayName) { Utils.checkNotNull(displayName, "displayName"); - Utils.checkNotNull(shortName, "shortName"); - this.id = id; this.displayName = displayName; - this.shortName = shortName; - } - - /** - * The stable identifier of the framework (for example `soc2`). - */ - @JsonIgnore - public String id() { - return id; } /** - * The human-readable framework name. + * Display name of the framework. */ @JsonIgnore public String displayName() { return displayName; } - /** - * The short framework name used in compact UI. - */ - @JsonIgnore - public String shortName() { - return shortName; - } - public static Builder builder() { return new Builder(); } /** - * The stable identifier of the framework (for example `soc2`). - */ - public AuditSegmentFramework withId(String id) { - Utils.checkNotNull(id, "id"); - this.id = id; - return this; - } - - /** - * The human-readable framework name. + * Display name of the framework. */ public AuditSegmentFramework withDisplayName(String displayName) { Utils.checkNotNull(displayName, "displayName"); @@ -94,15 +51,6 @@ public AuditSegmentFramework withDisplayName(String displayName) { return this; } - /** - * The short framework name used in compact UI. - */ - public AuditSegmentFramework withShortName(String shortName) { - Utils.checkNotNull(shortName, "shortName"); - this.shortName = shortName; - return this; - } - @Override public boolean equals(java.lang.Object o) { if (this == o) { @@ -113,51 +61,33 @@ public boolean equals(java.lang.Object o) { } AuditSegmentFramework other = (AuditSegmentFramework) o; return - Utils.enhancedDeepEquals(this.id, other.id) && - Utils.enhancedDeepEquals(this.displayName, other.displayName) && - Utils.enhancedDeepEquals(this.shortName, other.shortName); + Utils.enhancedDeepEquals(this.displayName, other.displayName); } @Override public int hashCode() { return Utils.enhancedHash( - id, displayName, shortName); + displayName); } @Override public String toString() { return Utils.toString(AuditSegmentFramework.class, - "id", id, - "displayName", displayName, - "shortName", shortName); + "displayName", displayName); } @SuppressWarnings("UnusedReturnValue") public final static class Builder { - private String id; - private String displayName; - private String shortName; - private Builder() { // force use of static builder() method } /** - * The stable identifier of the framework (for example `soc2`). - */ - public Builder id(String id) { - Utils.checkNotNull(id, "id"); - this.id = id; - return this; - } - - - /** - * The human-readable framework name. + * Display name of the framework. */ public Builder displayName(String displayName) { Utils.checkNotNull(displayName, "displayName"); @@ -165,20 +95,10 @@ public Builder displayName(String displayName) { return this; } - - /** - * The short framework name used in compact UI. - */ - public Builder shortName(String shortName) { - Utils.checkNotNull(shortName, "shortName"); - this.shortName = shortName; - return this; - } - public AuditSegmentFramework build() { return new AuditSegmentFramework( - id, displayName, shortName); + displayName); } } diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodes.java b/src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodes.java index 64292c4..c0edcc1 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodes.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodes.java @@ -7,6 +7,7 @@ import com.fasterxml.jackson.annotation.JsonIgnore; import com.fasterxml.jackson.annotation.JsonProperty; import com.vanta.vanta_auditor_api.utils.Utils; +import java.lang.Deprecated; import java.lang.Override; import java.lang.String; import java.util.List; @@ -18,43 +19,81 @@ */ public class FrameworkCodes { /** - * Array of valid framework codes for the audit's framework (e.g., "CC6.1", "CC6.2"). - * These represent the different framework sections available for creating information requests. + * Valid framework codes for this audit. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ @JsonProperty("frameworkCodes") + @Deprecated private List frameworkCodes; + /** + * Valid codes grouped by each distinct in-scope framework. A code that exists + * on two frameworks appears in both groups. Two segments that share a + * framework contribute one group. `framework` is the display name. + */ + @JsonProperty("codesByFramework") + private List codesByFramework; + @JsonCreator public FrameworkCodes( - @JsonProperty("frameworkCodes") List frameworkCodes) { + @JsonProperty("frameworkCodes") List frameworkCodes, + @JsonProperty("codesByFramework") List codesByFramework) { Utils.checkNotNull(frameworkCodes, "frameworkCodes"); + Utils.checkNotNull(codesByFramework, "codesByFramework"); this.frameworkCodes = frameworkCodes; + this.codesByFramework = codesByFramework; } /** - * Array of valid framework codes for the audit's framework (e.g., "CC6.1", "CC6.2"). - * These represent the different framework sections available for creating information requests. + * Valid framework codes for this audit. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ + @Deprecated @JsonIgnore public List frameworkCodes() { return frameworkCodes; } + /** + * Valid codes grouped by each distinct in-scope framework. A code that exists + * on two frameworks appears in both groups. Two segments that share a + * framework contribute one group. `framework` is the display name. + */ + @JsonIgnore + public List codesByFramework() { + return codesByFramework; + } + public static Builder builder() { return new Builder(); } /** - * Array of valid framework codes for the audit's framework (e.g., "CC6.1", "CC6.2"). - * These represent the different framework sections available for creating information requests. + * Valid framework codes for this audit. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ + @Deprecated public FrameworkCodes withFrameworkCodes(List frameworkCodes) { Utils.checkNotNull(frameworkCodes, "frameworkCodes"); this.frameworkCodes = frameworkCodes; return this; } + /** + * Valid codes grouped by each distinct in-scope framework. A code that exists + * on two frameworks appears in both groups. Two segments that share a + * framework contribute one group. `framework` is the display name. + */ + public FrameworkCodes withCodesByFramework(List codesByFramework) { + Utils.checkNotNull(codesByFramework, "codesByFramework"); + this.codesByFramework = codesByFramework; + return this; + } + @Override public boolean equals(java.lang.Object o) { if (this == o) { @@ -65,45 +104,64 @@ public boolean equals(java.lang.Object o) { } FrameworkCodes other = (FrameworkCodes) o; return - Utils.enhancedDeepEquals(this.frameworkCodes, other.frameworkCodes); + Utils.enhancedDeepEquals(this.frameworkCodes, other.frameworkCodes) && + Utils.enhancedDeepEquals(this.codesByFramework, other.codesByFramework); } @Override public int hashCode() { return Utils.enhancedHash( - frameworkCodes); + frameworkCodes, codesByFramework); } @Override public String toString() { return Utils.toString(FrameworkCodes.class, - "frameworkCodes", frameworkCodes); + "frameworkCodes", frameworkCodes, + "codesByFramework", codesByFramework); } @SuppressWarnings("UnusedReturnValue") public final static class Builder { + @Deprecated private List frameworkCodes; + private List codesByFramework; + private Builder() { // force use of static builder() method } /** - * Array of valid framework codes for the audit's framework (e.g., "CC6.1", "CC6.2"). - * These represent the different framework sections available for creating information requests. + * Valid framework codes for this audit. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ + @Deprecated public Builder frameworkCodes(List frameworkCodes) { Utils.checkNotNull(frameworkCodes, "frameworkCodes"); this.frameworkCodes = frameworkCodes; return this; } + + /** + * Valid codes grouped by each distinct in-scope framework. A code that exists + * on two frameworks appears in both groups. Two segments that share a + * framework contribute one group. `framework` is the display name. + */ + public Builder codesByFramework(List codesByFramework) { + Utils.checkNotNull(codesByFramework, "codesByFramework"); + this.codesByFramework = codesByFramework; + return this; + } + public FrameworkCodes build() { return new FrameworkCodes( - frameworkCodes); + frameworkCodes, codesByFramework); } } diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodesByFramework.java b/src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodesByFramework.java new file mode 100644 index 0000000..0973146 --- /dev/null +++ b/src/main/java/com/vanta/vanta_auditor_api/models/components/FrameworkCodesByFramework.java @@ -0,0 +1,142 @@ +/* + * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT. + */ +package com.vanta.vanta_auditor_api.models.components; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.vanta.vanta_auditor_api.utils.Utils; +import java.lang.Override; +import java.lang.String; +import java.util.List; + + +public class FrameworkCodesByFramework { + /** + * Display name of the in-scope framework these codes belong to. + */ + @JsonProperty("framework") + private String framework; + + /** + * Valid codes for this framework, sorted. + */ + @JsonProperty("codes") + private List codes; + + @JsonCreator + public FrameworkCodesByFramework( + @JsonProperty("framework") String framework, + @JsonProperty("codes") List codes) { + Utils.checkNotNull(framework, "framework"); + Utils.checkNotNull(codes, "codes"); + this.framework = framework; + this.codes = codes; + } + + /** + * Display name of the in-scope framework these codes belong to. + */ + @JsonIgnore + public String framework() { + return framework; + } + + /** + * Valid codes for this framework, sorted. + */ + @JsonIgnore + public List codes() { + return codes; + } + + public static Builder builder() { + return new Builder(); + } + + + /** + * Display name of the in-scope framework these codes belong to. + */ + public FrameworkCodesByFramework withFramework(String framework) { + Utils.checkNotNull(framework, "framework"); + this.framework = framework; + return this; + } + + /** + * Valid codes for this framework, sorted. + */ + public FrameworkCodesByFramework withCodes(List codes) { + Utils.checkNotNull(codes, "codes"); + this.codes = codes; + return this; + } + + @Override + public boolean equals(java.lang.Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + FrameworkCodesByFramework other = (FrameworkCodesByFramework) o; + return + Utils.enhancedDeepEquals(this.framework, other.framework) && + Utils.enhancedDeepEquals(this.codes, other.codes); + } + + @Override + public int hashCode() { + return Utils.enhancedHash( + framework, codes); + } + + @Override + public String toString() { + return Utils.toString(FrameworkCodesByFramework.class, + "framework", framework, + "codes", codes); + } + + @SuppressWarnings("UnusedReturnValue") + public final static class Builder { + + private String framework; + + private List codes; + + private Builder() { + // force use of static builder() method + } + + + /** + * Display name of the in-scope framework these codes belong to. + */ + public Builder framework(String framework) { + Utils.checkNotNull(framework, "framework"); + this.framework = framework; + return this; + } + + + /** + * Valid codes for this framework, sorted. + */ + public Builder codes(List codes) { + Utils.checkNotNull(codes, "codes"); + this.codes = codes; + return this; + } + + public FrameworkCodesByFramework build() { + + return new FrameworkCodesByFramework( + framework, codes); + } + + } +} diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/components/InformationRequest.java b/src/main/java/com/vanta/vanta_auditor_api/models/components/InformationRequest.java index 7fe7180..a6b2947 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/components/InformationRequest.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/components/InformationRequest.java @@ -9,6 +9,7 @@ import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import com.vanta.vanta_auditor_api.utils.Utils; +import java.lang.Deprecated; import java.lang.Override; import java.lang.String; import java.lang.SuppressWarnings; @@ -69,14 +70,29 @@ public class InformationRequest { private Optional cadence; /** - * The framework codes this request addresses. - * Links the request to specific compliance requirements. Can be an empty array - * if no framework codes are associated. These codes correspond to standards like SOC 2, ISO 27001, - * etc. + * Always empty on read. To find requests for a control, use + * `GET /audits/{auditId}/controls/{controlId}/information-requests`. + * For request assignment, use `segmentIds`. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ @JsonProperty("frameworkCodes") + @Deprecated private List frameworkCodes; + /** + * Audit segments this request is assigned to. Empty means unassigned. + * Resolved against the current audit scope — stale IDs are dropped. + * + *

This field is a current-scope projection, not a stored watermark. An + * audit-scope change that drops or adds IDs here does not update + * creationDate, modificationDate, or deletionDate, so it does not appear in + * `changedSinceDate` delta sync on its own. Re-fetch the list without that + * parameter, or GET the request by id, to see the current projection. + */ + @JsonProperty("segmentIds") + private List segmentIds; + /** * Detailed description explaining what evidence is needed and why. * Should provide clear instructions to help the customer understand what @@ -168,6 +184,7 @@ public InformationRequest( @JsonProperty("approvalStatus") InformationRequestApprovalStatus approvalStatus, @JsonProperty("cadence") Optional cadence, @JsonProperty("frameworkCodes") List frameworkCodes, + @JsonProperty("segmentIds") List segmentIds, @JsonProperty("description") Optional description, @JsonProperty("dueDate") Optional dueDate, @JsonProperty("evidenceCaptureDate") Optional evidenceCaptureDate, @@ -184,6 +201,7 @@ public InformationRequest( Utils.checkNotNull(approvalStatus, "approvalStatus"); Utils.checkNotNull(cadence, "cadence"); Utils.checkNotNull(frameworkCodes, "frameworkCodes"); + Utils.checkNotNull(segmentIds, "segmentIds"); Utils.checkNotNull(description, "description"); Utils.checkNotNull(dueDate, "dueDate"); Utils.checkNotNull(evidenceCaptureDate, "evidenceCaptureDate"); @@ -200,6 +218,7 @@ public InformationRequest( this.approvalStatus = approvalStatus; this.cadence = cadence; this.frameworkCodes = frameworkCodes; + this.segmentIds = segmentIds; this.description = description; this.dueDate = dueDate; this.evidenceCaptureDate = evidenceCaptureDate; @@ -218,16 +237,17 @@ public InformationRequest( List additionalControlIds, InformationRequestApprovalStatus approvalStatus, List frameworkCodes, + List segmentIds, InformationRequestType requestType, String title, OffsetDateTime creationDate, OffsetDateTime modificationDate) { this(id, uniqueId, additionalControlIds, approvalStatus, Optional.empty(), frameworkCodes, - Optional.empty(), Optional.empty(), Optional.empty(), - Optional.empty(), requestType, title, - creationDate, modificationDate, Optional.empty(), - Optional.empty()); + segmentIds, Optional.empty(), Optional.empty(), + Optional.empty(), Optional.empty(), requestType, + title, creationDate, modificationDate, + Optional.empty(), Optional.empty()); } /** @@ -283,16 +303,33 @@ public Optional cadence() { } /** - * The framework codes this request addresses. - * Links the request to specific compliance requirements. Can be an empty array - * if no framework codes are associated. These codes correspond to standards like SOC 2, ISO 27001, - * etc. + * Always empty on read. To find requests for a control, use + * `GET /audits/{auditId}/controls/{controlId}/information-requests`. + * For request assignment, use `segmentIds`. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ + @Deprecated @JsonIgnore public List frameworkCodes() { return frameworkCodes; } + /** + * Audit segments this request is assigned to. Empty means unassigned. + * Resolved against the current audit scope — stale IDs are dropped. + * + *

This field is a current-scope projection, not a stored watermark. An + * audit-scope change that drops or adds IDs here does not update + * creationDate, modificationDate, or deletionDate, so it does not appear in + * `changedSinceDate` delta sync on its own. Re-fetch the list without that + * parameter, or GET the request by id, to see the current projection. + */ + @JsonIgnore + public List segmentIds() { + return segmentIds; + } + /** * Detailed description explaining what evidence is needed and why. * Should provide clear instructions to help the customer understand what @@ -464,17 +501,35 @@ public InformationRequest withCadence(Optional cadence) { } /** - * The framework codes this request addresses. - * Links the request to specific compliance requirements. Can be an empty array - * if no framework codes are associated. These codes correspond to standards like SOC 2, ISO 27001, - * etc. + * Always empty on read. To find requests for a control, use + * `GET /audits/{auditId}/controls/{controlId}/information-requests`. + * For request assignment, use `segmentIds`. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ + @Deprecated public InformationRequest withFrameworkCodes(List frameworkCodes) { Utils.checkNotNull(frameworkCodes, "frameworkCodes"); this.frameworkCodes = frameworkCodes; return this; } + /** + * Audit segments this request is assigned to. Empty means unassigned. + * Resolved against the current audit scope — stale IDs are dropped. + * + *

This field is a current-scope projection, not a stored watermark. An + * audit-scope change that drops or adds IDs here does not update + * creationDate, modificationDate, or deletionDate, so it does not appear in + * `changedSinceDate` delta sync on its own. Re-fetch the list without that + * parameter, or GET the request by id, to see the current projection. + */ + public InformationRequest withSegmentIds(List segmentIds) { + Utils.checkNotNull(segmentIds, "segmentIds"); + this.segmentIds = segmentIds; + return this; + } + /** * Detailed description explaining what evidence is needed and why. * Should provide clear instructions to help the customer understand what @@ -669,6 +724,7 @@ public boolean equals(java.lang.Object o) { Utils.enhancedDeepEquals(this.approvalStatus, other.approvalStatus) && Utils.enhancedDeepEquals(this.cadence, other.cadence) && Utils.enhancedDeepEquals(this.frameworkCodes, other.frameworkCodes) && + Utils.enhancedDeepEquals(this.segmentIds, other.segmentIds) && Utils.enhancedDeepEquals(this.description, other.description) && Utils.enhancedDeepEquals(this.dueDate, other.dueDate) && Utils.enhancedDeepEquals(this.evidenceCaptureDate, other.evidenceCaptureDate) && @@ -686,10 +742,10 @@ public int hashCode() { return Utils.enhancedHash( id, uniqueId, additionalControlIds, approvalStatus, cadence, frameworkCodes, - description, dueDate, evidenceCaptureDate, - requestId, requestType, title, - creationDate, modificationDate, deletionDate, - ownerAssignment); + segmentIds, description, dueDate, + evidenceCaptureDate, requestId, requestType, + title, creationDate, modificationDate, + deletionDate, ownerAssignment); } @Override @@ -701,6 +757,7 @@ public String toString() { "approvalStatus", approvalStatus, "cadence", cadence, "frameworkCodes", frameworkCodes, + "segmentIds", segmentIds, "description", description, "dueDate", dueDate, "evidenceCaptureDate", evidenceCaptureDate, @@ -726,8 +783,11 @@ public final static class Builder { private Optional cadence = Optional.empty(); + @Deprecated private List frameworkCodes; + private List segmentIds; + private Optional description = Optional.empty(); private Optional dueDate = Optional.empty(); @@ -825,11 +885,13 @@ public Builder cadence(Optional cadence) { /** - * The framework codes this request addresses. - * Links the request to specific compliance requirements. Can be an empty array - * if no framework codes are associated. These codes correspond to standards like SOC 2, ISO 27001, - * etc. + * Always empty on read. To find requests for a control, use + * `GET /audits/{auditId}/controls/{controlId}/information-requests`. + * For request assignment, use `segmentIds`. + * + * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible. */ + @Deprecated public Builder frameworkCodes(List frameworkCodes) { Utils.checkNotNull(frameworkCodes, "frameworkCodes"); this.frameworkCodes = frameworkCodes; @@ -837,6 +899,23 @@ public Builder frameworkCodes(List frameworkCodes) { } + /** + * Audit segments this request is assigned to. Empty means unassigned. + * Resolved against the current audit scope — stale IDs are dropped. + * + *

This field is a current-scope projection, not a stored watermark. An + * audit-scope change that drops or adds IDs here does not update + * creationDate, modificationDate, or deletionDate, so it does not appear in + * `changedSinceDate` delta sync on its own. Re-fetch the list without that + * parameter, or GET the request by id, to see the current projection. + */ + public Builder segmentIds(List segmentIds) { + Utils.checkNotNull(segmentIds, "segmentIds"); + this.segmentIds = segmentIds; + return this; + } + + /** * Detailed description explaining what evidence is needed and why. * Should provide clear instructions to help the customer understand what @@ -1023,10 +1102,10 @@ public InformationRequest build() { return new InformationRequest( id, uniqueId, additionalControlIds, approvalStatus, cadence, frameworkCodes, - description, dueDate, evidenceCaptureDate, - requestId, requestType, title, - creationDate, modificationDate, deletionDate, - ownerAssignment); + segmentIds, description, dueDate, + evidenceCaptureDate, requestId, requestType, + title, creationDate, modificationDate, + deletionDate, ownerAssignment); } } diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequest.java b/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequest.java index f9d6e13..916b902 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequest.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequest.java @@ -12,7 +12,9 @@ import java.lang.Integer; import java.lang.Override; import java.lang.String; +import java.lang.SuppressWarnings; import java.time.OffsetDateTime; +import java.util.List; import java.util.Optional; @@ -36,30 +38,43 @@ public class ListInformationRequestsRequest { /** * Includes all information requests that have changed since changedSinceDate. * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * Does not include requests whose only change is the derived `segmentIds` + * projection after an audit-scope change. */ @SpeakeasyMetadata("queryParam:style=form,explode=true,name=changedSinceDate") private Optional changedSinceDate; + /** + * Return requests whose stored segment assignment includes any of these + * IDs (OR). Omit to return all. A match can still come back with + * `segmentIds: []` if the stored ID is no longer in the audit's scope. + */ + @SpeakeasyMetadata("queryParam:style=form,explode=true,name=segmentIdsMatchesAny") + private Optional> segmentIdsMatchesAny; + @JsonCreator public ListInformationRequestsRequest( String auditId, Optional pageSize, Optional pageCursor, - Optional changedSinceDate) { + Optional changedSinceDate, + Optional> segmentIdsMatchesAny) { Utils.checkNotNull(auditId, "auditId"); Utils.checkNotNull(pageSize, "pageSize"); Utils.checkNotNull(pageCursor, "pageCursor"); Utils.checkNotNull(changedSinceDate, "changedSinceDate"); + Utils.checkNotNull(segmentIdsMatchesAny, "segmentIdsMatchesAny"); this.auditId = auditId; this.pageSize = pageSize; this.pageCursor = pageCursor; this.changedSinceDate = changedSinceDate; + this.segmentIdsMatchesAny = segmentIdsMatchesAny; } public ListInformationRequestsRequest( String auditId) { this(auditId, Optional.empty(), Optional.empty(), - Optional.empty()); + Optional.empty(), Optional.empty()); } @JsonIgnore @@ -86,12 +101,25 @@ public Optional pageCursor() { /** * Includes all information requests that have changed since changedSinceDate. * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * Does not include requests whose only change is the derived `segmentIds` + * projection after an audit-scope change. */ @JsonIgnore public Optional changedSinceDate() { return changedSinceDate; } + /** + * Return requests whose stored segment assignment includes any of these + * IDs (OR). Omit to return all. A match can still come back with + * `segmentIds: []` if the stored ID is no longer in the audit's scope. + */ + @SuppressWarnings("unchecked") + @JsonIgnore + public Optional> segmentIdsMatchesAny() { + return (Optional>) segmentIdsMatchesAny; + } + public static Builder builder() { return new Builder(); } @@ -144,6 +172,8 @@ public ListInformationRequestsRequest withPageCursor(Optional pageCursor /** * Includes all information requests that have changed since changedSinceDate. * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * Does not include requests whose only change is the derived `segmentIds` + * projection after an audit-scope change. */ public ListInformationRequestsRequest withChangedSinceDate(OffsetDateTime changedSinceDate) { Utils.checkNotNull(changedSinceDate, "changedSinceDate"); @@ -155,6 +185,8 @@ public ListInformationRequestsRequest withChangedSinceDate(OffsetDateTime change /** * Includes all information requests that have changed since changedSinceDate. * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * Does not include requests whose only change is the derived `segmentIds` + * projection after an audit-scope change. */ public ListInformationRequestsRequest withChangedSinceDate(Optional changedSinceDate) { Utils.checkNotNull(changedSinceDate, "changedSinceDate"); @@ -162,6 +194,29 @@ public ListInformationRequestsRequest withChangedSinceDate(Optional segmentIdsMatchesAny) { + Utils.checkNotNull(segmentIdsMatchesAny, "segmentIdsMatchesAny"); + this.segmentIdsMatchesAny = Optional.ofNullable(segmentIdsMatchesAny); + return this; + } + + + /** + * Return requests whose stored segment assignment includes any of these + * IDs (OR). Omit to return all. A match can still come back with + * `segmentIds: []` if the stored ID is no longer in the audit's scope. + */ + public ListInformationRequestsRequest withSegmentIdsMatchesAny(Optional> segmentIdsMatchesAny) { + Utils.checkNotNull(segmentIdsMatchesAny, "segmentIdsMatchesAny"); + this.segmentIdsMatchesAny = segmentIdsMatchesAny; + return this; + } + @Override public boolean equals(java.lang.Object o) { if (this == o) { @@ -175,14 +230,15 @@ public boolean equals(java.lang.Object o) { Utils.enhancedDeepEquals(this.auditId, other.auditId) && Utils.enhancedDeepEquals(this.pageSize, other.pageSize) && Utils.enhancedDeepEquals(this.pageCursor, other.pageCursor) && - Utils.enhancedDeepEquals(this.changedSinceDate, other.changedSinceDate); + Utils.enhancedDeepEquals(this.changedSinceDate, other.changedSinceDate) && + Utils.enhancedDeepEquals(this.segmentIdsMatchesAny, other.segmentIdsMatchesAny); } @Override public int hashCode() { return Utils.enhancedHash( auditId, pageSize, pageCursor, - changedSinceDate); + changedSinceDate, segmentIdsMatchesAny); } @Override @@ -191,7 +247,8 @@ public String toString() { "auditId", auditId, "pageSize", pageSize, "pageCursor", pageCursor, - "changedSinceDate", changedSinceDate); + "changedSinceDate", changedSinceDate, + "segmentIdsMatchesAny", segmentIdsMatchesAny); } @SuppressWarnings("UnusedReturnValue") @@ -205,6 +262,8 @@ public final static class Builder { private Optional changedSinceDate = Optional.empty(); + private Optional> segmentIdsMatchesAny = Optional.empty(); + private Builder() { // force use of static builder() method } @@ -258,6 +317,8 @@ public Builder pageCursor(Optional pageCursor) { /** * Includes all information requests that have changed since changedSinceDate. * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * Does not include requests whose only change is the derived `segmentIds` + * projection after an audit-scope change. */ public Builder changedSinceDate(OffsetDateTime changedSinceDate) { Utils.checkNotNull(changedSinceDate, "changedSinceDate"); @@ -268,6 +329,8 @@ public Builder changedSinceDate(OffsetDateTime changedSinceDate) { /** * Includes all information requests that have changed since changedSinceDate. * Considers creationDate, modificationDate, and deletionDate timestamps when determining changes. + * Does not include requests whose only change is the derived `segmentIds` + * projection after an audit-scope change. */ public Builder changedSinceDate(Optional changedSinceDate) { Utils.checkNotNull(changedSinceDate, "changedSinceDate"); @@ -275,6 +338,29 @@ public Builder changedSinceDate(Optional changedSinceDate) { return this; } + + /** + * Return requests whose stored segment assignment includes any of these + * IDs (OR). Omit to return all. A match can still come back with + * `segmentIds: []` if the stored ID is no longer in the audit's scope. + */ + public Builder segmentIdsMatchesAny(List segmentIdsMatchesAny) { + Utils.checkNotNull(segmentIdsMatchesAny, "segmentIdsMatchesAny"); + this.segmentIdsMatchesAny = Optional.ofNullable(segmentIdsMatchesAny); + return this; + } + + /** + * Return requests whose stored segment assignment includes any of these + * IDs (OR). Omit to return all. A match can still come back with + * `segmentIds: []` if the stored ID is no longer in the audit's scope. + */ + public Builder segmentIdsMatchesAny(Optional> segmentIdsMatchesAny) { + Utils.checkNotNull(segmentIdsMatchesAny, "segmentIdsMatchesAny"); + this.segmentIdsMatchesAny = segmentIdsMatchesAny; + return this; + } + public ListInformationRequestsRequest build() { if (pageSize == null) { pageSize = _SINGLETON_VALUE_PageSize.value(); @@ -282,7 +368,7 @@ public ListInformationRequestsRequest build() { return new ListInformationRequestsRequest( auditId, pageSize, pageCursor, - changedSinceDate); + changedSinceDate, segmentIdsMatchesAny); } diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequestBuilder.java b/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequestBuilder.java index 235a967..ac6b19d 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequestBuilder.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/operations/ListInformationRequestsRequestBuilder.java @@ -5,26 +5,14 @@ import static com.vanta.vanta_auditor_api.operations.Operations.RequestOperation; -import com.fasterxml.jackson.core.type.TypeReference; import com.vanta.vanta_auditor_api.SDKConfiguration; import com.vanta.vanta_auditor_api.operations.ListInformationRequests; import com.vanta.vanta_auditor_api.utils.Headers; -import com.vanta.vanta_auditor_api.utils.LazySingletonValue; import com.vanta.vanta_auditor_api.utils.Utils; -import java.lang.Integer; -import java.lang.String; -import java.time.OffsetDateTime; -import java.util.Optional; public class ListInformationRequestsRequestBuilder { - private String auditId; - private Optional pageSize = Utils.readDefaultOrConstValue( - "pageSize", - "10", - new TypeReference>() {}); - private Optional pageCursor = Optional.empty(); - private Optional changedSinceDate = Optional.empty(); + private ListInformationRequestsRequest request; private final SDKConfiguration sdkConfiguration; private final Headers _headers = new Headers(); @@ -32,74 +20,17 @@ public ListInformationRequestsRequestBuilder(SDKConfiguration sdkConfiguration) this.sdkConfiguration = sdkConfiguration; } - public ListInformationRequestsRequestBuilder auditId(String auditId) { - Utils.checkNotNull(auditId, "auditId"); - this.auditId = auditId; - return this; - } - - public ListInformationRequestsRequestBuilder pageSize(int pageSize) { - Utils.checkNotNull(pageSize, "pageSize"); - this.pageSize = Optional.of(pageSize); + public ListInformationRequestsRequestBuilder request(ListInformationRequestsRequest request) { + Utils.checkNotNull(request, "request"); + this.request = request; return this; } - public ListInformationRequestsRequestBuilder pageSize(Optional pageSize) { - Utils.checkNotNull(pageSize, "pageSize"); - this.pageSize = pageSize; - return this; - } - - public ListInformationRequestsRequestBuilder pageCursor(String pageCursor) { - Utils.checkNotNull(pageCursor, "pageCursor"); - this.pageCursor = Optional.of(pageCursor); - return this; - } - - public ListInformationRequestsRequestBuilder pageCursor(Optional pageCursor) { - Utils.checkNotNull(pageCursor, "pageCursor"); - this.pageCursor = pageCursor; - return this; - } - - public ListInformationRequestsRequestBuilder changedSinceDate(OffsetDateTime changedSinceDate) { - Utils.checkNotNull(changedSinceDate, "changedSinceDate"); - this.changedSinceDate = Optional.of(changedSinceDate); - return this; - } - - public ListInformationRequestsRequestBuilder changedSinceDate(Optional changedSinceDate) { - Utils.checkNotNull(changedSinceDate, "changedSinceDate"); - this.changedSinceDate = changedSinceDate; - return this; - } - - - private ListInformationRequestsRequest buildRequest() { - if (pageSize == null) { - pageSize = _SINGLETON_VALUE_PageSize.value(); - } - - ListInformationRequestsRequest request = new ListInformationRequestsRequest(auditId, - pageSize, - pageCursor, - changedSinceDate); - - return request; - } - public ListInformationRequestsResponse call() { RequestOperation operation = new ListInformationRequests.Sync(sdkConfiguration, _headers); - ListInformationRequestsRequest request = buildRequest(); return operation.handleResponse(operation.doRequest(request)); } - - private static final LazySingletonValue> _SINGLETON_VALUE_PageSize = - new LazySingletonValue<>( - "pageSize", - "10", - new TypeReference>() {}); } diff --git a/src/main/java/com/vanta/vanta_auditor_api/models/operations/async/ListInformationRequestsRequestBuilder.java b/src/main/java/com/vanta/vanta_auditor_api/models/operations/async/ListInformationRequestsRequestBuilder.java index 3ddd2e3..d1d760c 100644 --- a/src/main/java/com/vanta/vanta_auditor_api/models/operations/async/ListInformationRequestsRequestBuilder.java +++ b/src/main/java/com/vanta/vanta_auditor_api/models/operations/async/ListInformationRequestsRequestBuilder.java @@ -5,28 +5,16 @@ import static com.vanta.vanta_auditor_api.operations.Operations.AsyncRequestOperation; -import com.fasterxml.jackson.core.type.TypeReference; import com.vanta.vanta_auditor_api.SDKConfiguration; import com.vanta.vanta_auditor_api.models.operations.ListInformationRequestsRequest; import com.vanta.vanta_auditor_api.operations.ListInformationRequests; import com.vanta.vanta_auditor_api.utils.Headers; -import com.vanta.vanta_auditor_api.utils.LazySingletonValue; import com.vanta.vanta_auditor_api.utils.Utils; -import java.lang.Integer; -import java.lang.String; -import java.time.OffsetDateTime; -import java.util.Optional; import java.util.concurrent.CompletableFuture; public class ListInformationRequestsRequestBuilder { - private String auditId; - private Optional pageSize = Utils.readDefaultOrConstValue( - "pageSize", - "10", - new TypeReference>() {}); - private Optional pageCursor = Optional.empty(); - private Optional changedSinceDate = Optional.empty(); + private ListInformationRequestsRequest request; private final SDKConfiguration sdkConfiguration; private final Headers _headers = new Headers(); @@ -34,75 +22,18 @@ public ListInformationRequestsRequestBuilder(SDKConfiguration sdkConfiguration) this.sdkConfiguration = sdkConfiguration; } - public ListInformationRequestsRequestBuilder auditId(String auditId) { - Utils.checkNotNull(auditId, "auditId"); - this.auditId = auditId; - return this; - } - - public ListInformationRequestsRequestBuilder pageSize(int pageSize) { - Utils.checkNotNull(pageSize, "pageSize"); - this.pageSize = Optional.of(pageSize); + public ListInformationRequestsRequestBuilder request(ListInformationRequestsRequest request) { + Utils.checkNotNull(request, "request"); + this.request = request; return this; } - public ListInformationRequestsRequestBuilder pageSize(Optional pageSize) { - Utils.checkNotNull(pageSize, "pageSize"); - this.pageSize = pageSize; - return this; - } - - public ListInformationRequestsRequestBuilder pageCursor(String pageCursor) { - Utils.checkNotNull(pageCursor, "pageCursor"); - this.pageCursor = Optional.of(pageCursor); - return this; - } - - public ListInformationRequestsRequestBuilder pageCursor(Optional pageCursor) { - Utils.checkNotNull(pageCursor, "pageCursor"); - this.pageCursor = pageCursor; - return this; - } - - public ListInformationRequestsRequestBuilder changedSinceDate(OffsetDateTime changedSinceDate) { - Utils.checkNotNull(changedSinceDate, "changedSinceDate"); - this.changedSinceDate = Optional.of(changedSinceDate); - return this; - } - - public ListInformationRequestsRequestBuilder changedSinceDate(Optional changedSinceDate) { - Utils.checkNotNull(changedSinceDate, "changedSinceDate"); - this.changedSinceDate = changedSinceDate; - return this; - } - - - private ListInformationRequestsRequest buildRequest() { - if (pageSize == null) { - pageSize = _SINGLETON_VALUE_PageSize.value(); - } - - ListInformationRequestsRequest request = new ListInformationRequestsRequest(auditId, - pageSize, - pageCursor, - changedSinceDate); - - return request; - } - public CompletableFuture call() { AsyncRequestOperation operation = new ListInformationRequests.Async(sdkConfiguration, _headers); - ListInformationRequestsRequest request = buildRequest(); return operation.doRequest(request) .thenCompose(operation::handleResponse); } - - private static final LazySingletonValue> _SINGLETON_VALUE_PageSize = - new LazySingletonValue<>( - "pageSize", - "10", - new TypeReference>() {}); } From f39d0f9b62f6b71c481505a9ad12dd3ec121654b Mon Sep 17 00:00:00 2001 From: "speakeasy-github[bot]" <128539517+speakeasy-github[bot]@users.noreply.github.com> Date: Fri, 4 Sep 2026 00:04:20 +0000 Subject: [PATCH 2/2] empty commit to trigger [run-tests] workflow