Clear built-in call history group

POST https://z.u1v.ru/api/v1/calls/history/clear

Delete authenticated recent-call history records for one grouped Calls row belonging to the active Zulip account.

The group_key must be a server-issued value previously returned from POST /calls/history. Deletion is scoped to the authenticated user's own persisted call records.

Usage examples

The -u line implements HTTP Basic authentication. See the Authorization header documentation for how to get those credentials for Zulip users and bots.

curl -sSX POST https://z.u1v.ru/api/v1/calls/history/clear \
    -u EMAIL_ADDRESS:API_KEY \
    --data-urlencode group_key=84:video:outgoing:2026-04-10

Parameters

group_key string required

Example: "84:video:outgoing:2026-04-10"

Server-issued grouped call-history key to delete.


Response

Return values

  • groupKey: string

    Server-issued call-history group key that was cleared. * deletedRecords: integer

    Number of call-history records deleted from the group.

Example response(s)

Changes: As of Zulip 7.0 (feature level 167), if any parameters sent in the request are not supported by this endpoint, a successful JSON response will include an ignored_parameters_unsupported array.

A typical successful JSON response may look like:

{
    "deletedRecords": 2,
    "groupKey": "84:video:outgoing:2026-04-10",
    "msg": "",
    "result": "success"
}