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-java

Processes

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 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

Using transit-java

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

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

which can then be used in the payload as

Available configuration

Label
Multiline
Placeholder
Default value

Available configuration

Label
Placeholder

Available configuration

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

Available configuration

Label
Placeholder
Max value
Min value

Available Configuration

Open by default (when status is set to)

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

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

Available Configuration

Label
Who is authorized to create a revision
- All the participants
- The owner

Available Configuration

Label
Show "Request Approval" button
Minimum required approvers
Required approvers

Available Configuration

Label
Set as child or parent conversation
Multiselect toggle
Allow selecting existing conversations through select

Available Configuration

Label
Specify process and embedded fields
Allow linking multiple records
Autofill related records

Available Configuration

Label
Allow multiple
Specify form templates

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

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

The 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 API. Make sure you do not modify the rest of the checklist field object.

Supressing notification for default value

Step (only applicable to the web UI)

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)

Suppressing notification for default value

Restrict upload sources

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)

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

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

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
On rejection
- Update status
- Add participants
- Remove participants
On cancellation
- Update status
- Add participants
- Remove participants

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

Select existing conversations by criteria

Show/hide archived conversations

Suppress title hyperlink to the record

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

# 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)

// <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);

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

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

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

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

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

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

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

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

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

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

{
  "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": {
    "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": {
    "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": {
    "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
    }
  }
}

{
  "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": {
    "label": "form",
    "settings": {
      "multiple": true,
      "selectedForms": [
        6217
      ]
    }
  }
}

Deleting a checklist field

Restoring a checklist field

Mark revision as current

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

attrsstringRequired

Attributes information

Example: {"~#text":{"label":"ENTER YOUR NAME","autoCheck":false,"settings":"{\"multiline\":true}"}}

labelstringRequired

Label for the checklist field

Example: ENTER YOUR NAME

multilinebooleanRequired

Flag indicating if the field allows multiline input

Example: true

autoCheckbooleanRequired

Flag indicating if auto-check is enabled for the field

Example: false

rolesstring[]Required

List of roles

usersstring[]Required

List of users

idintegerRequired

ID of the checklist field

Example: 73

seqNointegerRequired

Sequence number of the checklist field

Example: 0

deletedAtstringRequired

Date and time when the checklist field was deleted

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

layoutobjectRequired

Layout information for the checklist field

deletedBystringRequired

ID of the user who deleted the checklist field

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

deletedbooleanRequired

Flag indicating if the checklist field is deleted

Example: true

targetbooleanRequired

Flag indicating if the checklist field is a target

Example: false

hiddenbooleanRequired

Flag indicating if the checklist field is hidden

Example: false

fieldTypestringRequired

Type of the checklist field

Example: text

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

allowArchivebooleanRequired

Flag indicating if archiving is allowed

Example: true

nextCountintegerRequired

Next count value

Example: 2

dueInstringRequired

Due date for the data

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

senderNotParticipantbooleanRequired

Flag indicating if the sender is not a participant

Example: false

creatorIsParticipantbooleanRequired

Flag indicating if the creator is a participant

Example: true

noConfirmationbooleanRequired

Flag indicating if no confirmation is needed

Example: false

creatorIsOwnerbooleanRequired

Flag indicating if the creator is the owner

Example: true

hideAutoNumberbooleanRequired

Flag indicating if auto-number should be hidden

Example: false

statusDisabledbooleanRequired

Flag indicating if the status is disabled

Example: false

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

titlestringRequired

Title of the status

Example: Approved

idintegerRequired

ID of the status

Example: 6

activebooleanRequired

Flag indicating if the status is active

Example: false

seqNointegerRequired

Sequence number of the status

Example: 3

lockedbooleanRequired

Flag indicating if the status is locked

Example: false

archiveModestringRequired

Archive mode setting

Example: ignore

idintegerRequired

ID of the rules

Example: 213

entitystringRequired

Entity information

Example: status

entityIdintegerRequired

Entity ID

Example: 6

fieldstringRequired

Field information

blocksobject[]Required

List of blocks

statestringRequired

State of the default behavior

Example: enabled

tooltipstringRequired

Tooltip information

layoutobjectRequired

Layout information

descriptionstringRequired

Description of the checklist

checklistIdintegerRequired

ID of the checklist

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

errorstringRequired

404

Not Found

application/json

stringOptional

500

Internal server error

application/json

errorstringRequired

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

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

attrsstringRequired

Attributes information

Example: {"~#text":{"label":"ENTER YOUR NAME","autoCheck":false,"settings":"{\"multiline\":true}"}}

labelstringRequired

Label for the checklist field

Example: ENTER YOUR NAME

multilinebooleanRequired

Flag indicating if the field allows multiline input

Example: true

autoCheckbooleanRequired

Flag indicating if auto-check is enabled for the field

Example: false

rolesstring[]Required

List of roles

usersstring[]Required

List of users

idintegerRequired

ID of the checklist field

Example: 73

seqNointegerRequired

Sequence number of the checklist field

Example: 0

deletedAtstringRequired

Date and time when the checklist field was deleted

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

layoutobjectRequired

Layout information for the checklist field

deletedBystringRequired

ID of the user who deleted the checklist field

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

deletedbooleanRequired

Flag indicating if the checklist field is deleted

Example: true

targetbooleanRequired

Flag indicating if the checklist field is a target

Example: false

hiddenbooleanRequired

Flag indicating if the checklist field is hidden

Example: false

fieldTypestringRequired

Type of the checklist field

Example: text

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

allowArchivebooleanRequired

Flag indicating if archiving is allowed

Example: true

nextCountintegerRequired

Next count value

Example: 2

dueInstringRequired

Due date for the data

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

senderNotParticipantbooleanRequired

Flag indicating if the sender is not a participant

Example: false

creatorIsParticipantbooleanRequired

Flag indicating if the creator is a participant

Example: true

noConfirmationbooleanRequired

Flag indicating if no confirmation is needed

Example: false

creatorIsOwnerbooleanRequired

Flag indicating if the creator is the owner

Example: true

hideAutoNumberbooleanRequired

Flag indicating if auto-number should be hidden

Example: false

statusDisabledbooleanRequired

Flag indicating if the status is disabled

Example: false

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

titlestringRequired

Title of the status

Example: Approved

idintegerRequired

ID of the status

Example: 6

activebooleanRequired

Flag indicating if the status is active

Example: false

seqNointegerRequired

Sequence number of the status

Example: 3

lockedbooleanRequired

Flag indicating if the status is locked

Example: false

archiveModestringRequired

Archive mode setting

Example: ignore

idintegerRequired

ID of the rules

Example: 213

entitystringRequired

Entity information

Example: status

entityIdintegerRequired

Entity ID

Example: 6

fieldstringRequired

Field information

blocksobject[]Required

List of blocks

statestringRequired

State of the default behavior

Example: enabled

tooltipstringRequired

Tooltip information

layoutobjectRequired

Layout information

descriptionstringRequired

Description of the checklist

checklistIdintegerRequired

ID of the checklist

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

errorstringRequired

404

Not Found

application/json

stringOptional

500

Internal server error

application/json

errorstringRequired

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"
}

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

