Get the organization's plugins

GET https://runix.chat/api/v1/armada/plugins

Get the plugins installed in the organization, with those removed less than a week ago, whose removal can still be undone.

A plugin's secrets are never included: only whether each is set, who set it and when, and the last four characters of a long one.

Guests and bots cannot use this endpoint.

Changes: New in Zulip 13.0 (feature level ZF-0be29a).

Usage examples

curl -sSX GET -G https://runix.chat/api/v1/armada/plugins \
    -u EMAIL_ADDRESS:API_KEY

Parameters

This endpoint does not accept any parameters.

Response

Return values

• plugins: (object)[]

  The organization's plugins, oldest first.

  • id: integer

    The ID of the install.

  • plugin: string

    The plugin's ID, from its manifest.

  • name: string

    The plugin's name, which its bot is named after.

  • version: string

    The plugin's version at the pinned commit.

  • source_kind: string

    Where its code comes from: a repository on GitHub, a repository on this server (the team's plugins repository), or nowhere here, for a plugin its author runs as a service.

  • source: string

    For github, its repository, as github.com/<owner>/<repository>; for remote, its service's address; otherwise empty.

  • source_repository_id: integer | null

    For local, the ID of this server's repository it comes from.

  • source_path: string

    Its directory in its repository, such as plugins/eval-queue, or empty for the repository's root.

  • sha: string

    The commit it is pinned at; empty for remote.

  • manifest: object

    The plugin's manifest at that commit.

  • state: string

    Waiting while a required setting or secret is missing; starting until its process answers; running; failed after five failures in a row; removed for a week, while the removal can be undone; a draft while the agent makes it, seen only by the person it is made for.

  • detail: string

    While waiting, the required settings and secrets that are missing; when failed, the last lines its process wrote.

  • bot_user_id: integer

    The ID of the plugin's own bot.

  • installed_by: integer | null

    The ID of the user it was installed for, by hand or by the agent.

  • made_by: integer | null

    The ID of the user who asked the agent to make it, or null for a plugin from the store.

  • made_by_run_id: integer | null

    The ID of the agent run that made it.

  • made_in_stream_id: integer | null

    The ID of the channel where it was asked for.

  • made_in_topic: string | null

    The topic where it was asked for.

  • made_in_message_id: integer | null

    The ID of the message that asked for it.

  • settings: object

    Its settings, whole, as its manifest's form describes them.

  • secrets: (object)[]

    The secrets its manifest asks for, and whether each is set.

    • name: string

      The secret's name in the manifest.

    • title: string

      What the manifest calls it.

    • required: boolean

      Whether the plugin waits until it is set.

    • set: boolean

      Whether it is set.

    • hint: string

      The last four characters of a secret of 16 characters or more; otherwise empty.

    • set_by: integer | null

      The ID of the user who set it.

    • date_set: integer | null

      When it was set, as a UNIX timestamp in UTC seconds.

  • links: (object)[]

    Where it is linked.

    • id: integer

      The ID of the link.

    • kind: string

      The kind of link, as the manifest names it.

    • value: string

      The value linked, such as a project.

    • stream_id: integer

      The ID of the channel.

    • topic: string | null

      The topic, or null for the whole channel.

  • disabled: boolean

    Whether it is turned off.

  • widget_defaults: object

    The team's default for each of its widgets, by the widget's key. A person may still show, hide or move a widget for themselves.

    • One widget's default.

      • nav: string

        Shown in everyone's nav, offered in its "+" menu, or not in the nav.

      • column: boolean

        Whether its list shows in the column of linked places.

  • disabled_tools: (string)[]

    Its tools the agent may not use.

  • date_installed: integer

    When it was installed, as a UNIX timestamp in UTC seconds.

  • date_removed: integer | null

    When it was removed, or null.

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:

{
    "msg": "",
    "plugins": [],
    "result": "success"
}