Listar arquivos

Authorization

bearerAuth

AuthorizationBearer <token>

Cole seu token da API VTurb (vt_...). Enviado como Authorization: Bearer <token>.

In: header

Query Parameters

cursor?string

Cursor opaco vindo do header Link da página anterior; omita na primeira página.

folder_id?string

Retorna só arquivos desta pasta.

per_page?integer

Tamanho da página, 1–100 (padrão 25).

q?string

Busca no nome do arquivo sem diferenciar maiúsculas e minúsculas.

Response Body

`application/json`

`application/problem+json`

curl -X GET "https://example.com/v1/files?cursor=0190a0b0-0000-7000-8000-000000000001&folder_id=fold_1&per_page=20&q=hero"

{  "files": [    {      "id": "0190a0b0-0000-7000-8000-000000000001",      "name": "hero.jpg",      "filename": "hero.jpg",      "status": "active",      "content_type": "image/jpeg",      "size": 184856,      "folder_id": null,      "url": "https://static.vturb.com/org_123/2026/08/12/0190a0b0-0000-7000-8000-000000000001/original.jpg",      "metadata": {        "width": 640,        "height": 360      },      "created_at": "2026-08-12T00:00:00.000Z",      "updated_at": "2026-08-12T00:00:00.000Z"    },    {      "id": "0190a0b0-0000-7000-8000-0000000000cc",      "name": "cc.vtt",      "filename": "cc.vtt",      "status": "active",      "content_type": "text/vtt",      "size": 1024,      "folder_id": null,      "url": "https://static.vturb.com/org_123/2026/08/12/cc/original.vtt",      "created_at": "2026-08-12T00:00:00.000Z",      "updated_at": "2026-08-12T00:00:00.000Z"    }  ]}