file.renamed

Webhook

POST

file.renamed

Fired when a file is renamed. The data is the full file object after the rename — use data.name for the new name. (Old name is not preserved in the payload; if you need it, store the previous webhook delivery.)

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data '{
    "object": "event",
    "id": "c1d2e3f4-1234-11f1-aaaa-bbbbcccc0003",
    "type": "file.renamed",
    "data": {
        "object": "file",
        "id": 555111,
        "name": "mix_v2_final.wav",
        "is_folder": false,
        "parent_id": 555100,
        "size": 32457621,
        "url": "https://cdn.pibox.com/.../mix_v2_final.wav",
        "removal_protection": false,
        "task_load_protection": false
    }
}'

Response Example

{}

Modified at 2026-05-25 15:52:22

file.uploaded

file.status_changed