Scripts

API Reference for ProcessMaker Script API

Returns all scripts categories that the user has access to

Display a listing of the Script Categories.

GET/api/1.0/script_categories

Query parameters

Response

200

list of scripts categories

Body

application/json

dataarray of ScriptCategory (all of)

metaobject

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script_categories', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "name": "text",
      "status": "ACTIVE",
      "id": "text",
      "created_at": "2024-12-21T12:25:51.794Z",
      "updated_at": "2024-12-21T12:25:51.794Z"
    }
  ]
}

Save a new Script Category

Store a newly created Script Category in storage

POST/api/1.0/script_categories

Body

application/json

namestring

Represents a business script category definition.

statusenum

ACTIVEINACTIVE

Response

201

success

Body

application/json

namestring

Represents a business script category definition.

statusenum

ACTIVEINACTIVE

idstring (id)

created_atstring (date-time)

updated_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script_categories', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2024-12-21T12:25:51.794Z",
  "updated_at": "2024-12-21T12:25:51.794Z"
}

Get single script category by ID

Display the specified script category.

GET/api/1.0/script_categories/{script_category_id}

Path parameters

script_category_id*string

ID of script category to return

Response

200

Successfully found the script

Body

application/json

namestring

Represents a business script category definition.

statusenum

ACTIVEINACTIVE

idstring (id)

created_atstring (date-time)

updated_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script_categories/{script_category_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2024-12-21T12:25:51.794Z",
  "updated_at": "2024-12-21T12:25:51.794Z"
}

Update a script Category

Updates the current element

PUT/api/1.0/script_categories/{script_category_id}

Path parameters

script_category_id*string

ID of script category to return

Body

application/json

namestring

Represents a business script category definition.

statusenum

ACTIVEINACTIVE

Response

200

success

Body

application/json

namestring

Represents a business script category definition.

statusenum

ACTIVEINACTIVE

idstring (id)

created_atstring (date-time)

updated_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script_categories/{script_category_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "name": "text",
  "status": "ACTIVE",
  "id": "text",
  "created_at": "2024-12-21T12:25:51.794Z",
  "updated_at": "2024-12-21T12:25:51.794Z"
}

Delete a script category

Remove the specified resource from storage.

DELETE/api/1.0/script_categories/{script_category_id}

Path parameters

script_category_id*string

ID of script category to return

Response

204

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script_categories/{script_category_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Returns all scripts that the user has access to

Get a list of scripts in a process.

GET/api/1.0/scripts

Query parameters

Response

200

list of scripts

Body

application/json

dataarray of scripts (all of)

metaobject

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "title": "text",
      "description": "text",
      "language": "text",
      "code": "text",
      "timeout": 0,
      "run_as_user_id": 0,
      "key": "text",
      "script_category_id": 0,
      "id": 0,
      "created_at": "2024-12-21T12:25:51.794Z",
      "updated_at": "2024-12-21T12:25:51.794Z"
    }
  ]
}

Save a new script

Create a new script in a process.

POST/api/1.0/scripts

Body

application/json

titlestring

Represents an Eloquent model of a Script

descriptionstring

languagestring

codestring

timeoutinteger

run_as_user_idinteger

keystring

script_category_idinteger

Response

201

success

Body

application/json

titlestring

Represents an Eloquent model of a Script

descriptionstring

languagestring

codestring

timeoutinteger

run_as_user_idinteger

keystring

script_category_idinteger

idinteger (id)

created_atstring (date-time)

updated_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201

{
  "title": "text",
  "description": "text",
  "language": "text",
  "code": "text",
  "timeout": 0,
  "run_as_user_id": 0,
  "key": "text",
  "script_category_id": 0,
  "id": 0,
  "created_at": "2024-12-21T12:25:51.794Z",
  "updated_at": "2024-12-21T12:25:51.794Z"
}

Test script code without saving it

Previews executing a script, with sample data/config data

POST/api/1.0/scripts/{script_id}/preview

Path parameters

script_id*integer

Body

application/json

dataarray of object

configarray of object

codestring

noncestring

Response

200

success if the script was queued

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts/{script_id}/preview', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Execute script

Executes a script, with sample data/config data

POST/api/1.0/scripts/execute/{script_id}

Path parameters

script_id*integer

Body

application/json

dataarray of object

configarray of object

Response

200

success if the script was queued

Body

application/json

statusstring

keystring

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts/execute/{script_id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "status": "text",
  "key": "text"
}

Get the response of a script execution by execution key

Get the response of a script execution

