List runs for a Trigger

async AsyncCogniteClient.workflows.triggers.list_runs(
external_id: str,
limit: int | None = 25,
) → WorkflowTriggerRunList

List the history of runs for a trigger.

Parameters:

  • external_id (str) – The external id of the trigger to list runs for.

  • limit (int | None) – Maximum number of results to return. Defaults to 25. Set to -1, float(“inf”) or None to return all items.

Returns:

The requested trigger runs.

Return type:

WorkflowTriggerRunList

Examples

Get all runs for a trigger with external id ‘my_trigger’:

>>> from cognite.client import CogniteClient, AsyncCogniteClient
>>> client = CogniteClient()
>>> # async_client = AsyncCogniteClient()  # another option
>>> res = client.workflows.triggers.list_runs("my_trigger", limit=None)