Processes

Get list of processes

get

Responses

200

Success

application/json

ownerstringRequired

Owner ID

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

updatedAtstringRequired

Date and time when the data was last updated

Example: 2024-01-11T06:07:04.182Z

updatedBystringRequired

ID of the user who last updated the data

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

privacystringRequired

Privacy setting

Example: none

reminderstring[]Required

List of reminders

createdAtstringRequired

Date and time when the data was created

Example: 2023-10-10T05:52:28.348Z

membersstring[]Required

List of members

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42"]

idintegerRequired

ID of the data

Example: 33

filesobject[]Required

List of files

privacySettingsobjectRequired

Privacy settings information

draftbooleanRequired

Flag indicating if the data is a draft

Example: false

numberingSchemestringRequired

Numbering scheme for the data

Example: Approval Test ###

creatorstringRequired

Creator ID

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

notificationGroupsobject[]Required

List of notification groups

addressstringRequired

Address information

Example: approval-test

layoutobjectRequired

Layout information

activeCountintegerRequired

Active count value

Example: 39

titlestringRequired

Title of the data

Example: Approval Test

deletedbooleanRequired

Flag indicating if the data is deleted

Example: false

processOwnersstring[]Required

List of process owners

invocationCountintegerRequired

Invocation count value

Example: 59

groupsstring[]Required

List of groups

orgIdintegerRequired

Organization ID

Example: 1

descriptionstringRequired

Description of the data

Example: New Process

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

get

/workflow

GET /workflow HTTP/1.1
Accept: */*

[
  {
    "owner": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "updatedAt": "2024-01-11T06:07:04.182Z",
    "updatedBy": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "checklistFields": [
      {
        "attrs": "{\"~#text\":{\"label\":\"ENTER YOUR NAME\",\"autoCheck\":false,\"settings\":\"{\\\"multiline\\\":true}\"}}",
        "config": {
          "label": "ENTER YOUR NAME",
          "settings": {
            "multiline": true
          },
          "autoCheck": false
        },
        "promptRules": {
          "roles": [],
          "users": []
        },
        "id": 73,
        "seqNo": 0,
        "deletedAt": "2024-01-11T06:07:04.182Z",
        "layout": {},
        "deletedBy": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
        "deleted": true,
        "target": false,
        "hidden": false,
        "fieldType": "text"
      }
    ],
    "privacy": "none",
    "reminder": [
      "text"
    ],
    "createdAt": "2023-10-10T05:52:28.348Z",
    "settings": {
      "allowArchive": true,
      "nextCount": 2,
      "dueIn": "2023-11-10T05:52:28.348Z",
      "senderNotParticipant": false,
      "creatorIsParticipant": true,
      "noConfirmation": false,
      "creatorIsOwner": true,
      "hideAutoNumber": false,
      "statusDisabled": false
    },
    "members": [
      "Q79THCOJ5CcvWRMPeIVZiq1ezu42"
    ],
    "id": 33,
    "files": [
      {}
    ],
    "privacySettings": {},
    "draft": false,
    "numberingScheme": "Approval Test ###",
    "creator": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "notificationGroups": [
      {}
    ],
    "address": "approval-test",
    "status": [
      {
        "title": "Approved",
        "id": 6,
        "active": false,
        "seqNo": 3,
        "locked": false,
        "settings": {
          "archiveMode": "ignore"
        },
        "rules": {
          "id": 213,
          "entity": "status",
          "entityId": 6,
          "field": "text",
          "blocks": [
            {}
          ],
          "defaultBehavior": {
            "state": "enabled",
            "tooltip": ""
          }
        }
      }
    ],
    "layout": {},
    "checklists": [
      {
        "description": "text",
        "checklistId": 1
      }
    ],
    "activeCount": 39,
    "title": "Approval Test",
    "deleted": false,
    "processOwners": [
      "text"
    ],
    "invocationCount": 59,
    "groups": [
      "text"
    ],
    "orgId": 1,
    "description": "New Process"
  }
]

Get process settings

get

Path parameters

idintegerRequired

ID of the workflow

Example: 13

Responses

200

Success

application/json

ownerstringRequired

Owner ID

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

updatedAtstringRequired

Date and time when the data was last updated

Example: 2024-01-11T06:07:04.182Z

updatedBystringRequired

ID of the user who last updated the data

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

privacystringRequired

Privacy setting

Example: none

reminderstring[]Required

List of reminders

createdAtstringRequired

Date and time when the data was created

Example: 2023-10-10T05:52:28.348Z

membersstring[]Required

List of members

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42"]

idintegerRequired

ID of the data

Example: 33

filesobject[]Required

List of files

privacySettingsobjectRequired

Privacy settings information

draftbooleanRequired

Flag indicating if the data is a draft

Example: false

numberingSchemestringRequired

Numbering scheme for the data

Example: Approval Test ###

creatorstringRequired

Creator ID

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

notificationGroupsobject[]Required

List of notification groups

addressstringRequired

Address information

Example: approval-test

layoutobjectRequired

Layout information

activeCountintegerRequired

Active count value

Example: 39

titlestringRequired

Title of the data

Example: Approval Test

deletedbooleanRequired

Flag indicating if the data is deleted

Example: false

processOwnersstring[]Required

List of process owners

invocationCountintegerRequired

Invocation count value

Example: 59

groupsstring[]Required

List of groups

orgIdintegerRequired

Organization ID

Example: 1

descriptionstringRequired

Description of the data

Example: New Process

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

get

/workflow/{id}

GET /workflow/{id} HTTP/1.1
Accept: */*

