GET /directory /{dirId}
Lists the files in one directory: the inputs you registered and the outputs jobs have written.
Parameters
| dirId | string | The directory’s id. |
|---|
Request body
This request has no body.
Example
Request
curl https://media.logicboostkit.com/directory/dir_pi23jgy1yxlmigi873bz \
-H "Authorization: Basic $MEDIA_KEY"Response
HTTP/1.1 200 OK
X-Request-Id: job_0mv6iv6v5rmhf80bjaztl3yl
{
"ok": true,
"files": [
{
"file_name": "source.mp4",
"added_on": "2026-10-13T09:41:07.214Z"
},
{
"file_name": "thumb.jpg",
"added_on": "2026-10-13T09:43:21.870Z"
}
]
}Response fields
| ok | boolean | true when the directory exists. |
|---|---|---|
| files[] | array | One entry per file. Empty when there are none. |
| files[].file_name | string | The file’s name. |
| files[].added_on | string | When it was registered or written, in UTC. |
Status codes
| 200 | The list. Not charged. |
|---|---|
| 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. |
| 404 | Directory not found: it isn’t in your account, or it has expired. |
| 429 | More than 300 requests in a minute on this key. Wait for the number of seconds in Retry-After. |