Skip to main content
POST
Create or get public share

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, a self-hosted sandbox UUID from the sandbox list, or an unambiguous display name / hostname. UUID values are always interpreted as IDs, never names. Prefer IDs because names can change. When omitted, the Neo-managed cloud sandbox is used. An unavailable or ambiguous selection returns an error and never selects another host.

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