# Create Process

Creates custom processes with given arguments

About

Create Process endpoint creates a custom process with specified execution parameters. You can create a process by defining its path, arguments, execution type, and various configuration options. Processes are fundamental building blocks that can be used in actions and threat scenarios.

  • Process path and arguments define the executable and its parameters
  • Process type determines execution behavior (play or rewind)
  • Timeout and delay settings control execution timing
  • File associations and output handling provide additional functionality

Example for Basic Process Creation

Create a simple process with basic execution parameters.

curl --location 'https://api.picussecurity.com/v1/threat-library/processes' \
--header 'Authorization: Bearer access_token' \
--header 'Content-Type: application/json' \
--data '{
    "argument": "argument",
    "path": "path",
    "comment": "comment",
    "delay": 0,
    "timeout": 120000,
    "process_type": "play",
    "is_async": false,
    "success_cond_exist": false,
    "is_blocked": false,
    "output": "",
    "code": 0
}'
{
    "process": {
        "id": 1016265,
        "created_at": "2025-06-24T08:06:59.208273422Z",
        "path": "path",
        "argument": ""
    }
}

Fields

Field NameRequiredTypeConstraintsDefault ValueOptions/ExamplesDescription
process_type✅ YesStringMust be one of the options-"play" (Standard execution process), "rewind" (Cleanup/rollback process)Defines the execution behavior of the process
is_async✅ YesBoolean-falsetrue (Process runs in background without blocking), false (Process runs synchronously and blocks execution)Determines if the process should run asynchronously
argument❌ NoString--Command line parametersCommand line arguments to pass to the process
path❌ NoString--File or executable pathsFile path or executable path for the process
comment❌ NoString---Optional comment providing detailed information about the process's purpose, behavior, or execution methodology
delay❌ NoInteger-0Time in millisecondsDelay in milliseconds before process execution starts
timeout❌ NoInteger-120000Time in milliseconds (120000 = 2 minutes)Maximum execution time in milliseconds before process is terminated
success_condition_exist❌ NoBoolean-falsetrue (Has custom conditions), false (No custom conditions)Whether the process has custom success conditions defined
is_blocked❌ NoBoolean-falsetrue (Execution blocked), false (Execution allowed)Whether the process execution should be blocked/prevented
output❌ NoString--Expected or captured textExpected or captured output from the process
code❌ NoInteger-0Exit codes (0 = success)Expected exit code for successful process executio
Language
Credentials
Header
Click Try It! to start a request and see the response here!