{
  "owner": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "updatedAt": "2024-01-11T06:07:04.182Z",
  "updatedBy": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "checklistFields": [
    {
      "attrs": "{\"~#text\":{\"label\":\"ENTER YOUR NAME\",\"autoCheck\":false,\"settings\":\"{\\\"multiline\\\":true}\"}}",
      "config": {
        "label": "ENTER YOUR NAME",
        "settings": {
          "multiline": true
        },
        "autoCheck": false
      },
      "promptRules": {
        "roles": [],
        "users": []
      },
      "id": 73,
      "seqNo": 0,
      "deletedAt": "2024-01-11T06:07:04.182Z",
      "layout": {},
      "deletedBy": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
      "deleted": true,
      "target": false,
      "hidden": false,
      "fieldType": "text"
    }
  ],
  "privacy": "none",
  "reminder": [
    "text"
  ],
  "createdAt": "2023-10-10T05:52:28.348Z",
  "settings": {
    "allowArchive": true,
    "nextCount": 2,
    "dueIn": "2023-11-10T05:52:28.348Z",
    "senderNotParticipant": false,
    "creatorIsParticipant": true,
    "noConfirmation": false,
    "creatorIsOwner": true,
    "hideAutoNumber": false,
    "statusDisabled": false
  },
  "members": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42"
  ],
  "id": 33,
  "files": [
    {}
  ],
  "privacySettings": {},
  "draft": false,
  "numberingScheme": "Approval Test ###",
  "creator": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "notificationGroups": [
    {}
  ],
  "address": "approval-test",
  "status": [
    {
      "title": "Approved",
      "id": 6,
      "active": false,
      "seqNo": 3,
      "locked": false,
      "settings": {
        "archiveMode": "ignore"
      },
      "rules": {
        "id": 213,
        "entity": "status",
        "entityId": 6,
        "field": "text",
        "blocks": [
          {}
        ],
        "defaultBehavior": {
          "state": "enabled",
          "tooltip": ""
        }
      }
    }
  ],
  "layout": {},
  "checklists": [
    {
      "description": "text",
      "checklistId": 1
    }
  ],
  "activeCount": 39,
  "title": "Approval Test",
  "deleted": false,
  "processOwners": [
    "text"
  ],
  "invocationCount": 59,
  "groups": [
    "text"
  ],
  "orgId": 1,
  "description": "New Process"
}

Create process

post

Body

titlestringRequired

Title of the Workflow template

Example: Purchase order

descriptionstringOptional

Description of the Workflow template

Example: Get the list of items for purchase

membersstring[]Optional

List of member IDs

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42","fcsknAS1txaGbWyYIILvu56dtir2"]

groupsstring[]Optional

List of groups

processOwnersstring[]Optional

List of process owner IDs

ownerstringOptional

Owner ID

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

numberingSchemestringRequired

Numbering scheme for the Workflow template

Example: Purchase order ###

checklistsinteger[]Optional

List of checklist IDs

notificationGroupsstring[]Optional

List of notification groups

filesobject[]Optional

List of file names

privacystringOptional

Privacy setting

Example: full

Responses

200

Success

application/json

ownerstringRequired

Owner ID

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

updatedAtstringRequired

Timestamp of the last update

Example: 2024-02-05T03:55:20.114928Z

updatedBystringRequired

ID of the user who performed the update

privacystringRequired

Privacy setting

Example: full

createdAtstringRequired

Timestamp of creation

Example: 2024-02-05T03:55:20.083Z

membersstring[]Required

List of member IDs

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42","fcsknAS1txaGbWyYIILvu56dtir2"]

idintegerRequired

Workflow Template ID

Example: 43

