zulip/templates/zerver/api/typing.md

Set "typing" status

Send an event indicating that the user has started or stopped typing on their client. See the typing notification docs for details on Zulip's typing notifications protocol.

POST {{ api_url }}/v1/typing

Usage examples

{start_tabs} {tab|python}

{generate_code_example(python)|/typing:post|example}

{tab|js}

More examples and documentation can be found here.

const zulip = require('zulip-js');

// Download zuliprc-dev from your dev server
const config = {
    zuliprc: 'zuliprc-dev',
};

const typingParams = {
    op: 'start',
    to: ['iago@zulip.com', 'polonius@zulip.com'],
};

zulip(config).then((client) => {
    // The user has started to type in the group PM with Iago and Polonius
    return client.typing.send(typingParams);
}).then(console.log);

{tab|curl}

curl -X POST {{ api_url }}/v1/typing \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY \
    -d "op=start" \
    -d 'to="iago@zulip.com","polonius@zulip.com"'

{end_tabs}

Arguments

{generate_api_arguments_table|zulip.yaml|/typing:post}

Response

Example response

A typical successful JSON response may look like:

{generate_code_example|/typing:post|fixture(200)}