---
title: "Execute Circuit"
url: https://docs.catalyst.zoho.com/en/sdk/python/v1/serverless/circuits/execute-circuit/
description: "This page describes the method to make use of circuits to organize and orchestrate tasks in your Python application with sample code snippets."
last_updated: 2025-11-19T15:07:41Z
service: Serverless
type: general
related_links:
  - name: "Execute Circuit - API"
    url: /en/api/code-reference/serverless/circuits/execute-circuit/#ExecuteCircuit
  - name: "Circuits Help"
    url: /en/serverless/help/circuits/introduction
  - name: "SDK Scopes"
    url: /en/sdk/python/v1/sdk-scopes
---

### Execute a Circuit

The sample code below illustrates executing a circuit by referring to its unique circuit ID and passing key-value pairs as the input to the circuit in the form of a dictionary. 

To know more about the component instance `circuit_service` used below, please refer to [this help section](https://docs.catalyst.zoho.com/en/sdk/python/v1/serverless/circuits/get-component-instance/).

**Parameters Used**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Parameter Name</th>
      <th class="w20p">Data Type</th>
      <th class="w60p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`circuit ID`</td>
      <td>Numeric</td>
			<td>A **Mandatory** parameter. Will store the unique ID the circuit to be executed.</td>
		</tr>
    <tr>
			<td>`circuit input`</td>
      <td>Object</td>
			<td>A **Mandatory** parameter. Will store the dictionary that contains the input to the cricut.</td>
		</tr>
	</tbody>
</table>

```python
#Execute a circuit
circuit = app.circuit()
result = circuit.execute(5249000000108030, name="Test_Circuit")

```

A sample response is shown below :

```json
{
   "id":"5249000000108030",
   "name":"Test_Circuit",
   "start_time":"Aug 18, 2021 07:35 PM",
   "status":"running",
   "status_code":1,
   "execution_meta":{
      
   },
   "circuit_details":{
      "name":"Test_Circuit",
      "ref_name":"testcircuit",
      "description":"",
      "instance_id":"70454fc5-3bf6-45af-81ca-2742cc049698"
   },
   "input":{
      "name":"Aaron Jones"
   }
}

```

> **Info :** Refer to the [SDK Scopes table](https://docs.catalyst.zoho.com/en/sdk/python/v1/sdk-scopes) to determine the required permission level for performing the above operation.