Skip to main content
POST
Create a folder

Authorizations

X-Public-Key
string
header
required

Public half of the company API key. Format: pk_ followed by 64 hexadecimal characters.

X-Secret-Key
string
header
required

Secret half of the company API key. Format: sk_ followed by 64 hexadecimal characters. Stored as a hash server-side and shown only at creation or rotation.

Path Parameters

bucketId
string<uuid>
required

Bucket identifier. Read it from the bucket list, or copy it from the Everabyte dashboard.

Body

application/json
name
string
required
Required string length: 1 - 255
parentId
string<uuid> | null

Parent folder. Omit or send null to create at the bucket root.

Response

Created folder.

status
integer
required
Example:

200

message
string
required
Example:

"Folder created"

data
object
required

Folder record. Additional fields may be present; undocumented fields are not a stable contract.