> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing triggers

> List, enable, disable, and delete trigger instances

After a trigger is created, you manage it over its lifecycle: list active instances, pause one with `disable()`, bring it back with `enable()`, or remove it for good with `delete()`.

## Listing active triggers

List the trigger instances you've created. Results are cursor-paginated.

> [tab] Python
>
> ```python theme={null}
> from composio import Composio
>
> composio = Composio()
>
> active = composio.triggers.list_active(
>     connected_account_ids=["ca_def456"],
> )
>
> for trigger in active.items:
>     print(f"{trigger.id} ({trigger.trigger_name}) - disabled: {trigger.disabled_at is not None}")
>
> # Paginate with cursor
> if active.next_cursor:
>     next_page = composio.triggers.list_active(
>         connected_account_ids=["ca_def456"],
>         cursor=active.next_cursor,
>     )
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
>
> const composio = new Composio();
>
> const active = await composio.triggers.listActive({
>   connectedAccountIds: ['ca_def456'],
> });
>
> for (const trigger of active.items) {
>   console.log(`${trigger.id} (${trigger.triggerName}) - disabled: ${trigger.disabledAt !== null}`);
> }
>
> // Paginate with cursor
> if (active.nextCursor) {
>   const nextPage = await composio.triggers.listActive({
>     connectedAccountIds: ['ca_def456'],
>     cursor: active.nextCursor,
>   });
> }
> ```

> [tab] API
>
> ```bash theme={null}
> RESPONSE=$(curl -s -X GET "https://backend.composio.dev/api/v3.1/trigger_instances/active?connected_account_ids=ca_def456" \
>   -H "x-api-key: $COMPOSIO_API_KEY")
> echo "$RESPONSE" | jq -r '.items[] | "\(.id) (\(.trigger_name)) - disabled: \(.disabled_at != null)"'
> NEXT_CURSOR=$(echo "$RESPONSE" | jq -r '.next_cursor // empty')
>
> # Fetch another page only when the response supplies a cursor.
> if [ -n "$NEXT_CURSOR" ]; then
>   curl -X GET "https://backend.composio.dev/api/v3.1/trigger_instances/active?connected_account_ids=ca_def456&cursor=$NEXT_CURSOR" \
>     -H "x-api-key: $COMPOSIO_API_KEY"
> fi
> ```

| Filter | Description |
| - | - |
| `connected_account_ids` / `connectedAccountIds` | Array of connected account IDs |
| `trigger_ids` / `triggerIds` | Array of trigger instance IDs |
| `trigger_names` / `triggerNames` | Array of trigger type slugs |
| `auth_config_ids` / `authConfigIds` | Array of auth config IDs |
| `show_disabled` / `showDisabled` | Include disabled triggers (default: `false`) |

Keep the same filters on every page. To find paused instances after reconnecting an account, include `show_disabled=True` in Python or `showDisabled: true` in TypeScript.

## Enable / Disable triggers

Pause a trigger temporarily without deleting it:

> [tab] Python
>
> ```python theme={null}
> # Disable a trigger
> composio.triggers.disable(trigger_id="ti_abcd123")
>
> # Re-enable when needed
> composio.triggers.enable(trigger_id="ti_abcd123")
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
> const composio = new Composio();
> // Disable a trigger
> await composio.triggers.disable('ti_abcd123');
>
> // Re-enable when needed
> await composio.triggers.enable('ti_abcd123');
> ```

> [tab] API
>
> ```bash theme={null}
> # Disable a trigger
> curl -X PATCH https://backend.composio.dev/api/v3.1/trigger_instances/manage/ti_abcd123 \
>   -H "x-api-key: $COMPOSIO_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{"status": "disable"}'
>
> # Re-enable when needed
> curl -X PATCH https://backend.composio.dev/api/v3.1/trigger_instances/manage/ti_abcd123 \
>   -H "x-api-key: $COMPOSIO_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{"status": "enable"}'
> ```

## Deleting triggers

Permanently remove a trigger instance:

> [tab] Python
>
> ```python theme={null}
> composio.triggers.delete(trigger_id="ti_abcd123")
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
> const composio = new Composio();
> await composio.triggers.delete('ti_abcd123');
> ```

> [tab] API
>
> ```bash theme={null}
> curl -X DELETE https://backend.composio.dev/api/v3.1/trigger_instances/manage/ti_abcd123 \
>   -H "x-api-key: $COMPOSIO_API_KEY"
> ```

> [!WARNING]
>
> Deleting a trigger is permanent. Use `disable()` instead to temporarily stop receiving events.

If an enabled trigger isn't delivering events, follow [Troubleshooting triggers](https://composio-preview.mintlify.site/docs/setting-up-triggers/troubleshooting.md).
