Create a folder

Create a folder

Creates a storage folder at the given path, including missing parent folders (mkdir -p). Returns the leaf folder; an existing folder is returned as-is.

POST/api/files/mkdir
Body
pathstringrequired

Request

curl
curl -X POST https://trickest.io/api/files/mkdir \
  -H "Authorization: Token $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

201Created (or existing) folder
idstringrequired
namestringrequired
pathstringrequired
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.