Create a process

Creates a new process with the supplied source code and optional execution options. If autorun is true (the default), the process begins execution immediately.

POST /processes

Create a process

cURL

curl --request POST \
  --url http://localhost:9371/processes \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "ref": "<string>",
  "timeoutMs": 1,
  "envConfig": {},
  "autorun": true
}
'

201

{
  "id": 1
}

Body

application/json

Request body used to create a new process.

code · string · required

Executable source code to stage and run in the active environment (max 100 KB).

Maximum string length: 102400

ref · string

Optional reference label used for filtering and correlation.

Minimum string length: 1

timeoutMs · integer | null

API-level execution timeout in milliseconds. null disables enforcement; undefined uses the default.

Required range: x > 0

envConfig · object

Opaque per-execution environment configuration passed through to the environment module.

Show child attributes

autorun · boolean · default: true

Whether to start execution immediately. When false, the process is created in idle state and must be started via the run signal.

Response

201

application/json

Process created.

Response returned after a process is created.

id · integer · required

Stable process identifier assigned to the newly created process.

Required range: x > 0