List my files.

GET

/api/v1/me/files

Returns files owned by the authenticated user. By default only claimed (persistent) files are listed — pass ?claimed=false to see files that still carry a TTL. Anonymously uploaded files are never listed here regardless of filters.

Authorizations

• default

Parameters

Query Parameters

claimed

Filter by claim state. true = persistent (no TTL), false = pending. Defaults to true.

boolean

Filter by claim state. true = persistent (no TTL), false = pending. Defaults to true.

Example

true

visibility

Filter by visibility. public or private.

string

Filter by visibility. public or private.

Example

private

q

Substring search on the original client filename.

string

Substring search on the original client filename.

Example

invoice

sort

One of created_at, -created_at, size, -size. Defaults to -created_at.

string

One of created_at, -created_at, size, -size. Defaults to -created_at.

Example

-created_at

per_page

1–100. Defaults to 15.

integer

1–100. Defaults to 15.

Example

20

page

1+.

integer

1+.

Example

1

Request Body

object

claimed

boolean

nullable

true

visibility

string

nullable

Allowed values: public private

public

q

Must not be greater than 255 characters.

string

nullable

b

sort

string

nullable

Allowed values: created_at -created_at size -size

-size

per_page

Must be at least 1. Must not be greater than 100.

integer

nullable

22

page

Must be at least 1.

integer

nullable

67

Responses

200

object

data

Array<object>

object

id

string

01HX...

client_name

string

photo.jpg

[
  {
    "id": "01HX...",
    "client_name": "photo.jpg"
  }
]

meta

object

current_page

integer

1

links

object

{
  "data": [
    {
      "id": "01HX...",
      "client_name": "photo.jpg"
    }
  ],
  "meta": {
    "current_page": 1
  },
  "links": {}
}