Audits
Delete an auditor file from an information request
Deletes an auditor file from an information request. Any auditor assigned
to the audit may delete any auditor’s file, not only their own. Identify
the deleting auditor by email: they must be an active user in your audit
firm and assigned to the audit, otherwise this returns 403.
A completed audit returns 409; reopen the audit before deleting files. Approving the request does not lock its files. An unknown or already deleted file returns 404.
Lists no longer return the file or new download URLs for it. Download URLs issued before the delete stay valid until they expire, at most one hour.
Rate limit: 50 requests / minute.
DELETE
/
audits
/
{auditId}
/
information-requests
/
{requestId}
/
auditor-files
/
{auditorFileId}
TypeScript
import { Vanta } from "vanta-auditor-api-sdk";
const vanta = new Vanta({
bearerAuth: process.env["VANTA_BEARER_AUTH"] ?? "",
});
async function run() {
await vanta.audits.deleteInformationRequestAuditorFile({
auditId: "<id>",
requestId: "<id>",
auditorFileId: "<id>",
deleteInformationRequestAuditorFileInput: {
email: "Pansy_Gibson85@yahoo.com",
},
});
}
run();package hello.world;
import com.vanta.vanta_auditor_api.Vanta;
import com.vanta.vanta_auditor_api.models.components.DeleteInformationRequestAuditorFileInput;
import com.vanta.vanta_auditor_api.models.operations.DeleteInformationRequestAuditorFileResponse;
import java.lang.Exception;
public class Application {
public static void main(String[] args) throws Exception {
Vanta sdk = Vanta.builder()
.bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
.build();
DeleteInformationRequestAuditorFileResponse res = sdk.audits().deleteInformationRequestAuditorFile()
.auditId("<id>")
.requestId("<id>")
.auditorFileId("<id>")
.deleteInformationRequestAuditorFileInput(DeleteInformationRequestAuditorFileInput.builder()
.email("Pansy_Gibson85@yahoo.com")
.build())
.call();
// handle response
}
}curl --request DELETE \
--url https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "<string>"
}
'import requests
url = "https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}"
payload = { "email": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({email: '<string>'})
};
fetch('https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'email' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}"
payload := strings.NewReader("{\n \"email\": \"<string>\"\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Body
application/json
Response
204
No content
Was this page helpful?
⌘I
TypeScript
import { Vanta } from "vanta-auditor-api-sdk";
const vanta = new Vanta({
bearerAuth: process.env["VANTA_BEARER_AUTH"] ?? "",
});
async function run() {
await vanta.audits.deleteInformationRequestAuditorFile({
auditId: "<id>",
requestId: "<id>",
auditorFileId: "<id>",
deleteInformationRequestAuditorFileInput: {
email: "Pansy_Gibson85@yahoo.com",
},
});
}
run();package hello.world;
import com.vanta.vanta_auditor_api.Vanta;
import com.vanta.vanta_auditor_api.models.components.DeleteInformationRequestAuditorFileInput;
import com.vanta.vanta_auditor_api.models.operations.DeleteInformationRequestAuditorFileResponse;
import java.lang.Exception;
public class Application {
public static void main(String[] args) throws Exception {
Vanta sdk = Vanta.builder()
.bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
.build();
DeleteInformationRequestAuditorFileResponse res = sdk.audits().deleteInformationRequestAuditorFile()
.auditId("<id>")
.requestId("<id>")
.auditorFileId("<id>")
.deleteInformationRequestAuditorFileInput(DeleteInformationRequestAuditorFileInput.builder()
.email("Pansy_Gibson85@yahoo.com")
.build())
.call();
// handle response
}
}curl --request DELETE \
--url https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "<string>"
}
'import requests
url = "https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}"
payload = { "email": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({email: '<string>'})
};
fetch('https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'email' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}"
payload := strings.NewReader("{\n \"email\": \"<string>\"\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://api.vanta.com/v1/audits/{auditId}/information-requests/{requestId}/auditor-files/{auditorFileId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body