---
id: workflow-plugin-list
title: "List plugins"
description: "Lists the plugin descriptors available on the engine, paginated and filterable."
sidebar_label: "List plugins"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/workflows
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List plugins"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/workflows/plugins"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists the plugin descriptors available on the engine, paginated and filterable.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"type","schema":{"type":"string","enum":["trigger","module","decider"]},"description":"Only plugins of this type."},{"in":"query","name":"q","schema":{"type":"string"},"description":"Case-insensitive search over name, description, category, and tags.","example":"slack"},{"in":"query","name":"limit","schema":{"type":"integer","default":50,"maximum":500},"description":"The maximum number of results per page (clamped to 500).","example":50},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination.","example":0}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The paginated plugin descriptors.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"title":"PluginDescriptor","type":"object","required":["name","version","pluginType","description","configSchema"],"properties":{"name":{"type":"string","example":"http-request"},"version":{"type":"string","example":"1.0.0"},"pluginType":{"type":"string","enum":["trigger","module","decider"]},"description":{"type":"string"},"category":{"type":"string","example":"integrations"},"tags":{"type":"array","items":{"type":"string"}},"configSchema":{"type":"object","description":"JSON Schema for the step's `config` block."},"inputSchema":{"type":"object"},"outputSchema":{"type":"object"},"executeMode":{"type":"string","enum":["each","all"],"description":"Whether the plugin runs once per input item (`each`, the default) or once with the whole batch (`all`)."},"capabilities":{"type":"array","items":{"type":"string"},"example":["produces-items","idempotent"]},"examples":{"type":"array","items":{"type":"object"}},"documentation":{"type":"string","description":"Markdown documentation or a URL."}},"additionalProperties":true}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}},"4XX":{"description":"Client error. The body says what went wrong: an error `type`, a human-readable `detail`, and, on validation failures, one entry per offending field.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}},"5XX":{"description":"Unexpected server error.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}}}}
>
  
</StatusCodes>