List files by tag across users
curl --request POST \
--url https://databunkerpro.myorg.com/v2/BulkListFilesByTag \
--header 'Content-Type: application/json' \
--header 'X-Bunker-Token: <api-key>' \
--data '
{
"unlockuuid": "<string>",
"tag": "<string>",
"offset": 0,
"limit": 10,
"request_metadata": {}
}
'import requests
url = "https://databunkerpro.myorg.com/v2/BulkListFilesByTag"
payload = {
"unlockuuid": "<string>",
"tag": "<string>",
"offset": 0,
"limit": 10,
"request_metadata": {}
}
headers = {
"X-Bunker-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Bunker-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
unlockuuid: '<string>',
tag: '<string>',
offset: 0,
limit: 10,
request_metadata: {}
})
};
fetch('https://databunkerpro.myorg.com/v2/BulkListFilesByTag', 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://databunkerpro.myorg.com/v2/BulkListFilesByTag",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'unlockuuid' => '<string>',
'tag' => '<string>',
'offset' => 0,
'limit' => 10,
'request_metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Bunker-Token: <api-key>"
],
]);
$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://databunkerpro.myorg.com/v2/BulkListFilesByTag"
payload := strings.NewReader("{\n \"unlockuuid\": \"<string>\",\n \"tag\": \"<string>\",\n \"offset\": 0,\n \"limit\": 10,\n \"request_metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Bunker-Token", "<api-key>")
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))
}HttpResponse<String> response = Unirest.post("https://databunkerpro.myorg.com/v2/BulkListFilesByTag")
.header("X-Bunker-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"unlockuuid\": \"<string>\",\n \"tag\": \"<string>\",\n \"offset\": 0,\n \"limit\": 10,\n \"request_metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://databunkerpro.myorg.com/v2/BulkListFilesByTag")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Bunker-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"unlockuuid\": \"<string>\",\n \"tag\": \"<string>\",\n \"offset\": 0,\n \"limit\": 10,\n \"request_metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"status": "ok",
"tag": "<string>",
"files": [
{
"fileuuid": "<string>",
"token": "<string>",
"mimetype": "<string>",
"size": 123,
"creationtime": 123
}
]
}{
"status": "error",
"message": "Missing API request parameters: profile"
}{
"status": "error",
"message": "Access denied"
}{
"status": "error",
"message": "Internal error"
}Bulk Operations
List files by tag across users
Lists file metadata for every file carrying the given tag, across all users in the tenant.
Requires an unlockuuid from BulkListUnlock. Results are limited to the tags the caller’s
policy permits. File content is not returned.
POST
/
v2
/
BulkListFilesByTag
List files by tag across users
curl --request POST \
--url https://databunkerpro.myorg.com/v2/BulkListFilesByTag \
--header 'Content-Type: application/json' \
--header 'X-Bunker-Token: <api-key>' \
--data '
{
"unlockuuid": "<string>",
"tag": "<string>",
"offset": 0,
"limit": 10,
"request_metadata": {}
}
'import requests
url = "https://databunkerpro.myorg.com/v2/BulkListFilesByTag"
payload = {
"unlockuuid": "<string>",
"tag": "<string>",
"offset": 0,
"limit": 10,
"request_metadata": {}
}
headers = {
"X-Bunker-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Bunker-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
unlockuuid: '<string>',
tag: '<string>',
offset: 0,
limit: 10,
request_metadata: {}
})
};
fetch('https://databunkerpro.myorg.com/v2/BulkListFilesByTag', 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://databunkerpro.myorg.com/v2/BulkListFilesByTag",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'unlockuuid' => '<string>',
'tag' => '<string>',
'offset' => 0,
'limit' => 10,
'request_metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Bunker-Token: <api-key>"
],
]);
$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://databunkerpro.myorg.com/v2/BulkListFilesByTag"
payload := strings.NewReader("{\n \"unlockuuid\": \"<string>\",\n \"tag\": \"<string>\",\n \"offset\": 0,\n \"limit\": 10,\n \"request_metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Bunker-Token", "<api-key>")
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))
}HttpResponse<String> response = Unirest.post("https://databunkerpro.myorg.com/v2/BulkListFilesByTag")
.header("X-Bunker-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"unlockuuid\": \"<string>\",\n \"tag\": \"<string>\",\n \"offset\": 0,\n \"limit\": 10,\n \"request_metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://databunkerpro.myorg.com/v2/BulkListFilesByTag")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Bunker-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"unlockuuid\": \"<string>\",\n \"tag\": \"<string>\",\n \"offset\": 0,\n \"limit\": 10,\n \"request_metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"status": "ok",
"tag": "<string>",
"files": [
{
"fileuuid": "<string>",
"token": "<string>",
"mimetype": "<string>",
"size": 123,
"creationtime": 123
}
]
}{
"status": "error",
"message": "Missing API request parameters: profile"
}{
"status": "error",
"message": "Access denied"
}{
"status": "error",
"message": "Internal error"
}Authorizations
API token for authentication
Body
application/json
⌘I