attrsstringOptional

Attributes of the checklist field

Example: {"~#text":{"label":"Name of the Company","autoCheck":false,"settings":"{\"multiline\":true}"}}

layoutobjectOptional

Layout information

deletedbooleanOptional

Flag indicating if the checklist field is deleted

Example: false

hiddenbooleanOptional

Flag indicating if the checklist field is hidden

Example: false

deletedBynullOptional

ID of the user who deleted the checklist field

deletedAtnullOptional

Timestamp when the checklist field was deleted

notificationGroupsstring[]Optional

List of notification groups

filesobject[]Optional

List of file names

privacystringOptional

Privacy setting

Example: full

idintegerOptional

ID of the status

Example: -1

activebooleanOptional

Flag indicating if the status is active

Example: true

blocksstring[]Optional

List of blocks

whiteliststring[]Optional

List of whitelisted users

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42","fcsknAS1txaGbWyYIILvu56dtir2"]

allowArchivebooleanOptional

Flag indicating if archiving is allowed

Example: true

nextCountnullOptional

Next count value

Example: 1

hideAutoNumberbooleanOptional

Flag indicating if auto-number should be hidden

Example: false

statusDisabledbooleanOptional

Flag indicating if the status is disabled

Example: false

creatorIsOwnerbooleanOptional

