Skip to main content
POST
Workspace: File Share
Publish a file from the per-agent workspace to a public CDN URL that can be shared externally (for example, to return a download link from an agent response).

Path Parameters

string
required
Agent ID (UUID)

Request Body

string
required
Path to the file in the workspace to publish.

Response

string
Result status (e.g., ok).
string
Public CDN URL for the shared file.
string
Original workspace file path.

Example Request

Notes

  • Shared URLs are unauthenticated — treat them as public links. Do not share files containing secrets.
  • The returned URL is served from the xpander CDN and is safe to include in agent responses or webhooks.

See Also

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required

Body

application/json
path
string
required

Relative path to the file in the workspace to share publicly.

Example:

"output/report.csv"

Response

Successful Response

url
string
required

Public CDN URL for the shared file