Skip to main content
POST
Create a directory

Authorizations

Authorization
string
header
required

A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

Path Parameters

id
string
required

Stable public computer identifier.

Minimum string length: 1
Example:

"cmp_123"

Body

application/json
path
string
required
Minimum string length: 1
recursive
boolean
default:false
mode
string
Pattern: ^[0-7]{3,4}$
uid
integer
Required range: x >= 0
gid
integer
Required range: x >= 0

Response

File metadata.

name
string
required
type
enum<string>
required
Available options:
file,
directory,
symlink
size
integer<int64>
required
Required range: x >= 0
mtime
string<date-time>
required
mode
string
required
uid
integer
required
Required range: x >= 0
gid
integer
required
Required range: x >= 0