Get 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://zulip.schiffrin-zulip.cloud.edu.au/api/v1/realm/linkifiers

Changes: New in Zulip 4.0 (feature level 54). On older versions, a similar GET /realm/filters endpoint was available with each entry in a [pattern, url_format, id] tuple format.

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.call_endpoint(
    url="/realm/linkifiers",
    method="GET",
)
print(result)

curl -sSX GET -G https://zulip.schiffrin-zulip.cloud.edu.au/api/v1/realm/linkifiers \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY

Parameters

This endpoint does not accept any parameters.

Response

Return values

  • linkifiers: (object)[]

    An array of objects, where each object describes a linkifier.

    • pattern: string

      The string regex pattern which represents the pattern that should be linkified by this linkifier.

    • url_format: string

      The URL format string to be used for linkifying matches.

    • id: integer

      The ID of the linkifier.

Example response

A typical successful JSON response may look like:

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