filesobject[]Required

List of file names

draftbooleanRequired

Draft status

Example: false

numberingSchemestringRequired

Numbering scheme for the Workflow Template

Example: Purchase order ###

creatorstringRequired

Creator ID

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

notificationGroupsstring[]Required

List of notification groups

addressstringRequired

Address of the Workflow Template

Example: purchase-order

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

post

/workflow

POST /workflow HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 914

{
  "title": "Purchase order",
  "description": "Get the list of items for purchase",
  "members": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "fcsknAS1txaGbWyYIILvu56dtir2"
  ],
  "groups": [],
  "processOwners": [],
  "owner": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "numberingScheme": "Purchase order ###",
  "checklists": [],
  "checklistFields": [
    {
      "attrs": "{\"~#text\":{\"label\":\"Name of the Company\",\"autoCheck\":false,\"settings\":\"{\\\"multiline\\\":true}\"}}",
      "layout": null,
      "deleted": false,
      "hidden": false,
      "deletedBy": null,
      "deletedAt": null
    }
  ],
  "notificationGroups": [],
  "files": [],
  "privacy": "full",
  "status": [
    {
      "id": -1,
      "active": true,
      "rules": {
        "blocks": [
          "text"
        ]
      }
    }
  ],
  "privacySettings": {
    "whitelist": [
      "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
      "fcsknAS1txaGbWyYIILvu56dtir2"
    ]
  },
  "settings": {
    "allowArchive": true,
    "nextCount": 1,
    "hideAutoNumber": false,
    "statusDisabled": false,
    "creatorIsOwner": true,
    "creatorIsParticipant": true,
    "senderNotParticipant": false,
    "noConfirmation": false,
    "dueIn": 2
  }
}

{
  "owner": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "updatedAt": "2024-02-05T03:55:20.114928Z",
  "updatedBy": null,
  "privacy": "full",
  "reminder": [
    {
      "id": 8,
      "reminderTypeId": 1,
      "reminderType": "inactivity",
      "remindIn": 1,
      "interval": "day",
      "allowDisable": true,
      "message": "Please update the values of the Purchase"
    }
  ],
  "createdAt": "2024-02-05T03:55:20.083Z",
  "settings": {
    "allowArchive": true,
    "nextCount": null,
    "dueIn": 2,
    "senderNotParticipant": false,
    "creatorIsParticipant": true,
    "noConfirmation": false,
    "creatorIsOwner": true,
    "hideAutoNumber": false,
    "statusDisabled": false
  },
  "members": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "fcsknAS1txaGbWyYIILvu56dtir2"
  ],
  "id": 43,
  "files": [],
  "privacySettings": {
    "whitelist": [
      "text"
    ]
  },
  "draft": false,
  "numberingScheme": "Purchase order ###",
  "creator": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "notificationGroups": [],
  "address": "purchase-order",
  "status": [
    {
      "title": "Pending",
      "id": -1,
      "active": true,
      "seqNo": 1,
      "locked": false,
      "settings": {},
      "rules": {}
    }
  ],
  "layout": {
    "checklistWidth": "1",
    "checklistOpenState": {
      "web": true,
      "lite": true,
      "liteMobile": false
    }
  }
}

Update a process

patch

Path parameters

idintegerRequired

ID of the workflow

Example: 11

Body

titlestringOptional

Title of the Workflow Template

Example: Workflow Template

descriptionstringOptional

Description of the Workflow Template

Example: Get the list of items for purchase

membersstring[]Optional

List of member IDs associated with the Workflow Template

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42","fcsknAS1txaGbWyYIILvu56dtir2"]

groupsinteger[]Optional

List of group information

processOwnersstring[]Optional

List of process owner IDs

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42"]

ownerstringOptional

Owner ID of the Workflow Template

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

numberingSchemestringOptional

Numbering scheme for the Workflow Template

Example: Purchase order ###

notificationGroupsinteger[]Optional

List of notification groups

filesobject[]Optional

List of files

privacystringOptional

Privacy setting for the Workflow Template

Example: none

privacySettingsobjectOptional

Privacy settings information

Example: {"whitelist":["fcsknAS1txaGbWyYIILvu56dtir2"]}

draftbooleanOptional

Flag indicating if the Workflow Template is a draft

Example: false

Responses

200

Success

application/json

titlestringOptional

Title of the Workflow Template

Example: Workflow Template

descriptionstringOptional

Description of the Workflow Template

Example: Get the list of items for purchase

membersstring[]Optional

List of member IDs associated with the Workflow Template

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42","fcsknAS1txaGbWyYIILvu56dtir2"]

groupsinteger[]Optional

