Skip to content

Create a directory

POST
/v1/sandbox/{sandboxID}/filesystem/mkdir

Create a directory at the given path. Optionally create parent directories recursively.

sandboxID
required
string

Unique sandbox identifier.

object
path
required

Directory path to create.

string
recursive

Create parent directories as needed.

boolean
permissions

Octal permission string (e.g. 755). Defaults to 755.

string
default: 755 nullable

Directory created.

Bad request – validation error.

object
message
required

Summary message, e.g. “Invalid request”.

string
errors
required
Array<object>
object
field
required

JSON field name that failed validation (e.g. “path”, “command”).

string
error
required

Human-readable description of the validation failure.

string

Unauthorized – invalid or missing API key.

object
message
required

Human-readable error message.

string