WApi Interface

---

auth.user.GetSessionToken

Consumes a consumable session token to get a permanent one

Will throw and register in bouncer on failure

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Function subject to rate limitation

Authorized retries	Locked time	Retry time
30	15s	2s

Header Identification:

• account_id - int

Body Data:

• consumable_token - string

Output:

• token - string

Example:

{
    "header": {
        "target": "auth.user.GetSessionToken",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345
        }
    },
    "body": {
        "data": {
            "consumable_token": "mylabel1"
        }
    }
}

---

auth.user.Login

Used to login a user and retrieve an access token

The account must be valid and the user must be activated

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Function subject to rate limitation

Authorized retries	Locked time	Retry time
15	5s	2s

Header Identification:

• account_name - string Optional: ""
• user_id - int

Body Data:

• list_projects - bool Optional: false
• projects_auth - bool Optional: true
• projects_stats - bool Optional: false
• projects_tasks_stats - bool Optional: false
• projects_users - bool Optional: false
• manual - bool Optional: false
• token - string Optional: ""
• csrf_security - bool Optional: false
• fetch_pwd_sha - bool Optional: false

Output:

• user - User
• account - Account
• projects - LIST of Project - can be null
• need_update - bool
• need_double_authentification - bool - can be null

Example:

{
    "header": {
        "target": "auth.user.Login",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "list_projects": true,
            "projects_auth": true,
            "projects_stats": true,
            "projects_tasks_stats": true,
            "projects_users": true,
            "manual": true,
            "token": "some text",
            "csrf_security": true,
            "fetch_pwd_sha": true
        }
    }
}

---

auth.user.Logout

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• keep_self - bool Optional: false
• kill_all - bool Optional: false
• logout_sso - bool Optional: true

Output:

• success - bool
• redirect_url - string - can be missing

Example:

{
    "header": {
        "target": "auth.user.Logout",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "keep_self": true,
            "kill_all": true,
            "logout_sso": true
        }
    }
}

---

activity.event.ClearUnreadCount

Clear the activity unread count

Push information:

Pushing to: Self
With target: activity.event.ClearUnreadCount
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• success - bool

Example:

{
    "header": {
        "target": "activity.event.ClearUnreadCount",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

activity.event.ExportAsCSV

export the list of activity events in a CSV file

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• project_id_list - int list

Body Data:

• min_date - datetime Optional: null
• max_date - datetime Optional: null
• type_list - int list Optional: []
• csv_delimiter - string Optional: ";"
• csv_enclosure - string Optional: """
• user_id_list - int list Optional: []
• filter - string Optional: ""
• with_account_event - bool Optional: false

Output:

• success - bool

Example:

{
    "header": {
        "target": "activity.event.ExportAsCSV",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {
            "min_date": "2016-11-27 17:10:05",
            "max_date": "2016-11-27 17:10:05",
            "type_list": [
                12345,
                12346
            ],
            "csv_delimiter": "some text",
            "csv_enclosure": "some text",
            "user_id_list": [
                12345,
                12346
            ],
            "filter": "some text",
            "with_account_event": true
        }
    }
}

---

activity.event.ExportAsCSVAsync

export the list of activity events in a CSV file, given through a shared link later

link is sent by email

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• project_id_list - int list

Body Data:

• min_date - datetime Optional: null
• max_date - datetime Optional: null
• type_list - int list Optional: []
• csv_delimiter - string Optional: ";"
• csv_enclosure - string Optional: """
• user_id_list - int list Optional: []
• filter - string Optional: ""
• with_account_event - bool Optional: false

Output:

• success - bool

Example:

{
    "header": {
        "target": "activity.event.ExportAsCSVAsync",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {
            "min_date": "2016-11-27 17:10:05",
            "max_date": "2016-11-27 17:10:05",
            "type_list": [
                12345,
                12346
            ],
            "csv_delimiter": "some text",
            "csv_enclosure": "some text",
            "user_id_list": [
                12345,
                12346
            ],
            "filter": "some text",
            "with_account_event": true
        }
    }
}

---

activity.event.GetList

Get a list of activity events

Get a list of activity events based on the given parameters

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• project_id_list - int list

Body Data:

• min_date - datetime Optional: null
• max_date - datetime Optional: null
• limit - int Optional: 100
• offset - int Optional: 0
• user_id_list - int list Optional: []
• filter - string Optional: ""
• with_account_event - bool Optional: false
• with_deleted_or_archived_projects - bool Optional: false
• type_list - int list Optional: []

Output:

• activity_events - LIST of ActivityEvent
• total_events_count - int

Example:

{
    "header": {
        "target": "activity.event.GetList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {
            "min_date": "2016-11-27 17:10:05",
            "max_date": "2016-11-27 17:10:05",
            "limit": 12345,
            "offset": 12345,
            "user_id_list": [
                12345,
                12346
            ],
            "filter": "some text",
            "with_account_event": true,
            "with_deleted_or_archived_projects": true,
            "type_list": [
                12345,
                12346
            ]
        }
    }
}

---

activity.event.GetNextList

Ask for the next X results from events

If we are only displaying the first 100 results, this request should return the next 100 results, etc...

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• project_id_list - int list

Body Data:

• min_date - datetime Optional: null
• max_date - datetime Optional: null
• limit - int Optional: 100
• user_id_list - int list Optional: []
• filter - string Optional: ""
• with_account_event - bool Optional: false
• type_list - int list Optional: []
• current_result_count - int
• with_deleted_or_archived_projects - bool Optional: false

Output:

• activity_events - LIST of ActivityEvent
• total_events_count - int

Example:

{
    "header": {
        "target": "activity.event.GetNextList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {
            "min_date": "2016-11-27 17:10:05",
            "max_date": "2016-11-27 17:10:05",
            "limit": 12345,
            "user_id_list": [
                12345,
                12346
            ],
            "filter": "some text",
            "with_account_event": true,
            "type_list": [
                12345,
                12346
            ],
            "current_result_count": 12345,
            "with_deleted_or_archived_projects": true
        }
    }
}

