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/mkdirBody
pathstringrequiredRequest
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
idstringrequirednamestringrequiredpathstringrequired400Bad Request – validation error or malformed input
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
401Unauthorized – missing or expired token
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
403Forbidden – insufficient permissions
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
429Too Many Requests – rate limited
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
500Internal Server Error
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.