Python SDKFeature Clients
Filters Client
Bases: BaseRestClient
The filters client is a client for interacting with Hatchet's filters API.
Methods:
| Name | Description |
|---|---|
aio_create | Create a new filter. |
aio_delete | Delete a filter by its ID. |
aio_get | Get a filter by its ID. |
aio_list | List filters for a given tenant. |
aio_update | Update a filter by its ID. |
create | Create a new filter. |
delete | Delete a filter by its ID. |
get | Get a filter by its ID. |
list | List filters for a given tenant. |
update | Update a filter by its ID. |
Functions
aio_create
Create a new filter.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
workflow_id | str | The ID of the workflow to associate with the filter. | required |
expression | str | The expression to evaluate for the filter. | required |
scope | str | The scope for the filter. | required |
payload | JSONSerializableMapping | None | The payload to send with the filter. | None |
Returns:
| Type | Description |
|---|---|
V1Filter | The created filter. |
aio_delete
Delete a filter by its ID.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter_id | str | The ID of the filter to delete. | required |
Returns:
| Type | Description |
|---|---|
V1Filter | The deleted filter. |
aio_get
Get a filter by its ID.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter_id | str | The ID of the filter to retrieve. | required |
Returns:
| Type | Description |
|---|---|
V1Filter | The filter with the specified ID. |
aio_list
List filters for a given tenant.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
limit | int | None | The maximum number of filters to return. | None |
offset | int | None | The number of filters to skip before starting to collect the result set. | None |
workflow_ids | list[str] | None | A list of workflow IDs to filter by. | None |
scopes | list[str] | None | A list of scopes to filter by. | None |
Returns:
| Type | Description |
|---|---|
V1FilterList | A list of filters matching the specified criteria. |
aio_update
Update a filter by its ID.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter_id | str | The ID of the filter to delete. | required |
updates | V1UpdateFilterRequest | The updates to apply to the filter. | required |
Returns:
| Type | Description |
|---|---|
V1Filter | The updated filter. |
create
Create a new filter.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
workflow_id | str | The ID of the workflow to associate with the filter. | required |
expression | str | The expression to evaluate for the filter. | required |
scope | str | The scope for the filter. | required |
payload | JSONSerializableMapping | None | The payload to send with the filter. | None |
Returns:
| Type | Description |
|---|---|
V1Filter | The created filter. |
delete
Delete a filter by its ID.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter_id | str | The ID of the filter to delete. | required |
Returns:
| Type | Description |
|---|---|
V1Filter | The deleted filter. |
get
Get a filter by its ID.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter_id | str | The ID of the filter to retrieve. | required |
Returns:
| Type | Description |
|---|---|
V1Filter | The filter with the specified ID. |
list
List filters for a given tenant.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
limit | int | None | The maximum number of filters to return. | None |
offset | int | None | The number of filters to skip before starting to collect the result set. | None |
workflow_ids | list[str] | None | A list of workflow IDs to filter by. | None |
scopes | list[str] | None | A list of scopes to filter by. | None |
Returns:
| Type | Description |
|---|---|
V1FilterList | A list of filters matching the specified criteria. |
update
Update a filter by its ID.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter_id | str | The ID of the filter to delete. | required |
updates | V1UpdateFilterRequest | The updates to apply to the filter. | required |
Returns:
| Type | Description |
|---|---|
V1Filter | The updated filter. |
Last updated on September 1, 2026