List Files

List all files with pagination support and optional filtering by file type and category

GET /files/list

Try it

List Files

cURL

curl --request GET \
  --url https://api.duohub.ai/files/list \
  --header 'X-API-Key: <api-key>'

200

{
  "files": [
    {
      "id": "<string>",
      "name": "<string>",
      "extension": "<string>",
      "fileType": "<string>",
      "category": "<string>",
      "bronzeKey": "<string>",
      "userID": "<string>",
      "length": 123,
      "size": 123,
      "tokens": 123,
      "numSpeakers": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextToken": "<string>",
  "previousToken": "<string>",
  "count": 123
}

Authorizations

X-API-Key · string · header · required

Your duohub API key. Type: str

Query Parameters

category · enum<string>

Filter files by category Category of the file

Available options: audio, video, web, document, other, all

limit · integer · default: 10

Maximum number of files to return

Required range: 1 <= x <= 100

nextToken · string

Token for getting the next page of results

previousToken · string

Token for getting the previous page of results

Response

200

application/json

Files retrieved successfully

files · object[]

Show child attributes

files. id · string

File unique identifier

files. name · string

Name of the file

files. extension · string

File extension

files. fileType · string

Type of the file

files. category · string

File category

files. bronzeKey · string

Bronze storage key

files. userID · string

User ID

files. length · number

Length of the file

files. size · number

Size of the file

files. tokens · integer

Number of tokens

files. numSpeakers · integer

Number of speakers

files. createdAt · string<date-time>

Creation timestamp

files. updatedAt · string<date-time>

Last update timestamp

nextToken · string

Token for the next page of results

previousToken · string

Token for the previous page of results

count · integer

Number of files in the current page