Skip to main content
POST
/
v2
/
environments
/
{environmentId}
/
folders
Create Folder
curl --request POST \
  --url https://api.tusky.io/v2/environments/{environmentId}/folders \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parentId": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "environmentId": "<string>",
  "parentId": "<string>",
  "createdAt": "<string>"
}
Create a new folder inside an environment to organize files.

​
Path Parameters

​
environmentId
string
required
The environment to create the folder in.

​
Request Body

​
name
string
required
Folder name.
​
parentId
string
Parent folder ID for nesting. Omit to create at the environment root.

​
Response

​
id
string
Unique folder identifier.
​
name
string
Folder name.
​
environmentId
string
The environment this folder belongs to.
​
parentId
string
Parent folder ID, or null if at environment root.
​
createdAt
string
ISO 8601 creation timestamp.

​
Example

curl -X POST https://api.tusky.io/v2/environments/env_abc123/folders \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Photos", "parentId": null}'

​
Response

{
  "id": "folder_xyz789",
  "name": "Photos",
  "environmentId": "env_abc123",
  "parentId": null,
  "createdAt": "2026-03-06T12:00:00Z"
}