List linkifiers

List all of an organization's configured linkifiers, regular expression patterns that are automatically linkified when they appear in messages and topics.

GET https://yourZulipDomain.zulipchat.com/api/v1/realm/filters

Usage examples

#!/usr/bin/env python3

import zulip

# Pass the path to your zuliprc file here.
client = zulip.Client(config_file="~/zuliprc")

# Fetch all the filters in this organization
result = client.get_realm_filters()
print(result)

curl https://yourZulipDomain.zulipchat.com/api/v1/realm/filters \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY \

Arguments

This endpoint does not consume any arguments.

Response

Return values

  • filters: An array of tuples, each representing one of the linkifiers set up in the organization. Each of these tuples contain the pattern, the formatted URL and the filter's ID, in that order. See the Create linkifiers article for details on what each field means.

Example response

A typical successful JSON response may look like:

{
    "filters": [
        [
            "#(?P<id>[0-9]+)",
            "https://github.com/zulip/zulip/issues/%(id)s",
            1
        ]
    ],
    "msg": "",
    "result": "success"
}