---

activity.event.GetNotifications

Get a list of activity events notified for the contexted user

Get a list of activity events notified for the contexted user

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• limit - int Optional: 100

Output:

• activity_events - LIST of ActivityEvent
• total_events_count - int
• total_unread - LIST of struct
  • project_id - int
  • total - int
  • document - int
  • task - int
  • calendar - int
  • meeting - int

Example:

{
    "header": {
        "target": "activity.event.GetNotifications",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "limit": 12345
        }
    }
}

---

activity.event.GetUnreadCount

Get unread event count by projects

Push information:

Pushing to: Self
With target: activity.event.GetUnreadCount
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• limit - int Optional: 100

Output:

• total_unread - LIST of struct
  • project_id - int
  • total - int
  • document - int
  • task - int
  • calendar - int
  • meeting - int
• panel_unread - int

Example:

{
    "header": {
        "target": "activity.event.GetUnreadCount",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "limit": 12345
        }
    }
}

---

activity.event.NewEvent

Used to generate push message

Push is sent when we generate an event for an item

Push information:

Pushing to: User list
With target: activity.event.NewEvent
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• event - ActivityEvent

Example:

{
    "header": {
        "target": "activity.event.NewEvent",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

activity.event.NewEventList

Used to generate push message

Push is sent when we generate a list of event for an item

Push information:

Pushing to: User list
With target: activity.event.NewEventList
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• event_list - LIST of ActivityEvent

Example:

{
    "header": {
        "target": "activity.event.NewEventList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

armoured.armoured.AddArmouredChat

Push information:

Pushing to: Chat users
With target: armoured.armoured.AddArmouredChat
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• session_id - string

Output:

• armoured_chat - ArmouredEncryptionSession

Example:

{
    "header": {
        "target": "armoured.armoured.AddArmouredChat",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "session_id": "mylabel1"
        }
    },
    "body": {
        "data": {}
    }
}

---

armoured.armoured.BatchAddArmouredChatUserAccess

Push information:

Pushing to: User list
With target: armoured.armoured.BatchAddArmouredChatUserAccess
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• user_access_list - array
• chat_id - int

Output:

• armoured_chat_user_access_list - LIST of ArmouredChatUserAccess

Example:

{
    "header": {
        "target": "armoured.armoured.BatchAddArmouredChatUserAccess",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "user_access_list": [
                {
                    "user_id": 12345,
                    "access_id": "asdczxc",
                    "raw_over_encryption_key": "akjsk"
                },
                {
                    "user_id": 123456,
                    "access_id": "zxczxasd",
                    "raw_over_encryption_key": "alkskdj"
                }
            ],
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

armoured.armoured.ConsumeSessionIdToken

Push information:

Pushing to: Self
With target: armoured.armoured.ConsumeSessionIdToken
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• session_id - string

Output:

• success - bool

Example:

{
    "header": {
        "target": "armoured.armoured.ConsumeSessionIdToken",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "session_id": "some text"
        }
    },
    "body": {
        "data": {}
    }
}

---

armoured.armoured.DeleteArmouredChatUserAccess

Push information:

Pushing to: Self
With target: armoured.armoured.DeleteArmouredChatUserAccess
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Output:

• chat_id - int

Example:

{
    "header": {
        "target": "armoured.armoured.DeleteArmouredChatUserAccess",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

armoured.armoured.GetChatAccountArmouredData

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• armoured_chat_list - LIST of ArmouredEncryptionSession
• armoured_chat_user_access_list - LIST of ArmouredChatUserAccess - can be null

Example:

{
    "header": {
        "target": "armoured.armoured.GetChatAccountArmouredData",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

armoured.armoured.GetEncryptionSessionForItem

Push information:

Pushing to: Self
With target: armoured.armoured.GetEncryptionSessionForItem
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• item - WimiItem

Output:

• encryption_session - ArmouredEncryptionSession - can be null

Example:

{
    "header": {
        "target": "armoured.armoured.GetEncryptionSessionForItem",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "item": {
                "item_type_id": "3",
                "item_id": "12345"
            }
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.AddComment

Add a comment to a calendar event

Push information:

Pushing to: Project users
With target: calendar.event.AddComment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Body Data:

• comment - string
• integration_attachment - Wimi\WApi\Parameter\WapiParamIntegrationAttachment Optional: null

Output:

• event_id - int
• comment - Comment

Example:

{
    "header": {
        "target": "calendar.event.AddComment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "comment": "some text",
            "integration_attachment": "no example yet"
        }
    }
}

---

calendar.event.AddExternalAttachment

Attach an external file to a calendar event

Push information:

Pushing to: Project users
With target: calendar.event.AddExternalAttachment
Stream value: Pushing on all streams

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the X-Wimi-WApi http header of the request.
It has to be encoded (encoding similar to the php function rawurlencode).
The file content is provided in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Body Data:

• file_timestamp - string Optional: ""
• name - string
• size - int

Output:

• success - bool
• attachment - ExternalAttachment
• calendar_event_id - int

Example:

{
    "header": {
        "target": "calendar.event.AddExternalAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "file_timestamp": "some text",
            "name": "some text",
            "size": 12345
        }
    }
}

---

calendar.event.AddExternalAttachmentComment

Push information:

Pushing to: Project users
With target: calendar.event.AddExternalAttachmentComment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Body Data:

• attachment_title - string Optional: ""
• attachment_description - string Optional: ""
• name - string
• size - int

Output:

• event_id - int
• comment - Comment

Example:

{
    "header": {
        "target": "calendar.event.AddExternalAttachmentComment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "attachment_title": "some text",
            "attachment_description": "some text",
            "name": "some text",
            "size": 12345
        }
    }
}

---

calendar.event.AddExternalAttachmentFromTemplate

Attach an external file to a calendar event, from a template

Push information:

Pushing to: Project users
With target: calendar.event.AddExternalAttachmentFromTemplate
Stream value: Pushing on all streams

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the X-Wimi-WApi http header of the request.
It has to be encoded (encoding similar to the php function rawurlencode).
The file content is provided in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• file_template_id - int

Body Data:

• name - string

Output:

• success - bool
• attachment - ExternalAttachment
• calendar_event_id - int

Example:

{
    "header": {
        "target": "calendar.event.AddExternalAttachmentFromTemplate",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "file_template_id": 12345
        }
    },
    "body": {
        "data": {
            "name": "some text"
        }
    }
}

---

calendar.event.AddExternalParticipants

Add external participant for a specific event

Push information:

Pushing to: Project users
With target: calendar.event.AddExternalParticipants
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Function subject to rate limitation

Authorized retries	Locked time	Retry time
1	10s	2s

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• recurrence_id - datetime Optional: null

Body Data:

• external_user_list - list

Output:

• success - bool
• event - CalendarEvent
• external_participants - LIST of ExternalUser - can be missing

Example:

{
    "header": {
        "target": "calendar.event.AddExternalParticipants",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "external_user_list": [
                {
                    "email": "external_user1@domain.com",
                    "first_name": "first_name1",
                    "last_name": "last_name1"
                },
                {
                    "email": "external_user2@domain.com",
                    "first_name": "first_name2",
                    "last_name": "last_name2"
                }
            ]
        }
    }
}

---

calendar.event.AddInternalAttachmentComment

Push information:

Pushing to: Project users
With target: calendar.event.AddInternalAttachmentComment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• attachment_file_id - int

Output:

• event_id - int
• comment - Comment

Example:

{
    "header": {
        "target": "calendar.event.AddInternalAttachmentComment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "attachment_file_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.AddInternalAttachmentCommentList

Push information:

Pushing to: Project users
With target: calendar.event.AddInternalAttachmentCommentList
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• file_id_list - int list

Output:

• event - int
• comment_list - LIST of Comment

Example:

{
    "header": {
        "target": "calendar.event.AddInternalAttachmentCommentList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "file_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.AddSubscriptionLink

Add user to subscription agenda list, it will create token if it not already exist

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• success - bool
• token - string

Example:

{
    "header": {
        "target": "calendar.event.AddSubscriptionLink",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.AddTag

Add a tag to a Calendar Event

Push information:

Pushing to: Project users
With target: calendar.event.AddTag
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• label - string
• recurrence_id - string Optional: ""

Output:

• success - bool
• event - CalendarEvent
• tag - Tag

Example:

{
    "header": {
        "target": "calendar.event.AddTag",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "label": "mylabel1"
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.AddUnifiedSubscriptionLink

Add user to subscription agenda list, it will create token if it not already exist on unified view

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• success - bool
• token - string

Example:

{
    "header": {
        "target": "calendar.event.AddUnifiedSubscriptionLink",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.AddWimiAttachment

Attach a wimi file to a calendar event

Push information:

Pushing to: Project users
With target: calendar.event.AddWimiAttachment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• file_id - int

Output:

• success - bool
• attachment - DocumentAttachment
• calendar_event_id - int

Example:

{
    "header": {
        "target": "calendar.event.AddWimiAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "file_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.ChangeInviteStatus

Change Status of Agenda Event Participant. Accept / Refuse invite to an event

Push information:

Pushing to: Project users
With target: calendar.event.ChangeInviteStatus
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• recurrence_id - datetime Optional: null

Body Data:

• status - int

Output:

• events - LIST of CalendarEvent

Example:

{
    "header": {
        "target": "calendar.event.ChangeInviteStatus",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "status": 12345
        }
    }
}

---

calendar.event.ConversationArchive

Archive a conversation

Push information:

Pushing to: Self
With target: calendar.event.ConversationArchive
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Output:

• success - bool
• calendar_event_id - int
• user_id - int

Example:

{
    "header": {
        "target": "calendar.event.ConversationArchive",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.ConversationClearUnseen

Clear unseen count for conversation

Push information:

Pushing to: Project users
With target: calendar.event.ConversationClearUnseen
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Output:

• success - bool
• calendar_event_id - int
• user_id - int

Example:

{
    "header": {
        "target": "calendar.event.ConversationClearUnseen",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.ConversationSetSilent

Set silent for conversation

Push information:

Pushing to: Self
With target: calendar.event.ConversationSetSilent
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Body Data:

• silent - bool
• silent_until - datetime Optional: null

Output:

• success - bool
• calendar_event_id - int
• user_id - int
• silent - bool
• silent_until - datetime - can be missing - can be null

Example:

{
    "header": {
        "target": "calendar.event.ConversationSetSilent",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "silent": true,
            "silent_until": "2016-11-27 17:10:05"
        }
    }
}

---

calendar.event.CopyEventList

Push information:

Pushing to: Project users
With target: calendar.event.CopyEventList
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id_list - int list
• target_project_id - int Optional: null

Body Data:

• recurrence_id_list - Array Optional: stdClass Object ( )

Output:

• events - LIST of CalendarEvent
• success - bool

Example:

{
    "header": {
        "target": "calendar.event.CopyEventList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {
            "recurrence_id_list": [
                1,
                2,
                3,
                4
            ]
        }
    }
}

---

calendar.event.Create

Create a calendar event

Push information:

Pushing to: User list
With target: calendar.event.Create
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int

Body Data:

• event - struct

Output:

• event - CalendarEvent
• success - bool

Example:

{
    "header": {
        "target": "calendar.event.Create",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345
        }
    },
    "body": {
        "data": {
            "event": "no example yet"
        }
    }
}

---

calendar.event.DeleteComment

Delete a calendar event comment

Mark the message as deleted, does not delete it entirely

Push information:

Pushing to: Project users
With target: calendar.event.DeleteComment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• comment_id - int (parameter needs to be owned by api user)

Output:

• success - bool
• calendar_event_id - int
• comment - Comment

Example:

{
    "header": {
        "target": "calendar.event.DeleteComment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "comment_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.DeleteSubscription

Get calendar subscription link for unified projects

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• user_id - int

Output:

• success - bool

Example:

{
    "header": {
        "target": "calendar.event.DeleteSubscription",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "user_id": 12345
        }
    }
}

---

calendar.event.DeleteSubscriptionUnified

Get calendar subscription link for unified projects

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• user_id - int

Output:

• success - bool

Example:

{
    "header": {
        "target": "calendar.event.DeleteSubscriptionUnified",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "user_id": 12345
        }
    }
}

---

calendar.event.DownloadAttachment

Download a calendar event attachment

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• attachment_id - int
• calendar_event_id - CalendarEvent

Output:

• md5 - string
• date - string
• name - string
• size - int
• doc_type - string - can be missing
• doc_id - int
• output_type - string
• item_type_id - int

Example:

{
    "header": {
        "target": "calendar.event.DownloadAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "attachment_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.DownloadCommentExternalAttachment

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• attachment_file_id - int
• calendar_event_id - CalendarEvent

Output:

• md5 - string - can be null
• date - string
• name - string
• size - int - can be null
• file_path - string - can be missing
• doc_type - string - can be missing
• doc_id - int
• output_type - string
• item_type_id - int

Example:

{
    "header": {
        "target": "calendar.event.DownloadCommentExternalAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "attachment_file_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.EditComment

Edit a comment of a calendar event

Push information:

Pushing to: Project users
With target: calendar.event.EditComment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• comment_id - int (parameter needs to be owned by api user)

Body Data:

• comment - string

Output:

• event_id - int
• comment - Comment

Example:

{
    "header": {
        "target": "calendar.event.EditComment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "comment_id": 12345
        }
    },
    "body": {
        "data": {
            "comment": "some text"
        }
    }
}

---

calendar.event.GenerateWOGeneralFile

create an external file to a calendar event

Push information:

Pushing to: User list
With target: calendar.event.GenerateWOGeneralFile
Stream value: Pushing on all streams

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the X-Wimi-WApi http header of the request.
It has to be encoded (encoding similar to the php function rawurlencode).
The file content is provided in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Body Data:

• name - string
• file_format - string

Output:

• success - bool
• attachment - ExternalAttachment
• calendar_event_id - int

Example:

{
    "header": {
        "target": "calendar.event.GenerateWOGeneralFile",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "name": "some text",
            "file_format": "some text"
        }
    }
}

---

calendar.event.Get

Get the details of a calendar events

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• recurrence_id - datetime Optional: null

Output:

• event - CalendarEvent

Example:

{
    "header": {
        "target": "calendar.event.Get",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetAttachmentList

get the list of files attached to a calendar event

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Output:

• external_attachments - LIST of ExternalAttachment
• wimi_attachments - LIST of DocumentAttachment

Example:

{
    "header": {
        "target": "calendar.event.GetAttachmentList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetComments

Get teh comments of a calendar event

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Output:

• comments - LIST of Comment

Example:

{
    "header": {
        "target": "calendar.event.GetComments",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetDownloadInviteLink

Download the ics for a specific event

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Output:

• success - bool
• link - string

Example:

{
    "header": {
        "target": "calendar.event.GetDownloadInviteLink",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetExternalParticipants

Get external participant for a specific event

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Output:

• success - bool
• event_id - int
• external_participants - LIST of ExternalUser - can be missing

Example:

{
    "header": {
        "target": "calendar.event.GetExternalParticipants",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetList

Get a list of events

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int

Body Data:

• start_date - datetime Optional: null
• end_date - datetime Optional: null
• filters - int list Optional: Array ( [0] => 1 )
• view_busy - bool Optional: true
• busy_user_id_list - int list Optional: null
• view_empty_events - bool Optional: true
• calendar_event_id_list - int list Optional: []
• gen_rec_occurrences - bool Optional: true
• modified_after - int Optional: 0

Output:

• events - LIST of CalendarEvent

Example:

{
    "header": {
        "target": "calendar.event.GetList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345
        }
    },
    "body": {
        "data": {
            "start_date": "2016-11-27 17:10:05",
            "end_date": "2016-11-27 17:10:05",
            "filters": [
                12345,
                12346
            ],
            "view_busy": true,
            "busy_user_id_list": [
                12345,
                12346
            ],
            "view_empty_events": true,
            "calendar_event_id_list": [
                12345,
                12346
            ],
            "gen_rec_occurrences": true,
            "modified_after": 12345
        }
    }
}

---

calendar.event.GetListUnified

Get a list of events for unified calendars

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• start_date - datetime
• end_date - datetime
• filters - int list Optional: Array ( [0] => 1 )
• project_id_list - int list Optional: null
• user_id_list - int list Optional: null
• gen_rec_occurrences - bool Optional: true
• view_empty_events - bool Optional: true

Output:

• events - LIST of CalendarEvent

Example:

{
    "header": {
        "target": "calendar.event.GetListUnified",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "start_date": "2016-11-27 17:10:05",
            "end_date": "2016-11-27 17:10:05",
            "filters": [
                12345,
                12346
            ],
            "project_id_list": [
                12345,
                12346
            ],
            "user_id_list": [
                12345,
                12346
            ],
            "gen_rec_occurrences": true,
            "view_empty_events": true
        }
    }
}

---

calendar.event.GetSubscriptionLink

Get a calendar subscription link

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int

Output:

• link - string - can be null

Example:

{
    "header": {
        "target": "calendar.event.GetSubscriptionLink",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetUnifiedSubscriptionLink

Get calendar subscription link for unified projects

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• link - string

Example:

{
    "header": {
        "target": "calendar.event.GetUnifiedSubscriptionLink",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetUserSubscriptionList

Get calendar subscription link for projects

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• success - bool
• user_id_list - LIST of int

Example:

{
    "header": {
        "target": "calendar.event.GetUserSubscriptionList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.GetUserSubscriptionListUnified

Get calendar subscription link for unified calendar

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Output:

• success - bool
• user_id_list - LIST of int

Example:

{
    "header": {
        "target": "calendar.event.GetUserSubscriptionListUnified",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.LinkTag

Link a tag to a calendar event

Push information:

Pushing to: Project users
With target: calendar.event.LinkTag
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• tag_id - int
• recurrence_id - string Optional: ""

Output:

• success - bool
• event - CalendarEvent
• tag - Tag

Example:

{
    "header": {
        "target": "calendar.event.LinkTag",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "tag_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.PreviewAttachment

Request attachment preview

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• attachment_id - int
• calendar_event_id - CalendarEvent

Body Data:

• preview_type - string Optional: "default"

Output:

• md5 - string
• date - string
• name - string
• size - int
• preview_status - string
• doc_type - string
• doc_id - int
• output_type - string

Example:

{
    "header": {
        "target": "calendar.event.PreviewAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "attachment_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "preview_type": "some text"
        }
    }
}

---

calendar.event.Remove

Delete a calendar event

Push information:

Pushing to: Project users
With target: calendar.event.Remove
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Output:

• event_id - int
• success - bool

Example:

{
    "header": {
        "target": "calendar.event.Remove",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.RemoveExternalAttachment

remove an external attachment from the calendar

Push information:

Pushing to: Project users
With target: calendar.event.RemoveExternalAttachment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• attachment_id - int

Output:

• success - bool
• attachment_id - int
• calendar_event_id - int

Example:

{
    "header": {
        "target": "calendar.event.RemoveExternalAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "attachment_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.RemoveExternalParticipants

Remove external participant for a specific event

Push information:

Pushing to: Project users
With target: calendar.event.RemoveExternalParticipants
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• recurrence_id - datetime Optional: null

Body Data:

• external_user_id_list - int list

Output:

• success - bool
• event - CalendarEvent
• external_participants - LIST of ExternalUser - can be missing

Example:

{
    "header": {
        "target": "calendar.event.RemoveExternalParticipants",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "external_user_id_list": [
                12345,
                12346
            ]
        }
    }
}

---

calendar.event.RemoveRecurrenceOccurrence

Delete a recurrence occurrence

Push information:

Pushing to: Project users
With target: calendar.event.RemoveRecurrenceOccurrence
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Body Data:

• recurrence_id - datetime

Output:

• event_id - int
• success - bool
• recurrence_id - datetime

Example:

{
    "header": {
        "target": "calendar.event.RemoveRecurrenceOccurrence",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "recurrence_id": "2016-11-27 17:10:05"
        }
    }
}

---

calendar.event.RemoveTag

Remove a tag in a task

Push information:

Pushing to: Project users
With target: calendar.event.RemoveTag
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• tag_id - int
• recurrence_id - string Optional: ""

Output:

• success - bool
• event - CalendarEvent
• tag - Tag

Example:

{
    "header": {
        "target": "calendar.event.RemoveTag",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "tag_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.RemoveWimiAttachment

remove a wimi attachment from the calendar

Push information:

Pushing to: Project users
With target: calendar.event.RemoveWimiAttachment
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• attachment_id - int

Output:

• success - bool
• attachment_id - int
• calendar_event_id - int

Example:

{
    "header": {
        "target": "calendar.event.RemoveWimiAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "attachment_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

calendar.event.ToggleCommentReaction

Toggle a reaction to a comment

Push information:

Pushing to: Project users
With target: calendar.event.ToggleCommentReaction
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• comment_id - int (parameter needs to be owned by api user)

Body Data:

• reaction - string
• active - bool

Output:

• success - bool
• calendar_event_id - int
• comment_id - int
• reaction - string
• active - bool

Example:

{
    "header": {
        "target": "calendar.event.ToggleCommentReaction",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "comment_id": 12345
        }
    },
    "body": {
        "data": {
            "reaction": "some text",
            "active": true
        }
    }
}

---

calendar.event.Update

Update a calendar event - only the provided data are updated.

Push information:

Pushing to: User list
With target: calendar.event.Update
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent

Body Data:

• event - struct

Output:

• event - CalendarEvent
• success - bool
• updated_fields - LIST of string

Example:

{
    "header": {
        "target": "calendar.event.Update",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345
        }
    },
    "body": {
        "data": {
            "event": "no example yet"
        }
    }
}

---

calendar.event.UpdateProject

Move a calendar event from one project to another

Push information:

Pushing to: User list
With target: calendar.event.UpdateProject
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Agenda restrictions:

Read-only (1)	Read-write (2)
	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int
• calendar_event_id - CalendarEvent
• target_project_id - int

Output:

• event - CalendarEvent
• success - bool

Example:

{
    "header": {
        "target": "calendar.event.UpdateProject",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345,
            "calendar_event_id": 12345,
            "target_project_id": 12346
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.AddAttachment

Attach a file to a chat

Push information:

Pushing to: Chat users
With target: chat.chat.AddAttachment
Stream value: Pushing on chat stream (2)

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the X-Wimi-WApi http header of the request.
It has to be encoded (encoding similar to the php function rawurlencode).
The file content is provided in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• attachment_title - string Optional: ""
• attachment_description - string Optional: ""
• name - string
• size - int

Output:

• success - bool
• chat_id - int
• message - ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.AddAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "attachment_title": "some text",
            "attachment_description": "some text",
            "name": "some text",
            "size": 12345
        }
    }
}

---

chat.chat.AddInternalAttachment

Push information:

Pushing to: Chat users
With target: chat.chat.AddInternalAttachment
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• file_id - int

Output:

• success - bool
• chat_id - int
• message - ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.AddInternalAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "file_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.AddInternalAttachments

Push information:

Pushing to: Chat users
With target: chat.chat.AddInternalAttachments
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• file_id_list - int list

Output:

• success - bool
• chat_id - int
• messages - LIST of ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.AddInternalAttachments",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "file_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.AddMembers

Add members to a chat

Push information:

Pushing to: Chat users
With target: chat.chat.AddMembers
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• member_id_list - array
  • - member_id: id of the member
  • - member_type_id: type id of the member: 1 for user, 2 for user group

Output:

• success - bool
• chat_id - int
• chat_users - LIST of ChatUser
• chat_members - LIST of ChatMember

Example:

{
    "header": {
        "target": "chat.chat.AddMembers",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "member_id_list": [
                {
                    "member_type_id": 1,
                    "member_id": 12345
                },
                {
                    "member_type_id": 2,
                    "member_id": 12345
                }
            ]
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.AddUsers

Add users to a chat

Push information:

Pushing to: Chat users
With target: chat.chat.AddUsers
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• user_id_list - int list

Output:

• success - bool
• chat_id - int
• added_user_id_list - LIST of int
• chat_users - LIST of ChatUser

Example:

{
    "header": {
        "target": "chat.chat.AddUsers",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "user_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.AutomatedMessage

Post automated message to chat

Push information:

Pushing to: Chat users
With target: chat.chat.AutomatedMessage
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• integration_attachment - Wimi\WApi\Parameter\WapiParamIntegrationAttachment Optional: null
• chat_message - int

Output:

• success - bool
• message - ChatMessage
• chat_id - int

Example:

{
    "header": {
        "target": "chat.chat.AutomatedMessage",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "integration_attachment": "no example yet",
            "chat_message": 12345
        }
    }
}

---

chat.chat.CanceledTyping

Send a notification that the user canceled typing

Push information:

Pushing to: Chat users
With target: chat.chat.CanceledTyping
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Output:

• user_id - int
• chat_id - int

Example:

{
    "header": {
        "target": "chat.chat.CanceledTyping",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.ClearUnseen

Clear unseen count for chat

Push information:

Pushing to: Chat users
With target: chat.chat.ClearUnseen
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• delay_notifications - bool Optional: false

Output:

• success - bool
• chat_id - int
• user_id - int

Example:

{
    "header": {
        "target": "chat.chat.ClearUnseen",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "delay_notifications": true
        }
    }
}

---

chat.chat.Create

Create a group chat

Push information:

Pushing to: Self
With target: chat.chat.Create
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• users - int list Optional: []
• user_groups - int list Optional: []
• name - string Optional: ""
• use_existing - bool Optional: true
• force_creation - bool Optional: false

Output:

• success - bool
• chat_id - int

Example:

{
    "header": {
        "target": "chat.chat.Create",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "users": [
                12345,
                12346
            ],
            "user_groups": [
                12345,
                12346
            ],
            "name": "some text",
            "use_existing": true,
            "force_creation": true
        }
    }
}

---

chat.chat.CreateChannel

Create channel chat

Push information:

Pushing to: Self
With target: chat.chat.CreateChannel
Stream value: Pushing on all streams

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

This route is project restricted. This means you need to provide a project_id in the headers and have access to it.

Project restrictions:

Project members (0)	Project administrators (5)
X	X

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• project_id - int

Output:

• success - bool
• chat_id - int

Example:

{
    "header": {
        "target": "chat.chat.CreateChannel",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "project_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.DeleteMessage

Delete a message

Mark the message as deleted, does not delete it entirely

Push information:

Pushing to: User list
With target: chat.chat.DeleteMessage
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• message_id - int (parameter needs to be owned by api user)

Body Data:

• message_index - int Optional: 0

Output:

• success - bool
• chat_id - int
• message - ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.DeleteMessage",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "message_id": 12345
        }
    },
    "body": {
        "data": {
            "message_index": 12345
        }
    }
}

---

chat.chat.Disable

Disable a chat for a user

Remove the chat from the recent chats

Push information:

Pushing to: Self
With target: chat.chat.Disable
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Output:

• success - bool
• chat_id - int

Example:

{
    "header": {
        "target": "chat.chat.Disable",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.DownloadAttachment

Download a chat attachment

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• file_id - int
• chat_id - int

Output:

• md5 - string - can be null
• date - string
• name - string
• size - int - can be null
• file_path - string - can be missing
• doc_type - string - can be missing
• doc_id - int
• output_type - string
• item_type_id - int

Example:

{
    "header": {
        "target": "chat.chat.DownloadAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "file_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.EditMessage

Edit a message

Push information:

Pushing to: Chat users
With target: chat.chat.EditMessage
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• message_id - int (parameter needs to be owned by api user)

Body Data:

• message - string
• message_index - int Optional: 0
• auto_link_url_items - bool Optional: false

Output:

• success - bool
• chat_id - int
• message - ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.EditMessage",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "message_id": 12345
        }
    },
    "body": {
        "data": {
            "message": "some text",
            "message_index": 12345,
            "auto_link_url_items": true
        }
    }
}

---

chat.chat.EditName

Edit a chat name

Push information:

Pushing to: Chat users
With target: chat.chat.EditName
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• name - string

Output:

• success - bool
• chat_id - int
• name - string

Example:

{
    "header": {
        "target": "chat.chat.EditName",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "name": "some text"
        }
    }
}

---

chat.chat.FavoriteMessage

Favorite a message

Push information:

Pushing to: Self
With target: chat.chat.FavoriteMessage
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• message_id - int

Body Data:

• message_index - int Optional: 0

Output:

• success - bool
• chat_id - int
• message_index - int
• message_id - int

Example:

{
    "header": {
        "target": "chat.chat.FavoriteMessage",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "message_id": 12345
        }
    },
    "body": {
        "data": {
            "message_index": 12345
        }
    }
}

---

chat.chat.GetAttachmentList

Get attachment list

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• limit - int Optional: 0

Output:

• success - bool
• attachments - LIST of ChatMessage
• attachments_count - int

Example:

{
    "header": {
        "target": "chat.chat.GetAttachmentList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "limit": 12345
        }
    }
}

---

chat.chat.GetChat

Get chat

with or without messages, default with

Push information:

Pushing to: Self
With target: chat.chat.GetChat
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• with_messages - bool Optional: true
• limit - int Optional: 30

Output:

• success - bool
• chat_id - int
• chat - ChatFull

Example:

{
    "header": {
        "target": "chat.chat.GetChat",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "with_messages": true,
            "limit": 12345
        }
    }
}

---

chat.chat.GetConversationList

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Output:

• success - bool
• conversations - LIST of Chat

Example:

{
    "header": {
        "target": "chat.chat.GetConversationList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.GetFavorites

Get favorite list

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Output:

• success - bool
• favorites - LIST of ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.GetFavorites",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.GetLinks

Get shared links in a chat

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Output:

• success - bool
• links - LIST of ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.GetLinks",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.GetList

Get chat list

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int

Body Data:

• comment_count - bool Optional: false
• offset - int Optional: 0
• limit - int Optional: 1000
• chat - bool Optional: true
• channel - bool Optional: true

Output:

• success - bool
• chats - LIST of Chat
• items - LIST of CommentedItemCount - can be missing

Example:

{
    "header": {
        "target": "chat.chat.GetList",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345
        }
    },
    "body": {
        "data": {
            "comment_count": true,
            "offset": 12345,
            "limit": 12345,
            "chat": true,
            "channel": true
        }
    }
}

---

chat.chat.GetMessageBeforeAfter

Search through chat messages

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• message_id - int

Body Data:

• message_index - int Optional: 0

Output:

• success - bool
• results - struct
  • before - LIST of ChatMessage
  • after - LIST of ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.GetMessageBeforeAfter",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "message_id": 12345
        }
    },
    "body": {
        "data": {
            "message_index": 12345
        }
    }
}

---

chat.chat.LoadAttachments

Get chat attachments from offset of given message id, until limit

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• message_id - int Optional: null

Body Data:

• limit - int Optional: 30

Output:

• success - bool
• attachments - LIST of ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.LoadAttachments",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "limit": 12345
        }
    }
}

---

chat.chat.LoadMessages

Get chat messages from offset of given message id, until limit

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• message_id - int Optional: null

Body Data:

• offset - int Optional: 0
• limit - int Optional: 30

Output:

• success - bool
• chat_id - int
• messages - LIST of ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.LoadMessages",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "offset": 12345,
            "limit": 12345
        }
    }
}

---

chat.chat.PostMessage

Post message to chat

Push information:

Pushing to: Chat users
With target: chat.chat.PostMessage
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• api_key - string Optional: ""
• chat_id - int

Body Data:

• message - string
• integration_attachment - Wimi\WApi\Parameter\WapiParamIntegrationAttachment Optional: null
• auto_link_url_items - bool Optional: false

Output:

• success - bool
• chat_id - int
• message - ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.PostMessage",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "message": "some text",
            "integration_attachment": "no example yet",
            "auto_link_url_items": true
        }
    }
}

---

chat.chat.PreviewAttachment

Request attachment preview

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• attachment_id - int Optional: null
• chat_id - int

Body Data:

• preview_type - string Optional: "default"

Output:

• md5 - string
• date - string
• name - string
• size - int
• preview_status - string
• output_type - string
• doc_type - string
• doc_id - int

Example:

{
    "header": {
        "target": "chat.chat.PreviewAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "preview_type": "some text"
        }
    }
}

---

chat.chat.RemoveMembers

Remove members from a chat

Push information:

Pushing to: User list
With target: chat.chat.RemoveMembers
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• member_id_list - array
  • - member_id: id of the member
  • - member_type_id: type id of the member: 1 for user, 2 for user group

Output:

• success - bool
• chat_id - int
• chat_users - LIST of ChatUser
• chat_members - LIST of ChatMember

Example:

{
    "header": {
        "target": "chat.chat.RemoveMembers",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "member_id_list": [
                {
                    "member_type_id": 1,
                    "member_id": 12345
                },
                {
                    "member_type_id": 2,
                    "member_id": 12345
                }
            ]
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.RemoveUsers

Remove users from a chat

Push information:

Pushing to: Chat users
With target: chat.chat.RemoveUsers
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• user_id_list - int list

Output:

• success - bool
• chat_id - int
• removed_user_id_list - LIST of int
• chat_users - LIST of ChatUser

Example:

{
    "header": {
        "target": "chat.chat.RemoveUsers",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "user_id_list": [
                12345,
                12346
            ]
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.Search

Search through chat messages

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• search - string

Output:

• success - bool
• results - LIST of ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.Search",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "search": "some text"
        }
    }
}

---

chat.chat.SendPromptToAssistant

Sends a prompt to a generative AI assistant

Push information:

Pushing to: Chat users
With target: chat.chat.SendPromptToAssistant
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• prompt - string
• neo_id - int
• with_context - bool

Output:

• success - bool
• prompt - string
• status - int
• message_id - int
• neo_id - int
• chat_id - int

Example:

{
    "header": {
        "target": "chat.chat.SendPromptToAssistant",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "prompt": "some text",
            "neo_id": 12345,
            "with_context": true
        }
    }
}

---

chat.chat.SetMessageIntegrationAttachment

Set the integration attachment for a message

Push information:

Pushing to: Chat users
With target: chat.chat.SetMessageIntegrationAttachment
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• api_key - string Optional: ""
• chat_id - int
• message_id - int (parameter needs to be owned by api user)

Body Data:

• integration_attachment - Wimi\WApi\Parameter\WapiParamIntegrationAttachment Optional: null

Output:

• success - bool
• chat_id - int
• message - ChatMessage

Example:

{
    "header": {
        "target": "chat.chat.SetMessageIntegrationAttachment",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "message_id": 12345
        }
    },
    "body": {
        "data": {
            "integration_attachment": "no example yet"
        }
    }
}

---

chat.chat.SetSilent

Set silent for chat

Push information:

Pushing to: Self
With target: chat.chat.SetSilent
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• silent - bool
• silent_until - datetime Optional: null

Output:

• success - bool
• chat_id - int
• user_id - int
• silent - bool
• silent_until - datetime - can be missing - can be null

Example:

{
    "header": {
        "target": "chat.chat.SetSilent",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "silent": true,
            "silent_until": "2016-11-27 17:10:05"
        }
    }
}

---

chat.chat.StartedTyping

Send a notification that the user is typing

Push information:

Pushing to: Chat users
With target: chat.chat.StartedTyping
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Output:

• user_id - int
• chat_id - int

Example:

{
    "header": {
        "target": "chat.chat.StartedTyping",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {}
    }
}

---

chat.chat.UnfavoriteMessage

Unfavorite a message

Push information:

Pushing to: Self
With target: chat.chat.UnfavoriteMessage
Stream value: Pushing on chat stream (2)

Url:

https://api.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int
• message_id - int

Body Data:

• message_index - int Optional: 0

Output:

• success - bool
• chat_id - int
• message_index - int
• message_id - int

Example:

{
    "header": {
        "target": "chat.chat.UnfavoriteMessage",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345,
            "message_id": 12345
        }
    },
    "body": {
        "data": {
            "message_index": 12345
        }
    }
}

---

chat.chat.UpdateGroupChatProfilePicture

Push information:

Pushing to: Chat users
With target: chat.chat.UpdateGroupChatProfilePicture
Stream value: Pushing on chat stream (2)

Url:

https://api.files.wimi.pro

Call type:

The json message is sent in the http request body.

Restrictions:

Role restrictions:

Guests (-5)	Contributors (0)	Managers (1)	Administrators (2)	Account manager (3)
X	X	X	X	X

Header Identification:

• account_id - int
• user_id - int
• chat_id - int

Body Data:

• name - string Optional: ""
• size - int Optional: 0

Output:

• success - bool
• chat_id - int
• custom_image_id - int

Example:

{
    "header": {
        "target": "chat.chat.UpdateGroupChatProfilePicture",
        "api_version": "1.2",
        "app_token": "You can generate one from your account settings",
        "msg_key": "message key also returned in the response",
        "token": "user session token returned by auth.user.Login",
        "identification": {
            "account_id": 12345,
            "user_id": 12345,
            "chat_id": 12345
        }
    },
    "body": {
        "data": {
            "name": "some text",
            "size": 12345
        }
    }
}