Flag indicating if the creator is the owner

Example: true

creatorIsParticipantbooleanOptional

Flag indicating if the creator is a participant

Example: true

senderNotParticipantbooleanOptional

Flag indicating if the sender is not a participant

Example: false

noConfirmationbooleanOptional

Flag indicating if no confirmation is needed

Example: false

dueInnullOptional

Due date in days

Example: 2

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

idintegerRequired

Reminder ID

Example: 8

reminderTypeIdintegerRequired

ID of the reminder type

Example: 1

reminderTypestringRequired

Type of the reminder

Example: inactivity

remindInintegerRequired

Remind in days

Example: 1

intervalstringRequired

Interval for the reminder

Example: day

allowDisablebooleanRequired

Flag indicating if the reminder can be disabled

Example: true

messagestringRequired

Reminder message

Example: Please update the values of the Purchase

createdAtstringRequired

Timestamp of creation

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

allowArchivebooleanRequired

Flag indicating if archiving is allowed

Example: true

nextCountnullRequired

Next count value

dueInnullRequired

Due date in days

Example: 2

senderNotParticipantbooleanRequired

Flag indicating if the sender is not a participant

Example: false

creatorIsParticipantbooleanRequired

Flag indicating if the creator is a participant

Example: true

noConfirmationbooleanRequired

Flag indicating if no confirmation is needed

Example: false

creatorIsOwnerbooleanRequired

Flag indicating if the creator is the owner

Example: true

hideAutoNumberbooleanRequired

Flag indicating if auto-number should be hidden

Example: false

statusDisabledbooleanRequired

Flag indicating if the status is disabled

Example: false

membersstring[]Required

List of member IDs

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42","fcsknAS1txaGbWyYIILvu56dtir2"]

idintegerRequired

Workflow Template ID

Example: 43

filesobject[]Required

List of file names

whiteliststring[]Required

List of whitelisted users

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

titlestringRequired

Status title

Example: Pending

idintegerRequired

Status ID

Example: -1

activebooleanRequired

Flag indicating if the status is active

Example: true

seqNointegerRequired

Sequence number

Example: 1

lockedbooleanRequired

Flag indicating if the status is locked

Example: false

settingsobjectRequired

Status settings

rulesobjectRequired

Status rules

checklistWidthstringRequired

Checklist width

Example: 1

webbooleanRequired

Web state

Example: true

litebooleanRequired

Lite state

Example: true

liteMobilebooleanRequired

Lite mobile state

Example: false

401

Authentication / Authorization error

application/json

errorstringRequired

404

Not Found

application/json

stringOptional

500

Internal server error

application/json

errorstringRequired

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
    }
  }
}

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

titlestringOptional

Title of the status

Example: Completed

idintegerOptional

ID of the status

Example: -2

activebooleanOptional

Flag indicating if the status is active

Example: false

seqNointegerOptional

Sequence number of the status

Example: 2

lockedbooleanOptional

Flag indicating if the status is locked

Example: false

settingsobjectOptional

Settings for the status

blocksobject[]Optional

List of blocks

privacySettingsobjectOptional

Privacy settings information

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

allowArchivebooleanOptional

Flag indicating if archiving is allowed

Example: true

nextCountintegerOptional

Next count value

Example: 23

dueInintegerOptional

Due date for the Workflow Template

Example: 2

senderNotParticipantbooleanOptional

Flag indicating if the sender is not a participant

Example: false

creatorIsParticipantbooleanOptional

Flag indicating if the creator is a participant

Example: true

noConfirmationbooleanOptional

Flag indicating if no confirmation is needed

Example: false

creatorIsOwnerbooleanOptional

Flag indicating if the creator is the owner

Example: true

hideAutoNumberbooleanOptional

Flag indicating if auto-number should be hidden

Example: false

statusDisabledbooleanOptional

Flag indicating if the status is disabled

Example: false

idintegerOptional

ID of the reminder

Example: 8

reminderTypeIdintegerOptional

ID of the reminder type

Example: 1

reminderTypestringOptional

Type of the reminder