GET/api/1.0/scripts/execution/{key}

Path parameters

key*string

Response

200

response of a script execution

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts/execution/{key}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Get single script by ID

Get a single script in a process.

GET/api/1.0/scripts/{script_id}

Path parameters

script_id*string

ID of script to return

Response

200

Successfully found the script

Body

application/json

titlestring

Represents an Eloquent model of a Script

descriptionstring

languagestring

codestring

timeoutinteger

run_as_user_idinteger

keystring

script_category_idinteger

idinteger (id)

created_atstring (date-time)

updated_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts/{script_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "title": "text",
  "description": "text",
  "language": "text",
  "code": "text",
  "timeout": 0,
  "run_as_user_id": 0,
  "key": "text",
  "script_category_id": 0,
  "id": 0,
  "created_at": "2024-12-21T12:25:51.794Z",
  "updated_at": "2024-12-21T12:25:51.794Z"
}

Update a script

Update a script in a process.

PUT/api/1.0/scripts/{script_id}

Path parameters

script_id*string

ID of script to return

Body

application/json

titlestring

Represents an Eloquent model of a Script

descriptionstring

languagestring

codestring

timeoutinteger

run_as_user_idinteger

keystring

script_category_idinteger

Response

204

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts/{script_id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Delete a script

Delete a script in a process.

DELETE/api/1.0/scripts/{script_id}

Path parameters

script_id*string

ID of script to return

Response

204

success

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts/{script_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

duplicate a script

duplicate a Script.

PUT/api/1.0/scripts/{scripts_id}/duplicate

Path parameters

scripts_id*string

ID of script to return

Body

application/json

titlestring

Represents an Eloquent model of a Script

descriptionstring

languagestring

codestring

timeoutinteger

run_as_user_idinteger

keystring

script_category_idinteger

Response

201

success

Body

application/json

titlestring

Represents an Eloquent model of a Script

descriptionstring

languagestring

codestring

timeoutinteger

run_as_user_idinteger

keystring

script_category_idinteger

idinteger (id)

created_atstring (date-time)

updated_atstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/scripts/{scripts_id}/duplicate', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201

{
  "title": "text",
  "description": "text",
  "language": "text",
  "code": "text",
  "timeout": 0,
  "run_as_user_id": 0,
  "key": "text",
  "script_category_id": 0,
  "id": 0,
  "created_at": "2024-12-21T12:25:51.794Z",
  "updated_at": "2024-12-21T12:25:51.794Z"
}

Returns all script executors that the user has access to

Get a list of script executors.

GET/api/1.0/script-executors

Query parameters

Response

200

list of script executors

Body

application/json

dataarray of scriptExecutors (all of)

metaobject

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script-executors', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "title": "text",
      "description": "text",
      "language": "text",
      "config": "text",
      "id": 0,
      "created_at": "2024-12-21T12:25:51.794Z",
      "updated_at": "2024-12-21T12:25:51.794Z"
    }
  ]
}

Create a script executor

Create a script executor

POST/api/1.0/script-executors

Body

application/json

titlestring

Represents an Eloquent model of a Script Executor

descriptionstring

languagestring

configstring

Response

200

success

Body

application/json

statusstring

idstring

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script-executors', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "status": "text",
  "id": "text"
}

Update script executor

Update and rebuild the script executor

PUT/api/1.0/script-executors/{script_executor}

Path parameters

script_executor*string

ID of script executor to return

Body

application/json

titlestring

Represents an Eloquent model of a Script Executor

descriptionstring

languagestring

configstring

Response

200

success

Body

application/json

statusstring

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script-executors/{script_executor}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "status": "text"
}

Delete a script executor

Delete a script executor

DELETE/api/1.0/script-executors/{script_executor}

Path parameters

script_executor*string

ID of script executor to return

Response

200

success

Body

application/json

statusstring

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script-executors/{script_executor}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200

{
  "status": "text"
}

Cancel a script executor

Cancel a script executor

POST/api/1.0/script-executors/cancel

Body

application/json

pidFilestring

Response

200

success

Body

application/json

statusstring

idstring

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script-executors/cancel', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "status": "text",
  "id": "text"
}

Returns all available languages

Get a list of available languages.

GET/api/1.0/script-executors/available-languages

Query parameters

Response

200

list of available languages

Body

application/json

dataarray of availableLanguages (object)

metaobject

Request

JavaScriptCurlPython

const response = await fetch('/api/1.0/script-executors/available-languages', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "text": "text",
      "value": "text",
      "initDockerFile": "text"
    }
  ]
}