Skip to main content
GET
Get who a task is shared with
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

X-API-Key
string
header
required

API key for authentication. Get yours at platform.valyu.ai.

Path Parameters

id
string
required

DeepResearch task ID.

Response

Sharing for the task.

Who a DeepResearch report is shared with.

deepresearch_id
string
required

ID of the task.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

public
boolean
required

Whether anyone with the link can open the report. Set with Toggle public access. Independent of shared_with.

Example:

false

share_url
string<uri>
required

Link to the report.

Example:

"https://platform.valyu.ai/share/a1b2c3d4-e5f6-7890-abcd-ef1234567890"

shared_with
object[]
required

People and domains the report is shared with.