List file activities

GET

/file/activities

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Query Params

uri

string

required

URI of the file.

Example:

cloudreve://my/Luke's%20AMA

page_size

integer

required

Page size.

>= 10

Example:

order_direction

enum<string>

optional

Order direction.

Allowed values:

ascdesc

Default:

asc

Example:

asc

next_page_token

string

optional

Token for requesting next page. Empty value means requesting the first page.

Example:

eyJpZCI6IjFibFdJTyJ9

filter

enum<string>

optional

Filter name. Use empty value to list all activities.

Allowed values:

myupdatesreads

Header Params

X-Cr-Purchase-Ticket

string

optional

Can be used to authenticate to paid share links with a anonymous identity. The ticket value can be obtained after an anonymous user purchase a paid share link.

Example:

1f63aa26-edc0-40ce-950a-cb4d4323158e

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/file/activities?uri=cloudreve://my/Luke'\''s%20AMA&page_size=50&order_direction=asc&next_page_token=eyJpZCI6IjFibFdJTyJ9&filter' \
--header 'X-Cr-Purchase-Ticket: 1f63aa26-edc0-40ce-950a-cb4d4323158e'

Responses

🟢200Success

application/json

Body

data

object (FileActivitiesResponse)

required

activities

array[object (Activity) {5}]

required

pagination

object

required

code

integer

required

Response code.
0 - Success.

Default:

Example:

msg

string

optional

Human readable error message (if any).

error

string | null

optional

Internal error message, only visable in debug mode.

correlation_id

string <uuid> | null

optional

Correlation ID of the request. Only presented on failed reqeust.

Example:

b4351ecc-ee1a-4455-bc94-2c3dbcc58538

Example

{
    "code": 0,
    "data": {
        "activities": [
            {
                "id": "VrAoFX",
                "content": {
                    "category": 8,
                    "original_name": "202206供水检测报告s.docx",
                    "new_name": "202206供水s检测报告s.docx",
                    "from": "cloudreve://ALNU6@share/202206%E4%BE%9B%E6%B0%B4%E6%A3%80%E6%B5%8B%E6%8A%A5%E5%91%8As.docx"
                },
                "created_at": "2024-05-29T14:03:49+08:00",
                "user": {
                    "id": "bnUn",
                    "email": "luke@skywalker.com",
                    "nickname": "Luke Skywalker",
                    "avatar": "file",
                    "created_at": "2023-08-06T19:21:59+08:00"
                }
            },
            {
                "id": "3JYYTr",
                "content": {
                    "category": 11,
                    "from": "cloudreve://ALNU6@share/202206%E4%BE%9B%E6%B0%B4%E6%A3%80%E6%B5%8B%E6%8A%A5%E5%91%8As.docx"
                },
                "created_at": "2024-05-29T14:03:44+08:00",
                "user": {
                    "id": "bnUn",
                    "email": "luke@skywalker.com",
                    "nickname": "Luke Skywalker",
                    "avatar": "file",
                    "created_at": "2023-08-06T19:21:59+08:00"
                }
            }
        ],
        "pagination": {
            "page": 0,
            "page_size": 20,
            "next_token": "eyJpZCI6IjFibFdJTyJ9",
            "is_cursor": true
        }
    },
    "msg": ""
}

Modified at 2025-06-27 03:15:00

List files

Get file info