Create a data export

This endpoint is only available to organization administrators.

POST https://echt-reu-23.zulipchat.com/api/v1/export/realm

Create a public or a standard data export of the organization.

Note: If you're the administrator of a self-hosted installation, you may be looking for the documentation on server data export and import or server backups.

Changes: Prior to Zulip 10.0 (feature level 304), only public data exports could be created using this endpoint.

New in Zulip 2.1.

Usage examples

#!/usr/bin/env python

import zulip

# The user for this zuliprc file must be an organization administrator
client = zulip.Client(config_file="~/zuliprc-admin")

# Create a public data export of the organization.
result = client.call_endpoint(url="/export/realm", method="POST")
print(result)

curl -sSX POST https://echt-reu-23.zulipchat.com/api/v1/export/realm \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY \
    --data-urlencode export_type=2

Parameters

export_type integer optional

Example: 2

Whether to create a public or a standard data export.

  • 1 = Public data export.
  • 2 = Standard data export.

If not specified, defaults to 1.

Changes: New in Zulip 10.0 (feature level 304). Previously, all export requests were public data exports.

Must be one of: 1, 2. Defaults to 1.


Response

Return values

  • id: integer

    The ID of the data export created.

    Changes: New in Zulip 7.0 (feature level 182).

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:

{
    "id": 1,
    "msg": "",
    "result": "success"
}

An example JSON error response for when the data export exceeds the maximum allowed data export size.

{
    "code": "BAD_REQUEST",
    "msg": "Please request a manual export from zulip-admin@example.com.",
    "result": "error"
}