Get who a task is shared with
curl --request GET \
--url https://api.valyu.ai/v1/deepresearch/tasks/{id}/share \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.valyu.ai/v1/deepresearch/tasks/{id}/share"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.valyu.ai/v1/deepresearch/tasks/{id}/share', 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.valyu.ai/v1/deepresearch/tasks/{id}/share",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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"
"net/http"
"io"
)
func main() {
url := "https://api.valyu.ai/v1/deepresearch/tasks/{id}/share"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.valyu.ai/v1/deepresearch/tasks/{id}/share")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.valyu.ai/v1/deepresearch/tasks/{id}/share")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"public": false,
"share_url": "https://platform.valyu.ai/share/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"shared_with": [
{
"email": "anna@client.com",
"added_at": "2026-11-12T10:30:00.000Z",
"notified_at": "2026-11-12T10:30:01.000Z",
"last_viewed_at": "2026-11-12T14:05:00.000Z"
},
{
"domain": "acme.com",
"added_at": "2026-11-12T10:30:00.000Z"
}
]
}Get Sharing
Reference for listing who a DeepResearch report is shared with via GET /v1/deepresearch/tasks/{id}/share.
GET
/
v1
/
deepresearch
/
tasks
/
{id}
/
share
Get who a task is shared with
curl --request GET \
--url https://api.valyu.ai/v1/deepresearch/tasks/{id}/share \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.valyu.ai/v1/deepresearch/tasks/{id}/share"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.valyu.ai/v1/deepresearch/tasks/{id}/share', 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.valyu.ai/v1/deepresearch/tasks/{id}/share",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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"
"net/http"
"io"
)
func main() {
url := "https://api.valyu.ai/v1/deepresearch/tasks/{id}/share"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.valyu.ai/v1/deepresearch/tasks/{id}/share")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.valyu.ai/v1/deepresearch/tasks/{id}/share")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"public": false,
"share_url": "https://platform.valyu.ai/share/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"shared_with": [
{
"email": "anna@client.com",
"added_at": "2026-11-12T10:30:00.000Z",
"notified_at": "2026-11-12T10:30:01.000Z",
"last_viewed_at": "2026-11-12T14:05:00.000Z"
},
{
"domain": "acme.com",
"added_at": "2026-11-12T10:30:00.000Z"
}
]
}List the people and company domains a report is shared with, its share link and whether it is public. Each entry shows when it was added, and for people, when they were emailed and when they last opened the report.
Only the API key that created the task can read its sharing. Any other key gets
403 with code set to task.not_owner. See share a report with specific people.Authorizations
API key for authentication. Get yours at platform.valyu.ai.
Path Parameters
DeepResearch task ID.
Response
Sharing for the task.
Who a DeepResearch report is shared with.
ID of the task.
Example:
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Whether anyone with the link can open the report. Set with Toggle public access. Independent of shared_with.
Example:
false
Link to the report.
Example:
"https://platform.valyu.ai/share/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
People and domains the report is shared with.
Show child attributes
Show child attributes
Was this page helpful?