---
title: "Ejecutar Circuit"
url: https://docs.catalyst.zoho.com/es/api/code-reference/serverless/circuits/execute-circuit/
description: "Esta API te permite ejecutar un circuit de Catalyst configurado en la consola remota."
last_updated: 2026-03-20T16:21:56Z
service: Serverless
type: api
---

# Circuits

[Catalyst Circuits](https://docs.catalyst.zoho.com/es/serverless/help/circuits/introduction/) te permiten definir y organizar sistemáticamente una secuencia de tareas que se llevarán a cabo automáticamente en Catalyst. Puedes orquestar tareas y automatizar flujos de trabajo, y adicionalmente incluir condiciones, datos y rutas en el flujo de trabajo, para definir un patrón repetible de actividades que logre un resultado de negocio usando Circuits.

Catalyst ofrece soporte para automatizar la ejecución de funciones Basic I/O de tu aplicación usando un circuit.

> **Nota:** Circuits actualmente no está disponible para los usuarios de Catalyst que acceden desde los centros de datos de EU, AU, IN, JP, SA o CA.

# Ejecutar un Circuit

### Descripción

Esta API te permite ejecutar un circuit de Catalyst configurado en la consola referenciándolo por su Circuit ID único. Puedes pasar la entrada al circuit en el JSON de la solicitud como se describe a continuación.

> **Nota:** Puedes [crear, configurar y probar un circuit](https://docs.catalyst.zoho.com/es/serverless/help/circuits/implementation/#create-a-circuit) desde la consola de Catalyst.

### Detalles de la solicitud

#### URL de solicitud

`POST` {api-domain}/baas/v1/project/{project_id}/circuit/{circuit_id}/execute

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

- **circuit_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/serverless/help/circuits/implementation/#create-a-circuit) del circuit

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token}

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Alcance

ZohoCatalyst.circuits.EXECUTE

#### Formato JSON de la solicitud

Debes enviar la entrada al circuit como pares clave-valor en formato JSON de esta manera:

```json

{
"key_1": "value_1",
"key_2": "value_2",
"key_3": "value_3",
.
.
}

```

> **Nota:** La entrada del circuit no es obligatoria. Puedes omitir la entrada o pasarla según el propósito y la lógica de tu circuit.

### Detalles de la respuesta

La respuesta contiene el resultado y los detalles del circuit ejecutado, como el `circuit_name`, el `start_time` y `end_time` de la ejecución, el `instance_id`, junto con los detalles de la entrada que se pasó al circuit y la salida generada por la ejecución del circuit.

**Sample Request**

```bash
curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/circuit/105000000180234/execute \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-d '[
       { 
         "email":"j.parker@zylker.com",
         "count":"20",
         "traveller_type":"Single", 
         "rating":"5",
         "location":"New York",
         "suite":"Executive"
         }
      ]'

```

**Sample Response**

```json

    {
        "status": "success",
        "data": {
            "id": "b3c91799-5c18-4626-9983-a2d6af237e20",
            "name": "Case 1",
            "start_time": "Aug 24, 2020 02:24 PM",
            "end_time": "Aug 24, 2020 02:24 PM",
            "status": "success",
            "status_code": 6,
            "execution_meta": {},
            "circuit_details": {
                "name": "StayFinder",
                "ref_name": "StayFinder",
                "description": "",
                "instance_id": "ef9644a5-123a-438c-94d9-01b1bade8817"
            },
            "input": {
                "email":"j.parker@zylker.com",
                "count":"20",
                "traveller_type":"Single", 
                "rating":"5",
                "location":"New York",
                "suite":"Executive"
            },
            "output": {
                "result": {
                    "stay_list":{
                        "message":"Email has been sent successfully to j.parker@zylker.com",
                        "status":"success"
                    }
                }    
            }
        }
    }
```

### SDK Documentation

[Execute a Circuit- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/serverless/circuits/execute-circuit)</br></br>
[Execute a Circuit- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/serverless/circuits/execute-circuit)

[Execute a Circuit- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/serverless/circuits/execute-circuit)