Skip to main content
GET
/
{namespace}
/
{repo_name}
/
workspaces
/
{workspace_id}
/
files
/
{path}
Get workspace file
curl --request GET \
  --url https://hub.oxen.ai/{namespace}/{repo_name}/workspaces/{workspace_id}/files/{path} \
  --header 'Authorization: Bearer <token>'
[
  1
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
namespace
string
required

The namespace of the repository

​
repo_name
string
required

The name of the repository

​
workspace_id
string
required

The UUID of the workspace

​
path
string
required

The path to the file in the workspace

Query Parameters

​
width
integer<int32>

Width for image resize or video thumbnail

Required range: x >= 0
​
height
integer<int32>

Height for image resize or video thumbnail

Required range: x >= 0
​
timestamp
number<double>

Timestamp in seconds to extract video thumbnail from

​
thumbnail
boolean

Set to true to generate a video thumbnail instead of returning the full video

Response

File content returned as a stream. Content-Type varies: matches the file's MIME type for regular files and image resizes, or 'image/jpeg' for video thumbnails

Required range: x >= 0