Docs · GET /directory/{dirId}
Reference · Directories

GET/directory/{dirId}

Lists the files in one directory: the inputs you registered and the outputs jobs have written.

Parameters

Parameters
dirIdstringThe 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

Response fields
okbooleantrue when the directory exists.
files[]arrayOne entry per file. Empty when there are none.
files[].file_namestringThe file’s name.
files[].added_onstringWhen it was registered or written, in UTC.

Status codes

Status codes
200The list. Not charged.
401The Authorization header is missing, or the key is invalid, revoked or expired.
403The account isn’t active. The error says what to do.
404Directory not found: it isn’t in your account, or it has expired.
429More than 300 requests in a minute on this key. Wait for the number of seconds in Retry-After.

Every error has the shape {"ok": false, "error": "…"} and is never charged.