---
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: >-
  eJztWN9vGzcM/lcEvTTFLrY3NOjgt65rhw79EbQJUiAwZvrE86nRSReJZ8cw/L8PlGznbF+cbu2APbQvqU8U+ZEiP4lcSoJpkMNreeX8TWHcXNSmmWob5CiTCkPudU3aWTmUb3WgIKjEtYjYLDsfBMxAG5gYFM5GGbRTbTETNUy1BUIlwCpRaEPoWa4nM+lq9MDa3yg5lPM1gtOkfmh0IJnJGjxUSOgZ5lJqhnLboF/ITFqoUA4lLWqUmQx5iRXI4TJ9GMpAXtupzCTapmInyevpFL3MZOVUY3iTwlwr9HK02vf3gzWLTTSEKwSVOgjW3JOrrBvI7REUB/pfQsBTbQPaoEnPUAQEn5fCzdALVpiJ1oZM5EA4dX6RxUjyuXEM8Q6q2kQ7BvKbB6EZXWnqgqctYYqJwgIaQ3J4NshkBXe64qidDQYH0C9KFGsBYZtqgp4D5DE0hoKo0fOxozjJDVQ1KkFOnA0GT3fwng0eguqKIuAjWCttE7xBC3c30EDgSdupqJ22JArnN0mpnd2BNFiNMhkwb7ymRcy2CYJH/6KhUg6vR7zsMdTOBgwM65fBgP8c2rzP+sNaYZO5s4SWeDPUtdF5BNP/EljD8tBxN/mCeawGz0VDOtlXQG0p8B44jpqwiuukKabGeQTx+xaDzA4Ue7xttEfFZRLPIZMz9IFdymRy4iKVWdvb6Emhp58S4NE+wHSiHQW5zdqSqD5l4xiIa2Rj9Oimn3uD3oClW8C+U9l3lO2m8I5jirmZ6CzwrkSsR85m18xqL5QdZ7+bZn9++vBeJOGY0xRTHesnQYyTprGYGJffMF1JbeuGHlK9yqRr6LgA3mHeEL5z6mioEfJSZhKMObxArkqkEn37CvENc6vNMZJGBCk4QuJkzJrGWRReF/hT4XwSnmsq48q8dAbFBCgvxckYjBk/7aUjq2Gijd7k4VceQus8rzmTVZNjOE3SmdQKq9rFuh3di36N/k0YOdlc3lRoCbrTbT9m78DfKDe3YmcfBwLE5ce3vagTlNL8Gcx5q/rIN8ir5AhMB4musvWl0Lm0JuGOtfgvk88+fz7kvpdGoyWB3jvfE8yEE6cWIsAiiHkJJOa8PPfOTocCbBIUYzYxzgSIsqnAnnoEFd8SY4UE2ozjlZfx02IGRqsUgwK0aTwG/s7vDfKLmEWuKNAqJvxCo1FH6Lb2bmKw+qmDdjfEmSQ6+LLznrEKvFo7FR0/+fj6pXj+6+C5WNsSyaOQiYB+xq+iIMYPYRrHG3OXUekBrtvF8ypCYBlx+fFNJrA37Ykxc20Y9vvbl1ZYBMKqp3DWj6DD/ZJ1dFq4xqpx74Cv/7GOyIcppMco9L3j63ktHwioCR0J2NrxbPAs8jeH9DHVYgMrsYdWYl78pYur3yZXRd1MB1bgHb9wE1vyYeaPwN06GvoKC21jDYb+ntrIKjEwHUSxe2rnHgPXR3eeDx/P8wd4Zz+HauD3zFHX+CYJ/ZCD7afLhN2oMASYPhKVqgkkSpih2DwpxNr6QjzJncInawqJLHLWxSKXFu9qzPn5FKvErwnlRyX/qOQflfy/rOSok0rHjfwUU9/O0Nqh3UwWuMfiqk4NfeNNKxmh1j3bGFMboML5qpe7SrbbsvhETc63m7OtH6xo0zry7yQks/V/XjtfAfHz+eoivp20LRxv3/Yd6+Zim+byfQuOeHH+JvYdLlAF9r7FidMRce/hXk+xpa3/YIqydpzwjvq1AR3zNEZ1kx/X29lK2DZzccBTukC8vFxOIOClN6sVf079OB+O0oHNKDkswAQ84teRackDEG9wcT+7mYFpWCTOL77e6veZoRyBd/vvsX3DkOQIoM0c5xtAPToQOWJ+O5u5tz/iH14zgDgkyWSJwL01J1Da9SLPsW7vOhh6sJYtgfzx6oJ7yN3C3ivkqH3DwXbR0r1cJokLd4N2tZLbTOPfcjVarVZ/AxzQSzI=
sidebar_class_name: get api-method
info_path: docs/api/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-plugin-list'
---
<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>