Example: inactivity

remindInintegerOptional

Number of days to remind

Example: 1

intervalstringOptional

Interval for the reminder

Example: day

allowDisablebooleanOptional

Flag indicating if the reminder can be disabled

Example: false

messagestringOptional

Reminder message

Example: Please update the values of the Purchase

checklistWidthstringOptional

Width of the checklist

Example: 1

webbooleanOptional

Flag indicating if web checklist is open

Example: true

litebooleanOptional

Flag indicating if lite checklist is open

Example: true

liteMobilebooleanOptional

Flag indicating if lite mobile checklist is open

Example: false

draftbooleanOptional

Flag indicating if the Workflow Template is a draft

Example: false

attrsstringOptional

Attributes of the checklist field

Example: {"~#text":{"label":"Name of the Company","autoCheck":false,"settings":"{\"multiline\":true}"}}

layoutobjectOptional

Layout information

deletedbooleanOptional

Flag indicating if the checklist field is deleted

Example: false

hiddenbooleanOptional

Flag indicating if the checklist field is hidden

Example: false

deletedBynullOptional

ID of the user who deleted the checklist field

deletedAtnullOptional

Timestamp when the checklist field was deleted

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

titlestringOptional

Title of the status

Example: Completed

idintegerOptional

ID of the status

Example: -2

activebooleanOptional

Flag indicating if the status is active

Example: false

seqNointegerOptional

Sequence number of the status

Example: 2

lockedbooleanOptional

Flag indicating if the status is locked

Example: false

settingsobjectOptional

Settings for the status

blocksobject[]Optional

List of blocks

privacySettingsobjectOptional

Privacy settings information

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

allowArchivebooleanOptional

Flag indicating if archiving is allowed

Example: true

nextCountintegerOptional

Next count value

Example: 23

dueInintegerOptional

Due date for the Workflow Template

Example: 2

senderNotParticipantbooleanOptional

Flag indicating if the sender is not a participant

Example: false

creatorIsParticipantbooleanOptional

Flag indicating if the creator is a participant

Example: true

noConfirmationbooleanOptional

Flag indicating if no confirmation is needed

Example: false

creatorIsOwnerbooleanOptional

Flag indicating if the creator is the owner

Example: true

hideAutoNumberbooleanOptional

Flag indicating if auto-number should be hidden

Example: false

statusDisabledbooleanOptional

Flag indicating if the status is disabled

Example: false

idintegerOptional

ID of the reminder

Example: 8

reminderTypeIdintegerOptional

ID of the reminder type

Example: 1

reminderTypestringOptional

Type of the reminder

Example: inactivity

remindInintegerOptional

Number of days to remind

Example: 1

intervalstringOptional

Interval for the reminder

Example: day

allowDisablebooleanOptional

Flag indicating if the reminder can be disabled

Example: false

messagestringOptional

Reminder message

Example: Please update the values of the Purchase

checklistWidthstringOptional

Width of the checklist

Example: 1

webbooleanOptional

Flag indicating if web checklist is open

Example: true

litebooleanOptional

Flag indicating if lite checklist is open

Example: true

liteMobilebooleanOptional

Flag indicating if lite mobile checklist is open

Example: false

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

attrsstringOptional

Attributes of the checklist field

Example: {"~#text":{"label":"Name of the Company","autoCheck":false,"settings":"{\"multiline\":true}"}}

layoutobjectOptional

Layout information

deletedbooleanOptional

Flag indicating if the checklist field is deleted

Example: false

hiddenbooleanOptional

Flag indicating if the checklist field is hidden

Example: false

deletedBynullOptional

ID of the user who deleted the checklist field

deletedAtnullOptional

Timestamp when the checklist field was deleted

401

Authentication / Authorization error

application/json

errorstringRequired

404

Not Found

application/json

stringOptional

500

Internal server error

application/json

errorstringRequired

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

No content

401

Authentication / Authorization error

application/json

errorstringRequired

404

Not Found

application/json

stringOptional

500

Internal server error

application/json

errorstringRequired

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

Processes

Examples

Creating a blank process

Adding a checklist field

Processes

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

Delete a process

Restore a process

Get list of processes

Get process settings

Create process

Update a process