---
title: "Start a new job."
method: POST
path: "/start/{identifier}/{version}"
---

# Start a new job.

`POST /start/{identifier}/{version}`

Starts a new asynchronous job for a specific Integration Flow.
The `identifier` is the unique ID of the Integration Flow, and `version` is its specific version.
This endpoint only accepts rules of type `IntegrationFlow`.

## Path parameters

- `identifier` string, required
- `version` string

## Request body

- object — A JSON object containing the input data for the job.

## Response `200`

Job started successfully.

- object
  - `jobId` string — The ID of the newly created job.
  - `status` JobStatus
    - `state` 'WAITING' | 'RUNNING' | 'COMPLETED' | 'CANCELING' | 'CANCELED' | 'ERROR'
    - `code` 'JOB_SUCCESS' | 'JOB_ERROR' | 'JOB_TIMEOUT' | 'JOB_QUOTA_EXCEEDED' | 'JOB_EXECUTION_ERROR' | 'JOB_VALIDATION_ERROR' | 'JOB_USER_CANCELED' | 'JOB_SYSTEM_CANCELED' | 'ZOMBIE_PROCESS' | 'JOB_INITIALIZED' | 'JOB_RUNNING' | 'JOB_WAITING'
    - `message` string — A human-readable message for the status.

## Other responses

- `400` — Business error.
- `401` — Unauthorized. Invalid or missing API key.

---

[API](https://skmtc.dev/decisionrules/apis/decisionrules-rule-solver-api.md) · [All operations](https://skmtc.dev/decisionrules/apis/decisionrules-rule-solver-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decisionrules/decisionrules-rule-solver-api/revisions/b50a7df65838/schema)