List of group information

processOwnersstring[]Optional

List of process owner IDs

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42"]

ownerstringOptional

Owner ID of the Workflow Template

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

numberingSchemestringOptional

Numbering scheme for the Workflow Template

Example: Purchase order ###

checklistsinteger[]Optional

List of checklist IDs associated with the Workflow Template

Example: [35]

notificationGroupsinteger[]Optional

List of notification groups

filesobject[]Optional

List of files

privacystringOptional

Privacy setting for the Workflow Template

Example: none

privacySettingsobjectOptional

Privacy settings information

Example: {"whitelist":["fcsknAS1txaGbWyYIILvu56dtir2"]}

draftbooleanOptional

Flag indicating if the Workflow Template is a draft

Example: false

addressstringOptional

Address of the Workflow Template

Example: purchase-order

deletedbooleanOptional

Flag indicating if the Workflow Template is deleted

Example: false

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

patch

/workflow/{id}

PATCH /workflow/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1237

{
  "title": "Workflow Template",
  "description": "Get the list of items for purchase",
  "members": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "fcsknAS1txaGbWyYIILvu56dtir2"
  ],
  "groups": [],
  "processOwners": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42"
  ],
  "owner": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "numberingScheme": "Purchase order ###",
  "notificationGroups": [],
  "files": [],
  "privacy": "none",
  "status": {
    "title": "Completed",
    "id": -2,
    "active": false,
    "seqNo": 2,
    "locked": false,
    "settings": {},
    "rules": {
      "blocks": [
        {}
      ]
    }
  },
  "privacySettings": {
    "whitelist": [
      "fcsknAS1txaGbWyYIILvu56dtir2"
    ]
  },
  "settings": {
    "allowArchive": true,
    "nextCount": 23,
    "dueIn": 2,
    "senderNotParticipant": false,
    "creatorIsParticipant": true,
    "noConfirmation": false,
    "creatorIsOwner": true,
    "hideAutoNumber": false,
    "statusDisabled": false
  },
  "reminder": {
    "id": 8,
    "reminderTypeId": 1,
    "reminderType": "inactivity",
    "remindIn": 1,
    "interval": "day",
    "allowDisable": false,
    "message": "Please update the values of the Purchase"
  },
  "layout": {
    "checklistWidth": "1",
    "checklistOpenState": {
      "web": true,
      "lite": true,
      "liteMobile": false
    }
  },
  "draft": false,
  "checklistFields": [
    {
      "attrs": "{\"~#text\":{\"label\":\"Name of the Company\",\"autoCheck\":false,\"settings\":\"{\\\"multiline\\\":true}\"}}",
      "layout": null,
      "deleted": false,
      "hidden": false,
      "deletedBy": null,
      "deletedAt": null
    }
  ]
}

{
  "title": "Workflow Template",
  "description": "Get the list of items for purchase",
  "members": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "fcsknAS1txaGbWyYIILvu56dtir2"
  ],
  "groups": [],
  "processOwners": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42"
  ],
  "owner": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "numberingScheme": "Purchase order ###",
  "checklists": [
    35
  ],
  "notificationGroups": [],
  "files": [],
  "privacy": "none",
  "status": {
    "title": "Completed",
    "id": -2,
    "active": false,
    "seqNo": 2,
    "locked": false,
    "settings": {},
    "rules": {
      "blocks": [
        {}
      ]
    }
  },
  "privacySettings": {
    "whitelist": [
      "fcsknAS1txaGbWyYIILvu56dtir2"
    ]
  },
  "settings": {
    "allowArchive": true,
    "nextCount": 23,
    "dueIn": 2,
    "senderNotParticipant": false,
    "creatorIsParticipant": true,
    "noConfirmation": false,
    "creatorIsOwner": true,
    "hideAutoNumber": false,
    "statusDisabled": false
  },
  "reminder": {
    "id": 8,
    "reminderTypeId": 1,
    "reminderType": "inactivity",
    "remindIn": 1,
    "interval": "day",
    "allowDisable": false,
    "message": "Please update the values of the Purchase"
  },
  "layout": {
    "checklistWidth": "1",
    "checklistOpenState": {
      "web": true,
      "lite": true,
      "liteMobile": false
    }
  },
  "draft": false,
  "address": "purchase-order",
  "deleted": false,
  "checklistFields": [
    {
      "attrs": "{\"~#text\":{\"label\":\"Name of the Company\",\"autoCheck\":false,\"settings\":\"{\\\"multiline\\\":true}\"}}",
      "layout": null,
      "deleted": false,
      "hidden": false,
      "deletedBy": null,
      "deletedAt": null
    }
  ]
}

