file.status_changed

Webhook

POST

file.status_changed

Fired when a file's status changes (e.g. from "Waiting review" to "Approved"). Delivered to every webhook_endpoint subscribed to the file.status_changed event type in the same organization as the file. Use new_status.id / new_status.title to decide whether to act (e.g. trigger final delivery when title == "Approved").

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": "e4f8b7a6-5846-11f1-94a9-065892dc723d",
    "type": "file.status_changed",
    "data": {
        "object": "file",
        "id": 555111,
        "name": "mix_final.wav",
        "is_folder": false,
        "parent_id": 555100,
        "size": 12345678,
        "url": "https://cdn.pibox.com/.../mix_final.wav",
        "removal_protection": false,
        "task_load_protection": false,
        "team_id": 737,
        "old_status": {
            "id": 2,
            "title": "Revision requested",
            "color": 8,
            "position": 2
        },
        "new_status": {
            "id": 3,
            "title": "Approved",
            "color": 3,
            "position": 3
        },
        "change_status_time": "2026-05-25T14:34:54Z",
        "changed_by_account_id": 1042
    }
}'

Response Example

{}

Modified at 2026-05-25 16:00:33

file.renamed

task.closed