# On_fileRequestStatusChanged

Description

Notification showing the file task progress

EventHandler<string> On_fileRequestStatusChanged

Response example

{
    "method": "event",
    "event": "fileRequestStatusChanged",
    "fileRequestId": "6c0e20a7-3c79-470d-869b-7c8287587620",
    "status": 2,
    "directionType": 0,
    "fileName": "2.jpg",
    "timestamp": 1659284222850,
    "fileSize": 3200,
    "peerId": "820_1@some.server",
    "peerDisplayName": "820_1"
}

Response Parameters

Name Description
fileRequestId The identifier of a file request directed to the API
status The status of the file request at the current moment. The following values are possible:
• 0 - Internal processing error (check logs for more details)
• 1 - Waiting for instructions (e.g. declining or accepting a file, etc.)
• 2 - The processing has started, e.g., the file is now being downloaded or uploaded on the server, etc.
• 3 - The processing is complete (the file has been downloaded or uploaded on the server, etc.)
directionType The flag indicating the direction of a file request. The following values are possible:
• 0 - An inbound file request
• 1 - An outbound file request
fileName File name
fileId The unique identifier of a file on the built-in HTTP server. The field is available for outbound requests and for inbound requests that have already been processed
peerId The unique identifier (TrueConf ID) of a user. This field is included for all inbound files. In case of an outbound file, the field is not included if the request was made to a group conference
peerDisplayName The display name of a user. This field is included for all inbound files. In case of an outbound file, the field is not included if the request was made to a group conference
timestamp The time when the request was created
confId The identifier of a group conference in which the file request was created. The field is empty if the request was created outside the conference
fileSize The physical size of a file measured in bytes

See also

Last Updated: 09/12/2025