POST
Creates a directory. A directory holds a task’s inputs and outputs, and is deleted with everything in it when its ttl runs out. You don’t have to create one: POST /file without a dir_id makes one for you.
Request body
| ttl | number | How long the directory lives, in seconds. 86400 (24 hours) when left out; a longer value than 604800 (7 days) is brought down to that. |
|---|
Example
Request
curl https://media.logicboostkit.com/directory \
-H "Authorization: Basic $MEDIA_KEY" \
-H "Content-Type: application/json" \
-d '{ "ttl": 3600 }'Response
HTTP/1.1 200 OK
X-Request-Id: job_0mv6img4ztlm392wz8t7f205
{
"ok": true,
"directory": {
"id": "dir_m8papv92jrn8rx6186g8",
"ttl": 3600
}
}Response fields
| ok | boolean | true when the directory was created. |
|---|---|---|
| directory.id | string | The directory’s id: dir_ and 20 lower-case letters and digits. |
| directory.ttl | number | Its lifetime in seconds, as applied. |
Status codes
| 200 | The directory exists. Not charged. |
|---|---|
| 400 | The body isn’t a JSON object, or ttl isn’t a positive number. |
| 401 | The Authorization header is missing, or the key is invalid, revoked or expired. |
| 403 | The account isn’t active. The error says what to do. |
| 429 | More than 300 requests in a minute on this key. Wait for the number of seconds in Retry-After. |