---
title: "IDによるCircuitジョブの送信"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/job-scheduling/job/submit-job/submit-circuit-job/
description: "このAPIを使用すると、Circuitのエンドポイントをトリガーするジョブをジョブプールに送信できます。"
last_updated: 2026-02-23T12:39:41Z
service: Job Scheduling
type: api
---

# IDによるCircuitジョブの送信

### 説明

このAPIを使用すると、[Circuit](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/introduction/)のエンドポイントをトリガーするジョブをジョブプールに送信できます。

### リクエスト詳細

#### リクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/job_scheduling/job

- **project_id** (Numerical): [プロジェクトの一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 
**Content-Type:** application/json 

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.job.CREATE

#### リクエストJSON

以下に示す対応する値を含むJSONを送信する必要があります。

**サンプルペイロード**

```json

    {
    "source_type": "API",
    "job_config": {
        "number_of_retries": "4",
        "retry_interval": 300
    },
    "job_name": "circuitJob",
    "jobpool_id": "10108000003823699",
    "target_type": "Circuit",
    "target_id": "10108000004194246",
    "test_cases": {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3"
    }
    }

```

この**リクエストJSON**を**リクエストボディ**に設定し、以下の値を指定する必要があります：

- **request_method** ( , mandatory):  webhookがトリガーされるリクエストメソッドを示します。値は`get`、`post`、`put`、`delete`、`head`、または`patch`を指定できます。

- **source_type** ( , mandatory):  ジョブ送信APIの場合、常にAPIを値として含みます。

- **job_config** (JSON, mandatory):  `number_of_retries`と`retry_interval`のキーバリューペアが含まれます。失敗時のリトライアクションを決定します。

- **target_type** (String, mandatory):  ジョブがトリガーするターゲットタイプを示します。

- **jobpool_id** (Numerical, mandatory): ジョブを実行するジョブプールの[Job Pool ID](https://docs.catalyst.zoho.com/ja/job-scheduling/help/jobpool/key-concepts/#job-pool-id)が含まれます。

- **job_name** (String, mandatory):  トリガーするジョブの名前が含まれます。

- **target_id** (Number, mandatory):  ジョブがトリガーするCircuitの一意のIDが含まれます。

- **test_cases** (JSON, optional):  Circuitに入力する必要があるJSONのキーバリューペア入力が含まれます。

### レスポンス詳細
JSONレスポンスは、送信されたジョブのメタデータを返します。レスポンスには、ジョブを送信したユーザーの詳細も含まれます。

**リクエスト例**

```bash
curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/{project_id}/job_scheduling/job
-H "Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57" 
-H "Content-Type:application/json" 
 -\-data-raw '{"source_type":"API","job_config":{"number_of_retries":"4","retry_interval":300},"job_name":"circuitJob","jobpool_id":"10108000003823699","target_type":"Circuit","target_id":"10108000004194246","test_cases":{"key1":"value1","key2":"value2","key3":"value3"}}'

```

**レスポンス例**

```json

    {
    "status": "success",
    "data": {
        "job_id": "10108000004194251",
        "created_time": "Jun 05, 2024 04:56 PM",
        "response_code": null,
        "start_time": {},
        "end_time": {},
        "submitted_on": {
        "startTimeToRedirectLogsPage": "05/06/2024 16:51",
        "timeWithGivenTimezone": "Jun 05, 2024 04:56 PM IST",
        "timeWithJobTimezone": "Jun 05, 2024 04:56 PM IST"
        },
        "job_status": "PENDING",
        "capacity": {
        "number": "1"
        },
        "job_meta_details": {
        "id": "10108000004194252",
        "job_name": "circuitJob",
        "job_config": {
            "number_of_retries": 4,
            "retry_interval": 300
        },
        "target_type": "Circuit",
        "target_details": {
            "id": "10108000004194246",
            "target_name": "abc"
        },
        "source_type": "API",
        "source_details": {
            "source_name": "API"
        },
        "jobpool_id": "10108000003823699",
        "jobpool_details": {
            "type": "Circuit",
            "name": "InventoryDataMaintaince",
            "created_by": {
            "zuid": "77941453",
            "is_confirmed": false,
            "email_id": "emmy@zylker.com",
            "first_name": "Amelia Burrows",
            "last_name": "",
            "user_type": "Admin",
            "user_id": "10108000000009004"
            },
            "created_time": "May 28, 2024 04:49 PM",
            "modified_by": {
            "zuid": "77941453",
            "is_confirmed": false,
            "email_id": "emmy@zylker.com",
            "first_name": "Amelia Burrows",
            "last_name": "",
            "user_type": "Admin",
            "user_id": "10108000000009004"
            },
            "modified_time": "May 28, 2024 04:49 PM",
            "project_details": {
            "project_name": "ZylkerShipments",
            "id": "10108000003823392",
            "project_type": "Live"
            },
            "id": "10108000003823699"
        },
        "headers": {},
        "params": {
            "key1": "value1",
            "key2": "value2",
            "key3": "value3"
        }
        },
        "retried_count": null,
        "parent_job_id": "10108000004194251",
        "execution_time": null
    }
    }

```

### SDK Documentation

[Create Job- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/job-scheduling/jobs/create-job/)

[Create Job- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/job-scheduling/jobs/create-job/)

[Create Job- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/job-scheduling/jobs/create-job/)