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

The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.

Minimum string length: 1
Example:

"agent-atlas"

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