Delete a process

delete

Path parameters

idintegerRequired

ID of the workflow

Example: 11

Responses

204

No Content

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

delete

/workflow/{id}

DELETE /workflow/{id} HTTP/1.1
Accept: */*

No content

Restore a process

post

Path parameters

idintegerRequired

ID of the process

Example: 11

Body

restorebooleanRequired

Restore process

Example: true

Responses

200

Success

No content

post

/workflow/{id}

POST /workflow/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "restore": true
}

200

Success

No content

Examples

The examples below will take you through creating your first process, to customizing it, and deleting it.

Creating a blank process

Let's start by creating a blank process using the Create process API.

As a bare minimum, you need to provide the titlekey.

{
    "title": "My first process"
}

Congratulations, you have created your first process!

Adding a checklist field

A process, on its own, is not very useful. Let's add a checklist field.

Checklist fields are added/updated/removed to a process through thechecklistFieldsarray. Each element in the array represents a checklist field. The checklist field configuration is present in the attrs key, which is a Transit encoded JSON string. To convert a JSON object to a Transit encoded JSON string, you can make use of various libraries which have implemented the Transit spec. When writing the string, ensure you use the json-verbosetype, instead of json. In the examples below, we may opt to write JSON objects for readability. You will need to convert them to Transit before making the API call.

Here are some code snippets demonstrating how to convert a JSON object to a Transit encoded string:

Using transit-js

// npm install @cognitect/transit-js

import transit from '@cognitect/transit-js';

// Create a Transit writer
const writer = transit.writer('json-verbose');

// Convert your JSON object
const jsonObject = {
  key: "value",
  number: 42,
  active: true
};

const transitString = writer.write(jsonObject);

Using transit

# pip install transit

import transit

# Create a Transit writer
writer = transit.writer('json-verbose')

# Convert your JSON object
json_object = {
  "key": "value",
  "number": 42,
  "active": True
}

transit_string = writer.write(json_object)

Using transit-java

// <dependency>
//    <groupId>com.cognitect</groupId>
//    <artifactId>transit-java</artifactId>
//    <version>1.0.0</version>
// </dependency>

import cognitect.transit.TransitFactory;
import cognitect.transit.Writer;

// Create a Transit writer
Writer writer = TransitFactory.writer(TransitFactory.Format.JSON_VERBOSE);

// Convert your JSON object
Map<String, Object> jsonObject = new HashMap<>();
jsonObject.put("key", "value");
jsonObject.put("number", 42);
jsonObject.put("active", true);

String transitString = writer.writeToString(jsonObject);

For example, given a checklist configuration as a JSON object such as

{
  "text": {
    "label": "My Text Field",
    "settings": {
      "multiline": true,
      "placeholder": "FooBar",
      "defaultValue": "abc"
    }
  }
}

After converting it to Transit encoded JSON string and escaping it, it should look like

"{\"~#text\":{\"label\":\"My Text Field\",\"settings\":{\"~#text\":{\"multiline\":true,\"placeholder\":\"FooBar\",\"defaultValue\":\"abc\"}}}}"

which can then be used in the payload as

{
  "checklistFields": [
    {
      "attrs": "{\"~#text\":{\"label\":\"My Text Field\",\"settings\":{\"~#text\":{\"multiline\":true,\"placeholder\":\"FooBar\",\"defaultValue\":\"abc\"}}}}"
    }
  ]
}

Text Field

Available configuration

Label
Multiline
Placeholder
Default value
Supressing notification for default value

{
  "text": {
    "label": "My Text Field",
    "settings": {
      "multiline": true,
      "placeholder": "FooBar",
      "defaultValue": "abc",
      "suppressDefaultNotification": false
    }
  }
}

Date Field

Available configuration

Label
Placeholder

{
  "date": {
    "label": "My Date Field",
    "settings": {
      "placeholder": "Click to add date"
    }
  }
}

User Field

Available configuration

Label
Default users
Supressing notification for default value
Multivalued toggle (default off)

{
  "user": {
    "label": "My User Field",
    "settings": {
      "users": [
        "GJuQurhdUOR9liGN1xGuACGM7pD2",
        "tOnGEe0vK7ZZ1B9798FISTPcdCz2"
      ],
      "suppressDefaultNotification": false,
      "multiple": true
    }
  }
}

Number Field

Available configuration

Label
Placeholder
Max value
Min value
Step (only applicable to the web UI)
Default value
Supressing notification for default value
Minimum places to display after decimal point (only applicable to the web UI)
Round off if number digits entered after decimal are more than configured (default false, only applicable to web UI)

{
  "number": {
    "label": "My Number Field",
    "settings": {
      "placeholder": "5",
      "max": 10,
      "min": 5,
      "step": 2,
      "defaultValue": 20,
      "suppressDefaultNotification": false,
      "format": {
        "decimalPlaces": 0,
        "roundOff": false
      }
    }
  }
}

Section Field

Available Configuration

Open by default (when status is set to)

{
  "section": {
    "label": "My Section",
    "settings": {
      "status": [10]
    }
  }
}

Subsection Field

{
  "section": {
    "label": "My Subsection",
    "settings": {
      "level": 1
    }
  }
}

File Field

Available Configuration

Label
Multivalued toggle
Show full preview toggle (only applicable to web UI)
Sorting by file name through name or upload date using date
Default files
Suppressing notification for default value
Restrict upload sources

{
  "file": {
    "label": "My File Field",
    "settings": {
      "multiple": true,
      "preview": true,
      "sortBy": "name",
      "defaultFile": [],
      "suppressDefaultNotification": false,
      "uploadOptions": [
        "computer",
        "unifize"
      ],
    }
  }
}

PDF Field

Available Configuration

Label
Optional file field to attach the PDF to, instead of PDF field
Customize checklist behavior through preview (don't attach to checklist, attach only latest to checklist, attach all to checklist, respectively)
Sequence of PDFs to stitch
- Generate from a template using PDFGeneratorAPI, specify a templateId
- Generate from a template using Adobe, specify name (a file, which is a template)
- Generate from a native file, specify fieldId (a file field)
Button text (by default Generate PDF)

{
  "pdf": {
    "label": "My PDF Field",
    "settings": {
      "targetField": 30,
      "preview": "none | latest | all",
      "pdf": [
        {
          "seqNo": 0,
          "templateId": "123"
        },
        {
          "seqNo": 1,
          "name": "e097504a-9b09-409c-90ed-16ebbbc1eadd"
        },
        {
          "seqNo": 2,
          "fieldId": 10
        }
      ],
      "buttonText": "abc"
    }
  }
}

Revision Field

Available Configuration

Label
Who is authorized to create a revision
- All the participants
- The owner
- Roles
- Specific users
- Groups
- Users from a field (must be a user field)
Who is authorized to mark a revision current
- All the participants (of the current revision)
- All the participants (of the revision being marked current)
- The owner (of the current revision)
- The owner (of the revision being marked current)
- Roles
- Specific users
- Groups
- Users from a field (of the current revision) (must be a user field)
- Users from a field (of the revision being marked current) (must be a user field)
- Only when a specific status is set
Fields to copy
Navigate to new revision automatically when created (Only applicable for web UI)
Mandate writing comment when creating revision
Automations
- On the new current revision
  - Add participants
  - Remove participants
  - Add participants to fields
  - Send message
  - Update privacy
  - Unarchive
- On the old current revision
  - Add participants
  - Remove participants
  - Add participants to fields
  - Send message
  - Update privacy
  - Update status
  - Auto archive

{
  "revision": {
    "label": "revision",
    "settings": {
      "version": 2,
      "authorizedToCreate": {
        "allParticipants": true,
        "owner": true,
        "roles": [
          619
        ],
        "users": [
          "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
        ],
        "groups": [
          73
        ],
        "fields": [
          340443
        ]
      },
      "authorizedToMarkCurrent": {
        "allParticipants": true,
        "owner": true,
        "roles": [
          619
        ],
        "users": [
          "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
        ],
        "groups": [
          73
        ],
        "fields": [
          340443
        ],
        "statuses": [
          -2
        ],
        "allParticipantsOfCurrent": true,
        "ownerOfCurrent": true,
        "fieldsOfCurrent": [
          340443
        ]
      },
      "copyableFields": [
        340441
      ],
      "navigateToNewRevision": true,
      "commentRequired": true,
      "automations": {
        "newCurrent": [
          {
            "active": true,
            "action": "addParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "removeParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "addParticipantsFromFields",
            "data": [
              340443
            ]
          },
          {
            "active": true,
            "action": "sendMessage",
            "data": "This is the current version now."
          },
          {
            "active": true,
            "action": "updatePrivacy",
            "data": {
              "mode": "content",
              "whitelistedUsers": [
                "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
              ]
            }
          },
          {
            "active": true,
            "action": "archive",
            "data": false
          }
        ],
        "oldCurrent": [
          {
            "active": true,
            "action": "addParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "removeParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "addParticipantsFromFields",
            "data": [
              340443
            ]
          },
          {
            "active": true,
            "action": "sendMessage",
            "data": "This is no longer the current version."
          },
          {
            "active": true,
            "action": "updatePrivacy",
            "data": {
              "mode": "full",
              "whitelistedUsers": [
                "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
              ]
            }
          },
          {
            "active": true,
            "action": "updateStatus",
            "data": -2
          },
          {
            "active": true,
            "action": "archive",
            "data": true
          }
        ]
      }
    }
  }
}

Approval Field

Available Configuration

Label
Show "Request Approval" button
Minimum required approvers
Required approvers
- Set to some to let anyone sign
- Set to adhoc to dynamically choose who can sign (Will override Minimum required approvers and Show "Request Approval" button )
Who can approve
- All participants
- The owner
- Prevent requester from approving
- Users
- Roles
- Groups
- Users in field(s) (Must be a user field)
Who can cancel
- All participants
- Approvers/signatories
- Prevent requester from approving
- Users
- Roles
- Groups
- Users in field(s) (Must be a user field)
- Can cancel when
  - Allow cancellation post approval (allowCancelOnApproval)
  - Allow cancelling of approvals in progress (canCancelPartialApproval)
Require comments
- During approval
- During rejection
- During cancellation
Contingent of previous approval(s)
- Hide/disable when inactive
- Disable previous approvals while field is approved or in progress
Lock fields
- When mode is set to new, fields will be locked during and post approval/rejection
- When mode is set to inherit, fields will continue to be locked under previous approval
Lock status
- On start / request of signature
- On approval
- On rejection
- On cancellation
Cancel all contingent approvals on rejection
Automations
- On start / request of signature
  - Update status
  - Add participants
  - Remove participants
  - Change owner
  - Send message
  - Update privacy
- On approval
  - Update status
  - Add participants
  - Remove participants
  - Change owner
  - Send message
  - Update privacy
  - Mark revision as current
- On rejection
  - Update status
  - Add participants
  - Remove participants
  - Change owner
  - Send message
  - Update privacy
- On cancellation
  - Update status
  - Add participants
  - Remove participants
  - Change owner
  - Send message
  - Update privacy

 {
  "approval": {
    "label": "approval",
    "settings": {
      "version": 2,
      "minApprovers": 1,
      "requiredApprovers": "some | adhoc",
      "showRequestApprovalButton": true,
      "approvers": {
        "allParticipants": true,
        "owner": true,
        "preventRequester": true,
        "users": [
          "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
        ],
        "roles": [
          619
        ],
        "groups": [
          73
        ],
        "fields": [
          340443
        ]
      },
      "cancellers": {
        "allParticipants": true,
        "approvers": true,
        "users": [
          "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
        ],
        "roles": [
          619
        ],
        "groups": [
          73
        ],
        "fields": [
          340443
        ]
      },
      "allowCancelOnApproval": true,
      "canCancelPartialApproval": true,
      "requireComment": true,
      "requireRejectionComment": true,
      "requireCancellationComment": true,
      "contingentApprovals": [
        340458
      ],
      "inactiveBehavior": "disable | hide",
      "canCancelContingentApprovals": true,      
      "cancelContingentApprovalsOnRejection": true,
      "lockFields": {
        "mode": "new | inherit",
        "fields": [
          340441,
          340443
        ]
      },            
      "lockStatus": {
        "onStart": true,
        "onApproval": true,
        "onCancellation": true,
        "onRejection": true
      },
      "automations": {
        "started": [
          {
            "active": true,
            "action": "updateStatus",
            "data": -2
          },
          {
            "active": true,
            "action": "addParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "removeParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "updateOwner",
            "data": "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
          },
          {
            "active": true,
            "action": "sendMessage",
            "data": "abc"
          },
          {
            "active": true,
            "action": "updatePrivacy",
            "data": {
              "mode": "content",
              "whitelistedUsers": [
                "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
              ]
            }
          },
          {
            "active": false,
            "action": "markRevisionAsCurrent",
            "data": null
          }
        ],
        "approved": [
          {
            "active": true,
            "action": "updateStatus",
            "data": -2
          },
          {
            "active": true,
            "action": "addParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "removeParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "updateOwner",
            "data": "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
          },
          {
            "active": true,
            "action": "sendMessage",
            "data": "abc"
          },
          {
            "active": true,
            "action": "updatePrivacy",
            "data": {
              "mode": "content",
              "whitelistedUsers": [
                "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
              ]
            }
          },
          {
            "active": true,
            "action": "markRevisionAsCurrent",
            "data": null
          }
        ],
        "rejected": [
          {
            "active": true,
            "action": "updateStatus",
            "data": -2
          },
          {
            "active": true,
            "action": "addParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "removeParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "updateOwner",
            "data": "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
          },
          {
            "active": true,
            "action": "sendMessage",
            "data": "abc"
          },
          {
            "active": true,
            "action": "updatePrivacy",
            "data": {
              "mode": "content",
              "whitelistedUsers": [
                "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
              ]
            }
          },
          {
            "active": false,
            "action": "markRevisionAsCurrent",
            "data": null
          }
        ],
        "cancelled": [
          {
            "active": true,
            "action": "updateStatus",
            "data": -2
          },
          {
            "active": true,
            "action": "addParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "removeParticipants",
            "data": [
              "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
            ]
          },
          {
            "active": true,
            "action": "updateOwner",
            "data": "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
          },
          {
            "active": true,
            "action": "sendMessage",
            "data": "abc"
          },
          {
            "active": true,
            "action": "updatePrivacy",
            "data": {
              "mode": "content",
              "whitelistedUsers": [
                "jA6d4gH0oMfGd90uKCrFyjMnrvt2"
              ]
            }
          },
          {
            "active": false,
            "action": "markRevisionAsCurrent",
            "data": null
          }
        ]
      }
    }
  }
}

Conversation Field

Available Configuration

Label
Set as child or parent conversation
Multiselect toggle
Allow selecting existing conversations through select
Allow creating new conversations through create
Autofill related conversation
Specify type of conversation
Process id through workflow (Only valid if type is set to "workflow")
Configure embedded fields (Only valid if type is set to workflow)
Show field names in preview
Show status and due date
Sort conversations
Select existing conversations by criteria
Show/hide archived conversations
Suppress title hyperlink to the record

{
  "conversation": {
    "label": "My Conversation Field",
    "settings": {
      "child": true,
      "multiple": true,
      "select": true,
      "create": true,
      "autoFillRelated": true,
      "type": "group | workflow | approval | conversation | task",
      "workflow": 10,
      "fields": [50 60],
      "showFieldNames": false,
      "showMetaData": false,
      "sortBy": "added | created",
      "selectExistingBy": " | title",
      "showArchived": false,
      "disableTitleHyperlink": false
    }
  }
}

Linked Field

Available Configuration

Label
Specify process and embedded fields
Allow linking multiple records
Autofill related records
Allow archived conversations
Show compressed preview
Show status, owner and due date
Disable title hyperlink to record
Set current process as child or parent
Allow selecting existing record
Allow creating new record
Allow manual revision linking
Select existing record by criteria
- Title

{
  "link": {
    "label": "linked",
    "settings": {
      "workflow": 16388,
      "fields": [
        340441
      ],
      "multiple": true,
      "autoFillRelated": true,
      "showArchived": true,      
      "showCompressedPreview": true,
      "showMetaData": true,
      "disableTitleHyperlink": true,
      "child": false,
      "select": true,
      "create": true,      
      "type": "workflow",
      "alwaysAllowManualLinks": true,
      "selectExistingBy": "title"
    }
  }
}

Form Fields

Available Configuration

Label
Allow multiple
Specify form templates

{
  "form": {
    "label": "form",
    "settings": {
      "multiple": true,
      "selectedForms": [
        6217
      ]
    }
  }
}

Deleting a checklist field

To delete a checklist field, use the Update process API and remove the checklist field you want to delete from the checklistFields array.

Restoring a checklist field

To restore a checklist field, use a combination of the Get process and Update process APIs.

The Get process API should include the field you want in its response, even if it is deleted.

To restore it, set the values of deleted, deletedAt and deletedBy to null when using the Update process API. Make sure you do not modify the rest of the checklist field object.

PreviousApplications NextRecords

Last updated 11 months ago

hashtagGet list of processes

hashtagGet process settings

hashtagCreate process

hashtagUpdate a process

hashtagDelete a process

hashtagRestore a process

hashtagExamples

hashtagCreating a blank process

hashtagAdding a checklist field

hashtagText Field

hashtagDate Field

hashtagUser Field

hashtagNumber Field

hashtagSection Field

hashtagSubsection Field

hashtagFile Field

hashtagPDF Field

hashtagRevision Field

hashtagApproval Field

hashtagConversation Field

hashtagLinked Field

hashtagForm Fields

hashtagDeleting a checklist field

hashtagRestoring a checklist field

Get list of processes

Get process settings

Create process

Update a process

Delete a process

Restore a process

Examples

Creating a blank process

Adding a checklist field

Text Field

Date Field

User Field

Number Field

Section Field

Subsection Field

File Field

PDF Field

Revision Field

Approval Field

Conversation Field

Linked Field

Form Fields

Deleting a checklist field

Restoring a checklist field