Storage
Idempotently create missing folders along a Storage root-relative path.
Idempotently create missing folders along a Storage root-relative path. The request enforces Storage access, workspace ownership, and entry lifecycle state.
POST
/
api
/
v1
/
storage
/
folders
/
ensure
Idempotently create missing folders along a Storage root-relative path.
curl --request POST \
--url https://api.revoengine.com/api/v1/storage/folders/ensure \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "exports/daily"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({path: 'exports/daily'})
};
fetch('https://api.revoengine.com/api/v1/storage/folders/ensure', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/storage/folders/ensure"
payload = { "path": "exports/daily" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Authorizations
Bearer JWT token or API Key (sk-*).
Body
application/json
Folder path relative to the Storage root. Leading and trailing slashes are optional.
Maximum string length:
1024Example:
"exports/daily"
Optional configured storage id used only when the first path segment must be created at root. Omit for managed default storage.
Whether every newly created path segment should be restricted.
Explicit allowed group ids applied to every newly created path segment.
Explicit allowed user ids applied to every newly created path segment.
Response
200
Folder path resolved or created.
⌘I
Idempotently create missing folders along a Storage root-relative path.
curl --request POST \
--url https://api.revoengine.com/api/v1/storage/folders/ensure \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "exports/daily"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({path: 'exports/daily'})
};
fetch('https://api.revoengine.com/api/v1/storage/folders/ensure', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/storage/folders/ensure"
payload = { "path": "exports/daily" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)