Skip to main content
POST
List files

Authorizations

Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

akua-context
string

Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens - a workspace-owned token implies its workspace.

Required string length: 1 - 53
Example:

"ws_j572abc123def456"

Path Parameters

id
string
required

Sandbox id (sbx_...).

Pattern: ^sbx_[A-Za-z0-9]{1,64}$
Example:

"sbx_j572abc123def456"

Body

application/json
path
string
required

Absolute path inside the sandbox.

Required string length: 1 - 4096
Pattern: ^\/[^\0]*$
Example:

"/workspace/README.md"

recursive
boolean
default:false
limit
integer
default:200
Required range: 1 <= x <= 1000
cursor
string
Maximum string length: 4096

Response

SandboxFileList

data
object[]
required
has_more
boolean
required

True if more items exist after this page.

next_cursor
string | null
required

Opaque cursor for the next page, or null if no more pages.