---
title: "Client"
description: "This page lists the Python SDK names for the Client."
canonical_url: "https://docs.superdurable.io/reference/python/client/"
source: "docs/reference/python/client.mdx"
locale: "en"
---

# Client

This page lists the Python SDK names for the [Client](https://docs.superdurable.io/concepts/client.md).
The doc comment of each API gives its parameters, defaults, and errors. Read
them in the [Python SDK API reference](https://docs.superdurable.io/reference/python.md#api-reference).

<a id="api-names"></a>

## API names

| Task                                  | Python API                                                                            | Dex behavior                                                                                                               |
| ------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Create a Client                       | **Client** for blocking calls, or **AsyncClient** for asyncio, with **ClientOptions** | [Client requests](https://docs.superdurable.io/reference/server/runtime-client.md)                                         |
| Start a Flow                          | **start_flow**, with **StartFlowOptions**                                             | [Start a Flow](https://docs.superdurable.io/reference/server/runtime-client.md#start-a-flow)                               |
| Invoke an RPC                         | **invoke_rpc**                                                                        | [Invoke an RPC](https://docs.superdurable.io/reference/server/runtime-client.md#invoke-an-rpc)                             |
| Read Attributes                       | **get_attributes**                                                                    | [Read Attributes](https://docs.superdurable.io/reference/server/runtime-client.md#read-attributes)                         |
| Wait for a Flow to close              | **wait_for_flow**                                                                     | [Wait for a Flow](https://docs.superdurable.io/reference/server/runtime-client.md#wait-for-a-flow)                         |
| Wait for a Step execution to complete | **wait_for_step_completion**, with **WaitForStepCompletionOptions**                   | [Wait for a Step](https://docs.superdurable.io/reference/server/runtime-client.md#wait-for-a-step)                         |
| Wait until an Attribute matches       | **wait_for_attribute_match**, with **WaitForAttributeOptions**                        | [Wait for an Attribute match](https://docs.superdurable.io/reference/server/runtime-client.md#wait-for-an-attribute-match) |
| Describe a Flow                       | **describe_flow**                                                                     | [Describe a Flow](https://docs.superdurable.io/reference/server/runtime-client.md#describe-a-flow)                         |
| Search Flows                          | **search_flows**                                                                      | [Search Flows](https://docs.superdurable.io/reference/server/runtime-client.md#search-flows)                               |
| Stop a Flow                           | **stop_flow**, with **StopFlowOptions**                                               | [Stop a Flow](https://docs.superdurable.io/reference/server/runtime-client.md#stop-a-flow)                                 |
| Skip a Timer                          | **skip_timer**                                                                        | [Skip a Timer](https://docs.superdurable.io/reference/server/runtime-client.md#skip-a-timer)                               |
| Update FlowConfig                     | **update_flow_config**                                                                | [Update FlowConfig](https://docs.superdurable.io/reference/python/flow.md#update-flow-config-with-a-client)                |
| Write and read a Stream               | **write_stream**, **read_stream**, and **list_stream_messages**                       | [Stream](https://docs.superdurable.io/reference/python/stream.md)                                                          |
| Time travel a Flow                    | **time_travel**, with **TimeTravelOptions**                                           | [Time travel](https://docs.superdurable.io/reference/server/runtime-client.md#time-travel)                                 |
| Upload Flow definitions               | **upload_flow_definitions**, with **FlowDefinitionDocument**. Since 1.45              | [Flow definitions](https://docs.superdurable.io/reference/python/workers.md#flow-definitions)                              |
| Handle a failed request               | **DexServiceError**, with **ErrorSubStatus**                                          | [Client requests](https://docs.superdurable.io/reference/server/runtime-client.md)                                         |

**AsyncClient** has the same methods as **Client**. Each one is a coroutine.

<a id="example"></a>

## Example

Example: [examples/python/dex_examples/primitives/client-apis/controller.py](https://github.com/superdurable/dex/tree/main/examples/python/dex_examples/primitives/client-apis/controller.py)