Skip to main content
GET
List Files
Newest first, cursor-paginated: 20 per page by default, ?limit= up to 100, and ?cursor= with the previous response’s next_cursor for the next page. See Pagination. Filter with ?kind= (image, video, audio, document) or ?search=, which matches the label and the original filename. Each file carries a label. That is the value you paste into an agent’s prompt to let it send the file — see Upload a file.

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Query Parameters

cursor
string | null

Opaque cursor from a previous response's next_cursor; omit for the first page

limit
integer
default:20

Maximum records to return in one page.

Required range: 1 <= x <= 100
kind
string | null

Filter to image, video, audio or document.

search
string | null

Match on the label or the original filename.

Response

Successful Response

data
PublicFile · object[]
required

The rows on this page.

has_more
boolean
required

Whether another page exists. false on the last one.

next_cursor
string | null

Pass back as ?cursor= to fetch the next page. null on the last page. Opaque — do not parse it or construct one; a cursor from a differently sorted list is refused with invalid_cursor rather than silently returning page 1.