Skip to main content
GET
List directory contents

Authorizations

Authorization
string
header
required

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

Path Parameters

namespace
string
required

Namespace of the repository

repo_name
string
required

Name of the repository

resource
string
required

Path to the directory (including branch/commit ID)

page
integer | null
required
Required range: x >= 0
page_size
integer | null
required
Required range: x >= 0
api_version
string | null
required
depth
integer | null
required

Depth of nested directory traversal. 0 = current directory only (default), 1 = include immediate children, -1 = unlimited.

sort_by
string | null
required

Sort entries by "name" (default) or "date" (latest commit timestamp).

reverse
boolean | null
required

Reverse the sort order. Default is false (ascending).

Response

Paginated list of directory entries

status
string
required
status_message
string
required
entries
object[]
required

deny_unknown_fields is the discriminator for the untagged EMetadataEntry enum: payloads with a changes field (i.e. WorkspaceMetadataEntry) fail to deserialize here and fall through to the workspace variant.

page_number
integer
required
Required range: x >= 0
page_size
integer
required
Required range: x >= 0
total_entries
integer
required
Required range: x >= 0
total_pages
integer
required
Required range: x >= 0
oxen_version
string | null
dir
object

deny_unknown_fields is the discriminator for the untagged EMetadataEntry enum: payloads with a changes field (i.e. WorkspaceMetadataEntry) fail to deserialize here and fall through to the workspace variant.

metadata
null | object
resource
null | object