Skip to main content
POST
/
api
/
v1
/
files
/
share
Create or get public share
curl --request POST \
  --url https://neo.api.projectdiscovery.io/api/v1/files/share \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_key": "<string>"
}
'
{
  "created": true,
  "file_key": "<string>",
  "token": "<string>",
  "url": "<string>"
}

Authorizations

​
Authorization
string
header
required

JWT authentication token

Query Parameters

​
project_id
string<uuid>

Optional project ID for project-scoped sandbox files

​
sandbox
string

Route file operations to a specific sandbox (cloud or a self-hosted display name / hostname). When omitted, the user's pinned default is used.

Body

application/json
​
file_key
string
required

Full path to the file in the sandbox (e.g., workspace/reports/scan.html)

Response

Existing share returned

​
created
boolean

Whether a new share was created (true) or an existing one returned (false)

​
file_key
string

File path that was shared

​
token
string

Public share token

​
url
string

Full public URL for the shared file