Authentication

Sign In

Login a user with provided username and password.
POST /api/v2/sign-in

Headers

Name
Description
Content-Type
application/json

Request Details

Name
Description
email
Email of the user that logs in on the system.
password
Password of the user that logs in on the system.
Request

{
 "email": "devlin.monroe-n@alchemy.cloud",
 "password": " "
}

Description of usual responses

200 OK – User logged in successfully.
400 Bad Request – Invalid parameters supplied.

Response Details

Name
Description
accessToken
Hashed value that contains security credentials.
refreshToken
Hashed value that allows the user to get a new access token.
tenant
Tenant name to which the logged user belongs.
id
Id of the user that has logged in.
email
Email (username) of the logged user.
permissions
System permissions that the logged user has. Can be EXTERNAL_USER, USER, ADMIN
firstName
First name of the logged user.
lastName
Last name of the logged user.
canCreateAnyProcess
Permission if the user can create any process that exists in the system for the tenant.

Body of bad request

{
"timestamp": "2020-12-03T13:06:31.901+00:00",
"status": 400,
"error": "Bad Request",
"message": "Required request body is missing: public org
.springframework.http.ResponseEntity<> cloud.alchemy.core.web
.rest.AuthenticationApiResource.signIn(cloud.alchemy.core.api
.dto.authenticationapi.SignInRequest,org.springframework
.validation.Errors) throws java.sql.SQLException",
"path": "/api/v2/sign-in"
}
Response

{
   "accessToken": "eyJhbGciOiJILMiJ9...",
   "refreshToken": "eyJhbGciOiJIUzUx...",
   "tenant": "alchemy",
   "id": 2,
   "email": "devlin.monroe-n@alchemy.cloud",
   "permissions": [
       "USER",
       "EXTERNAL_USER"
   ],
   "firstName": "Devlin",
   "lastName": "Monroe",
   "canCreateAnyProcess": true
}

Refresh Token

Creates a new access token. When the access token expires, this api is called with the refresh token to get a new access token.
POST /api/v2/refresh-token

Headers

Name
Description
Content-Type
application/json

Request Details

Name
Description
refreshToken
Refresh token that is used to get a new access token when the original expires.
Request

{
 "refreshToken":   "eyJhbGciOiJIUzUxMiJ9.ey..."
}

Description of usual responses

200 OK – New refresh token retrieved successfully.
400 Bad Request – Invalid parameters supplied.
401 Unauthorized– Can be refresh token has expired, user doesn’t have appropriate access level. Also if the user doesn’t have email verified or has hashed password, but it isn’t external, will throw this exception.

Response Details

Name
Description
accessToken
Hashed value that contains security credentials.
refreshToken
Hashed value that allows the user to get a new access token.
tenant
Tenant name to which the logged user belongs.
id
Id of the user that has logged in.
email
Email (username) of the logged user.
permissions
System permissions that the logged user has. Can be EXTERNAL_USER, USER, ADMIN
firstName
First name of the logged user.
lastName
Last name of the logged user.
canCreateAnyProcess
Permission if the user can create any process that exists in the system for the tenant.

Body of bad request

{
"timestamp": "2020-12-03T18:07:20.223+00:00",
"status": 400,
"error": "Bad Request",
"message": "JSON parse error: Unrecognized field email, not marked as ignorable (one known property: "refreshToken"])
"path": "/api/refresh-token"
}
Response

{
   "accessToken": "eyJhbGciOiJILMiJ9...",
   "refreshToken": "eyJhbGciOiJIUzUx...",
   "tenant": "alchemy",
   "id": 2,
   "email": "devlin.monroe-n@alchemy.cloud",
   "permissions": [
       "USER",
       "EXTERNAL_USER"
   ],
   "firstName": "Devlin",
   "lastName": "Monroe",
   "canCreateAnyProcess": true,
   "smallAvatarUrl": null,
   "mediumAvatarUrl": null,
   "largeAvatarUrl": null
}

Process

Create Process

Creates a process from the provided template and populates it with the supplied parameters.
POST /api/v2/create-process

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

Name
Description
identifier
The unique identifier of the process template.
properties (optional)
List of field identifiers and their values.(description below)
Fields of single properties object
Description
identifier
The unique identifier of the field template.
rows (optional)
List of rows and values in those rows that the field should be populated with.
Fields of single rows object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).
Request

{
"identifier": "LabWork",
"properties": [
  {
    "identifier": "Description",
    "rows": [
      {
        "row" : 0,
        "values": [
          {
              "value": "Example description",
              "valuePreview": "Example description preview"
          }
        ]
      }
    ]
  }
]
}

Description of usual responses

200 OK – Process data returned successfully.
400 Bad Request – Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

Name
Description
id
The unique id of the created process.
name (optional)
The name of the created process.
status
Status of created process. Can be in progress, on hold, void, and completed.
priority (optional)
Priority of the created process.
createdBy
User info of the user that created the process. (description below)
createdOn
Date and time when the process was created.
completedOn (optional)
Date and time when the process was completed.
completedBy (optional)
User info of the user that completed the process. (description below)
currentStage (optional)
Name of the stage that the process is currently in.
stages (optional)
List of the stages that this process contains, populated with records and tasks associated with it. (description below)
Fields of createdBy and completedBy object
Description
id
The unique id of the user.
firstName
First name of the user.
lastName
Last name of the user.
email
Email of the user.
Fields of single stages object
Description
identifier
The unique identifier of the stage.
records (optional)
List of records that stage contains. (description below)
tasks (optional)
List of tasks that stage contains. (description below)
Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single tasks object
Description
id
The unique id of the task.
subject (optional)
Subject of the task.
description (optional)
Description of the task.
taskState
Current task state. Can be none, pending or overdue.
plannedStart
Date and time of the planned start of the task.
completionTarget
Completion target date and time of the task.
startedOn (optional)
Starting date and time of the task.
completedOn (optional)
Completion date and time of the task.
score (optional)
Score of the task.
assigneesId (optional)
List of user ids that are assigned to the task.
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Body of bad request

{
"timestamp": "2020-11-09T12:17:36.508+00:00",
"status": 400,
"error": "Bad Request",
"message": "JSON parse error: Unrecognized field \"index\"",
"path": "/api/v2/create-process"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "INSUFFICIENT_PROCESS_PRIVILEGES",
"path": "/api/v2/create-process"
}
Response

{
  "id": 246,
  "name": "LW-021 Example description",
  "status": "IN_PROGRESS",
  "priority": 58,
  "createdBy": {
      "id": 1,
      "firstName": "John",
      "lastName": "Doe",
      "email": "john-doe@alchemy.cloud"
  },
  "createdOn": "2021-09-15T10:57:20.083378Z",
  "completedOn": null,
  "completedBy": null,
  "currentStage": "Lab Work",
  "stages": [
      {
          "identifier": "LabWork",
          "records": [
              {
                  "recordId": 1816,
                  "name": "LW-021 Example description",
                  "createdById": null,
                  "createdOn": "2021-09-15T10:57:20.207892Z",
                  "errorInfo": [],
                  "fieldGroups": [
                      {
                          "identifier": "Group1",
                          "fields": [
                              {
                                  "identifier": "Attachment1",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment2",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment3",
                                  "rows": []
                              }
                          ]
                      }
                  ],
                  "fields": [
                      {
                          "identifier": "Objective",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "",
                                          "valuePreview": ""
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "AttachResults",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": false,
                                          "valuePreview": "false"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Date",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "2021-09-15T10:57:20.319913Z[UTC]",
                                          "valuePreview": "2021-09-15T10:57:20.319913Z[UTC]"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Description",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "Example description",
                                          "valuePreview": "Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "LabWorkNumber",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021",
                                          "valuePreview": "LW-021"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Name",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021 Example description",
                                          "valuePreview": "LW-021 Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      }
                  ]
              }
          ],
          "tasks": [
              {
                  "id": 422,
                  "subject": "Do the work",
                  "description": "",
                  "taskState": "NONE",
                  "plannedStart": "2021-09-15T10:57:20Z",
                  "completionTarget": "2021-09-15T18:57:20Z",
                  "startedOn": null,
                  "completedOn": null,
                  "score": null,
                  "assignees": [
                      {
                          "id": 1,
                          "firstName": "John",
                          "lastName": "Doe",
                          "email": "john-doe@alchemy.cloud"
                      }
                  ]
              }
          ]
      }
  ]
}

Read Process

Read the complete status of a process for the provided process id.
GET /api/v2/read-process

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Query parameters

- Request sent as a parameter

Name
Description
id
Provided id of the process.

Description of usual responses

200 OK – Process data returned successfully.
401 Unauthorized – User is unauthorized to do this action.

Response Details

Name
Description
id
The unique id of the created process.
name (optional)
The name of the created process.
status
Status of created process. Can be in progress, on hold, void, and completed.
priority (optional)
Priority of the created process.
createdBy
User info of the user that created the process. (description below)
createdOn
Date and time when the process was created.
completedOn (optional)
Date and time when the process was completed.
completedBy (optional)
User info of the user that completed the process. (description below)
currentStage (optional)
Name of the stage that the process is currently in.
stages (optional)
List of the stages that this process contains, populated with records and tasks associated with it. (description below)
Fields of createdBy and completedBy object
Description
id
The unique id of the user.
firstName
First name of the user.
lastName
Last name of the user.
email
Email of the user.
Fields of single stages object
Description
identifier
The unique identifier of the field template.
records (optional)
List of records that stage contains. (description below)
tasks (optional)
List of tasks that stage contains. (description below)
Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single tasks object
Description
id
The unique id of the task.
subject (optional)
Subject of the task.
description (optional)
Description of the task.
taskState
Current task state. Can be none, pending or overdue.
plannedStart
Date and time of the planned start of the task.
completionTarget
Completion target date and time of the task.
startedOn (optional)
Starting date and time of the task.
completedOn (optional)
Completion date and time of the task.
score (optional)
Score of the task.
assigneesId (optional)
List of user ids that are assigned to the task.
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "INSUFFICIENT_PROCESS_PRIVILEGES",
"path": "/api/v2/read-process"
}
Response

{
  "id": 246,
  "name": "LW-021 Example description",
  "status": "IN_PROGRESS",
  "priority": 58,
  "createdBy": {
      "id": 1,
      "firstName": "John",
      "lastName": "Doe",
      "email": "john-doe@alchemy.cloud"
  },
  "createdOn": "2021-09-15T10:57:20.083378Z",
  "completedOn": null,
  "completedBy": null,
  "currentStage": "Lab Work",
  "stages": [
      {
          "identifier": "LabWork",
          "records": [
              {
                  "recordId": 1816,
                  "name": "LW-021 Example description",
                  "createdById": null,
                  "createdOn": "2021-09-15T10:57:20.207892Z",
                  "errorInfo": [],
                  "fieldGroups": [
                      {
                          "identifier": "Group1",
                          "fields": [
                              {
                                  "identifier": "Attachment1",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment2",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment3",
                                  "rows": []
                              }
                          ]
                      }
                  ],
                  "fields": [
                      {
                          "identifier": "Objective",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "",
                                          "valuePreview": ""
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "AttachResults",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": false,
                                          "valuePreview": "false"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Date",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "2021-09-15T10:57:20.319913Z[UTC]",
                                          "valuePreview": "2021-09-15T10:57:20.319913Z[UTC]"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Description",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "Example description",
                                          "valuePreview": "Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "LabWorkNumber",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021",
                                          "valuePreview": "LW-021"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Name",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021 Example description",
                                          "valuePreview": "LW-021 Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      }
                  ]
              }
          ],
          "tasks": [
              {
                  "id": 422,
                  "subject": "Do the work",
                  "description": "",
                  "taskState": "NONE",
                  "plannedStart": "2021-09-15T10:57:20Z",
                  "completionTarget": "2021-09-15T18:57:20Z",
                  "startedOn": null,
                  "completedOn": null,
                  "score": null,
                  "assignees": [
                      {
                          "id": 1,
                          "firstName": "John",
                          "lastName": "Doe",
                          "email": "john-doe@alchemy.cloud"
                      }
                  ]
              }
          ]
      }
  ]
}

Complete Stage

Completes the stage for provided process id and stage identifier.
PUT /api/v2/complete-stage

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a Stage identifier and Process identifier Stage belongs to

Name
Description
processId
The unique id of process.
stage
The unique identifier of the stage template. (optional)
Request

{
"processId": 37,
"stage": "Request"
}

Description of usual responses

200 OK – Process data returned successfully.
400 Bad Request – Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

Name
Description
id
The unique id of the created process.
name (optional)
The name of the created process.
status
Status of created process. Can be in progress, on hold, void, and completed.
priority (optional)
Priority of the created process.
createdBy
User info of the user that created the process. (description below)
createdOn
Date and time when the process was created.
completedOn (optional)
Date and time when the process was completed.
completedBy (optional)
User info of the user that completed the process. (description below)
currentStage (optional)
Name of the stage that the process is currently in.
stages (optional)
List of the stages that this process contains, populated with records and tasks associated with it. (description below)
Fields of createdBy and completedBy object
Description
id
The unique id of the user.
firstName
First name of the user.
lastName
Last name of the user.
email
Email of the user.
Fields of single stages object
Description
identifier
The unique identifier of the field template.
records (optional)
List of records that stage contains. (description below)
tasks (optional)
List of tasks that stage contains. (description below)
Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single tasks object
Description
id
The unique id of the task.
subject (optional)
Subject of the task.
description (optional)
Description of the task.
taskState
Current task state. Can be none, pending or overdue.
plannedStart
Date and time of the planned start of the task.
completionTarget
Completion target date and time of the task.
startedOn (optional)
Starting date and time of the task.
completedOn (optional)
Completion date and time of the task.
score (optional)
Score of the task.
assigneesId (optional)
List of user ids that are assigned to the task.
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Bad request response body

{
"timestamp": "2020-11-09T13:04:11.645+00:00",
"status": 400,
"error": "Bad Request",
"message": "INVALID_PROCESS_STATUS",
"path": "/api/v2/complete-stage"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "INSUFFICIENT_PROCESS_PRIVILEGES",
"path": "/api/v2/complete-stage"
}
Response

{
  "id": 246,
  "name": "LW-021 Example description",
  "status": "IN_PROGRESS",
  "priority": 58,
  "createdBy": {
      "id": 1,
      "firstName": "John",
      "lastName": "Doe",
      "email": "john-doe@alchemy.cloud"
  },
  "createdOn": "2021-09-15T10:57:20.083378Z",
  "completedOn": null,
  "completedBy": null,
  "currentStage": "Lab Work",
  "stages": [
      {
          "identifier": "LabWork",
          "records": [
              {
                  "recordId": 1816,
                  "name": "LW-021 Example description",
                  "createdById": null,
                  "createdOn": "2021-09-15T10:57:20.207892Z",
                  "errorInfo": [],
                  "fieldGroups": [
                      {
                          "identifier": "Group1",
                          "fields": [
                              {
                                  "identifier": "Attachment1",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment2",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment3",
                                  "rows": []
                              }
                          ]
                      }
                  ],
                  "fields": [
                      {
                          "identifier": "Objective",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "",
                                          "valuePreview": ""
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "AttachResults",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": false,
                                          "valuePreview": "false"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Date",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "2021-09-15T10:57:20.319913Z[UTC]",
                                          "valuePreview": "2021-09-15T10:57:20.319913Z[UTC]"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Description",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "Example description",
                                          "valuePreview": "Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "LabWorkNumber",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021",
                                          "valuePreview": "LW-021"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Name",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021 Example description",
                                          "valuePreview": "LW-021 Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      }
                  ]
              }
          ],
          "tasks": [
              {
                  "id": 422,
                  "subject": "Do the work",
                  "description": "",
                  "taskState": "NONE",
                  "plannedStart": "2021-09-15T10:57:20Z",
                  "completionTarget": "2021-09-15T18:57:20Z",
                  "startedOn": null,
                  "completedOn": null,
                  "score": null,
                  "assignees": [
                      {
                          "id": 1,
                          "firstName": "John",
                          "lastName": "Doe",
                          "email": "john-doe@alchemy.cloud"
                      }
                  ]
              }
          ]
      }
  ]
}

Complete Task

Completes a task for provided task id.
PUT /api/v2/complete-task

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a single object

Name
Description
id
Provided id of the task.
Request

{
  "id": "150"
}

Description of usual responses

200 OK – Task completed successfully.
400 Bad Request – Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

Name
Description
id
The unique id of the created process.
name (optional)
The name of the created process.
status
Status of created process. Can be in progress, on hold, void, and completed.
priority (optional)
Priority of the created process.
createdBy
User info of the user that created the process. (description below)
createdOn
Date and time when the process was created.
completedOn (optional)
Date and time when the process was completed.
completedBy (optional)
User info of the user that completed the process. (description below)
currentStage (optional)
Name of the stage that the process is currently in.
stages (optional)
List of the stages that this process contains, populated with records and tasks associated with it. (description below)
Fields of createdBy and completedBy object
Description
id
The unique id of the user.
firstName
First name of the user.
lastName
Last name of the user.
email
Email of the user.
Fields of single stages object
Description
identifier
The unique identifier of the field template.
records (optional)
List of records that stage contains. (description below)
tasks (optional)
List of tasks that stage contains. (description below)
Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single tasks object
Description
id
The unique id of the task.
subject (optional)
Subject of the task.
description (optional)
Description of the task.
taskState
Current task state. Can be none, pending or overdue.
plannedStart
Date and time of the planned start of the task.
completionTarget
Completion target date and time of the task.
startedOn (optional)
Starting date and time of the task.
completedOn (optional)
Completion date and time of the task.
score (optional)
Score of the task.
assigneesId (optional)
List of user ids that are assigned to the task.
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Bad request response body

{
 "timestamp": "2020-12-08T13:23:11.262+00:00",
 "status": 400,
 "error": "Bad Request",
 "message": "Task with id: 999999 does not exist.",
 "path": "/api/v2/complete-task"
}
{
 "timestamp": "2020-12-08T13:24:17.823+00:00",
 "status": 400,
 "error": "Bad Request",
 "message": "JSON parse error: Unrecognized field \"ids\"...)",
 "path": "/api/v2/complete-task"
}
{
 "timestamp": "2020-12-08T13:25:32.650+00:00",
 "status": 400,
 "error": "Bad Request",
 "message": "INVALID_STAGE_STATE",
 "path": "/api/v2/complete-task"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/complete-task
}
{
 "timestamp": "2020-12-08T13:26:41.794+00:00",
 "status": 401,
 "error": "Unauthorized",
 "message": "INSUFFICIENT_STAGE_PRIVILEGES",
 "path": "/api/v2/complete-task"
}
Response

{
  "id": 246,
  "name": "LW-021 Example description",
  "status": "IN_PROGRESS",
  "priority": 58,
  "createdBy": {
      "id": 1,
      "firstName": "John",
      "lastName": "Doe",
      "email": "john-doe@alchemy.cloud"
  },
  "createdOn": "2021-09-15T10:57:20.083378Z",
  "completedOn": 2021-09-18T10:12:30.083378Z,
  "completedBy": null,
  "currentStage": "Lab Work",
  "stages": [
      {
          "identifier": "LabWork",
          "records": [
              {
                  "recordId": 1816,
                  "name": "LW-021 Example description",
                  "createdById": null,
                  "createdOn": "2021-09-15T10:57:20.207892Z",
                  "errorInfo": [],
                  "fieldGroups": [
                      {
                          "identifier": "Group1",
                          "fields": [
                              {
                                  "identifier": "Attachment1",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment2",
                                  "rows": []
                              },
                              {
                                  "identifier": "Attachment3",
                                  "rows": []
                              }
                          ]
                      }
                  ],
                  "fields": [
                      {
                          "identifier": "Objective",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "",
                                          "valuePreview": ""
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "AttachResults",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": false,
                                          "valuePreview": "false"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Date",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "2021-09-15T10:57:20.319913Z[UTC]",
                                          "valuePreview": "2021-09-15T10:57:20.319913Z[UTC]"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Description",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "Example description",
                                          "valuePreview": "Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "LabWorkNumber",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021",
                                          "valuePreview": "LW-021"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      },
                      {
                          "identifier": "Name",
                          "rows": [
                              {
                                  "row": 0,
                                  "values": [
                                      {
                                          "value": "LW-021 Example description",
                                          "valuePreview": "LW-021 Example description"
                                      }
                                  ],
                                  "errorInfo": null
                              }
                          ]
                      }
                  ]
              }
          ],
          "tasks": [
              {
                  "id": 422,
                  "subject": "Do the work",
                  "description": "",
                  "taskState": "COMPLETED",
                  "plannedStart": "2021-09-15T10:57:20Z",
                  "completionTarget": "2021-09-15T18:57:20Z",
                  "startedOn":  "2021-09-15T10:57:20Z",
                  "completedOn":  "2021-09-18T10:57:20Z",
                  "score": 5,
                  "assignees": [
                      {
                          "id": 1,
                          "firstName": "John",
                          "lastName": "Doe",
                          "email": "john-doe@alchemy.cloud"
                      }
                  ]
              }
          ]
      }
  ]
}

Record

Create Record

Creates records of specific record templates in provided processes.
POST /api/v2/create-record

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a list of objects

Name
Description
processId
The unique id of process.
recordTemplate
The unique identifier of the record template.
Request

[
  {
      "processId": 247,
      "recordTemplate": "ColorTest",
      "stageTemplateIdentifier": "",
      "properties": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard",
                              "valuePreview": "Test Color Standard Preview"
                          }
                      ]
                  }
              ]
          }
      ]
  }
]

Description of usual responses

200 OK – Record created successfully.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/create-record"
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest2",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:30.696849Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": []
                  },
                  {
                      "identifier": "Samplea",
                      "rows": []
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": []
                  },
                  {
                      "identifier": "Strength",
                      "rows": []
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": []
                  },
                  {
                      "identifier": "Observations",
                      "rows": []
                  },
                  {
                      "identifier": "Sample",
                      "rows": []
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard",
                              "valuePreview": "Test Color Standard"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": null,
                              "valuePreview": ""
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": null,
                              "valuePreview": ""
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": null,
                              "valuePreview": ""
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Update Record

Updates a record with provided record id and supplied parameters.
PUT /api/v2/update-record

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a list of objects

Name
Description
recordId
The unique id of the record.
fields
List of fields that need to be updated. (description below)
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values to be updated on the field. (description below)
Fields of single rows object
Description
row
Value of the field in the given row and index.
values
Row in which the field value is contained. (description below)
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).
Request

{
  "recordId": 1822,
  "fields": [
      {
          "identifier": "ColorStandard",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": "Test Color Standard Update",
                          "valuePreview": "Test Color Standard Update"
                      }
                  ]
              }
          ]
      },
      {
          "identifier": "StandardL",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": 1,
                          "valuePreview": ""
                      }
                  ]
              }
          ]
      },
      {
          "identifier": "Standarda",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": 2,
                          "valuePreview": ""
                      }
                  ]
              }
          ]
      },
      {
          "identifier": "Standardb",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": 3,
                          "valuePreview": ""
                      }
                  ]
              }
          ]
      }
  ]
}

Description of usual responses

200 OK – Process data returned successfully.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "INSUFFICIENT_PROCESS_PRIVILEGES",
"path": "/api/v2/update-record"
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest3",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:31Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": []
                  },
                  {
                      "identifier": "Samplea",
                      "rows": []
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": []
                  },
                  {
                      "identifier": "Strength",
                      "rows": []
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": []
                  },
                  {
                      "identifier": "Observations",
                      "rows": []
                  },
                  {
                      "identifier": "Sample",
                      "rows": []
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard Update",
                              "valuePreview": "Test Color Standard Update"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 1.00000000,
                              "valuePreview": "1"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 2,
                              "valuePreview": "2"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 3,
                              "valuePreview": "3"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Add Rows

Add rows to the list of provided field group identifiers.
PUT /api/v2/add-rows

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a list of objects

Name
Description
recordId
The unique id of the record.
fieldGroupIdentifier
The unique identifier of the field group.
numberOfRowsToAdd
Number of rows to add to the field group.
Request

[
  {
      "recordId": 1822,
      "fieldGroupIdentifier": "Group4",
      "numberOfRowsToAdd": 5
  }
]

Description of usual responses

200 OK – Process data returned successfully.
400 Bad Request – Cannot add rows to Simple group.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/add-rows"
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest3",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:31Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Samplea",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": 3.7417,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": 3.7417,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": 3.7417,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": 3.7417,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": 3.7417,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Strength",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Observations",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sample",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard Update",
                              "valuePreview": "Test Color Standard Update"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 1.00000000,
                              "valuePreview": "1"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 2.00000000,
                              "valuePreview": "2"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 3.00000000,
                              "valuePreview": "3"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Delete Rows

Deletes rows from the list of provided field groups.
PUT /api/v2/delete-rows

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a list of objects

Name
Description
recordId
The unique id of the record.
fieldGroupIdentifier
The unique identifier of the field group.
rowsToDelete
Index of the rows to delete from the field group. Index is zero-based.
Request

[
  {
      "recordId": 1822,
      "fieldGroupIdentifier": "Group4",
      "rowsToDelete": [2, 3]
  }
]

Description of usual responses

200 OK – Process data returned successfully.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field group.
fields
List of fields that are a part of a field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "INSUFFICIENT_STAGE_PRIVILEGES",
"path": "/api/v2/delete-rows"
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest3",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:31Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Samplea",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Strength",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Observations",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sample",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard Update",
                              "valuePreview": "Test Color Standard Update"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 1.00000000,
                              "valuePreview": "1"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 2.00000000,
                              "valuePreview": "2"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 3.00000000,
                              "valuePreview": "3"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Clone Rows

Clones rows for the list of provided field groups in specific records.
PUT /api/v2/clone-rows

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a list of objects

Name
Description
recordId
The unique id of the record.
fieldGroupIdentifier
The unique identifier of the field group.
rowsToClone
Row numbers to clone in field group.
Request

[
  {
      "recordId": 1822,
      "fieldGroupIdentifier": "Group4",
      "rowsToClone": [1]
  }
]

Description of usual responses

200 OK – Process data returned successfully.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of the field template.
fields
List of values for the field. (description below)
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/clone-rows"
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest3",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:31Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Samplea",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": 3.7417,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Strength",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Observations",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sample",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard Update",
                              "valuePreview": "Test Color Standard Update"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 1.00000000,
                              "valuePreview": "1"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 2.00000000,
                              "valuePreview": "2"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 3.00000000,
                              "valuePreview": "3"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Reorder Rows

Reorders rows in the list of provided field groups in specific records.
PUT /api/v2/reorder-rows

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a list of objects

Name
Description
recordId
The unique id of the record.
fieldGroupIdentifier
The unique identifier of the field group.
sourceRow
Source row that is going to be reordered in field group.
targetRow
Target row that is going to switch place with source row in field group.
Request

[
  {
      "recordId": 1822,
      "fieldGroupIdentifier": "Group4",
      "sourceRow": 2,
      "targetRow": 3
  }
]

Description of usual responses

200 OK – Process data returned successfully.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of field group.
fields
List of fields that are a part of field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/reorder-rows"
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest3",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:31Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Samplea",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": -1.00000000,
                                      "valuePreview": "-1"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": -2.00000000,
                                      "valuePreview": "-2"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": -3.00000000,
                                      "valuePreview": "-3"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": 3.74170000,
                                      "valuePreview": "3.7417"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Strength",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": false,
                                      "valuePreview": "false"
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Observations",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  },
                  {
                      "identifier": "Sample",
                      "rows": [
                          {
                              "row": 0,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 1,
                              "values": [
                                  {
                                      "value": {
                                          "recordId": 1145,
                                          "name": "3% Alchemy Dispersant 190 V2",
                                          "templateName": "Formulation Coatings",
                                          "linkToRecord": "/process/106/Optional[NB-2021 - 0069 EPS 2799 Gloss/White Pastel Dry TiO2 Base]?recordId=1145"
                                      },
                                      "valuePreview": "3% Alchemy Dispersant 190 V2"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 2,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 3,
                              "values": [
                                  {
                                      "value": {
                                          "recordId": 356,
                                          "name": "A-75517 4% + TiO2 70%",
                                          "templateName": "Formulation Coatings",
                                          "linkToRecord": "/process/33/Optional[NB-2021 - 0009 High TiO2 loading paint]?recordId=356"
                                      },
                                      "valuePreview": "A-75517 4% + TiO2 70%"
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 4,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          },
                          {
                              "row": 5,
                              "values": [
                                  {
                                      "value": null,
                                      "valuePreview": ""
                                  }
                              ],
                              "errorInfo": null
                          }
                      ]
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard Update",
                              "valuePreview": "Test Color Standard Update"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 1.00000000,
                              "valuePreview": "1"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 2.00000000,
                              "valuePreview": "2"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 3.00000000,
                              "valuePreview": "3"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Read Record

Read the complete status of the record for the provided record id.
PUT /api/v2/read-record

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Query parameters

- Request sent as a parameter

Name
Description
id
Provided id of the record.
Request

Description of usual responses

200 OK – Record data retrieved successfully.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
lastUpdatedAt
Date and time when the record is last time updated
lastUpdatedBy
Principal of last User that updated the record
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of field group.
fields
List of fields that are a part of field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/reorder-rows"
}
Response

{
  "recordId": 1822,
  "name": "ColorTest3",
  "createdById": 1,
  "createdOn": "2021-09-15T12:52:31Z",
  "errorInfo": [],
  "fieldGroups": [
      {
          "identifier": "Group3",
          "fields": []
      },
      {
          "identifier": "Group4",
          "fields": [
              {
                  "identifier": "SampleL",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "Samplea",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "Sampleb",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "SampleDeltaL",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": -1.00000000,
                                  "valuePreview": "-1"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": -1.00000000,
                                  "valuePreview": "-1"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": -1.00000000,
                                  "valuePreview": "-1"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": -1.00000000,
                                  "valuePreview": "-1"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": -1.00000000,
                                  "valuePreview": "-1"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": -1.00000000,
                                  "valuePreview": "-1"
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "SampleDeltaa",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": -2.00000000,
                                  "valuePreview": "-2"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": -2.00000000,
                                  "valuePreview": "-2"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": -2.00000000,
                                  "valuePreview": "-2"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": -2.00000000,
                                  "valuePreview": "-2"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": -2.00000000,
                                  "valuePreview": "-2"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": -2.00000000,
                                  "valuePreview": "-2"
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "SampleDeltab",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": -3.00000000,
                                  "valuePreview": "-3"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": -3.00000000,
                                  "valuePreview": "-3"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": -3.00000000,
                                  "valuePreview": "-3"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": -3.00000000,
                                  "valuePreview": "-3"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": -3.00000000,
                                  "valuePreview": "-3"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": -3.00000000,
                                  "valuePreview": "-3"
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "SampleDeltaE",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": 3.74170000,
                                  "valuePreview": "3.7417"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": 3.74170000,
                                  "valuePreview": "3.7417"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": 3.74170000,
                                  "valuePreview": "3.7417"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": 3.74170000,
                                  "valuePreview": "3.7417"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": 3.74170000,
                                  "valuePreview": "3.7417"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": 3.74170000,
                                  "valuePreview": "3.7417"
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "Strength",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "Rubbed",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": false,
                                  "valuePreview": "false"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": false,
                                  "valuePreview": "false"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": false,
                                  "valuePreview": "false"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": false,
                                  "valuePreview": "false"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": false,
                                  "valuePreview": "false"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": false,
                                  "valuePreview": "false"
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "Observations",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": null,
                                  "valuePreview": ""
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              },
              {
                  "identifier": "Sample",
                  "rows": [
                      {
                          "row": 0,
                          "values": [
                              {
                                  "value": {
                                      "recordId": 356,
                                      "name": "A-75517 4% + TiO2 70%",
                                      "templateName": "Formulation Coatings",
                                      "linkToRecord": "/process/33/Optional[NB-2021 - 0009 High TiO2 loading paint]?recordId=356"
                                  },
                                  "valuePreview": "A-75517 4% + TiO2 70%"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 1,
                          "values": [
                              {
                                  "value": {
                                      "recordId": 1145,
                                      "name": "3% Alchemy Dispersant 190 V2",
                                      "templateName": "Formulation Coatings",
                                      "linkToRecord": "/process/106/Optional[NB-2021 - 0069 EPS 2799 Gloss/White Pastel Dry TiO2 Base]?recordId=1145"
                                  },
                                  "valuePreview": "3% Alchemy Dispersant 190 V2"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 2,
                          "values": [
                              {
                                  "value": {
                                      "recordId": 356,
                                      "name": "A-75517 4% + TiO2 70%",
                                      "templateName": "Formulation Coatings",
                                      "linkToRecord": "/process/33/Optional[NB-2021 - 0009 High TiO2 loading paint]?recordId=356"
                                  },
                                  "valuePreview": "A-75517 4% + TiO2 70%"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 3,
                          "values": [
                              {
                                  "value": {
                                      "recordId": 356,
                                      "name": "A-75517 4% + TiO2 70%",
                                      "templateName": "Formulation Coatings",
                                      "linkToRecord": "/process/33/Optional[NB-2021 - 0009 High TiO2 loading paint]?recordId=356"
                                  },
                                  "valuePreview": "A-75517 4% + TiO2 70%"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 4,
                          "values": [
                              {
                                  "value": {
                                      "recordId": 1577,
                                      "name": "Alchemy Paint 020",
                                      "templateName": "Formulation Coatings",
                                      "linkToRecord": "/process/210/Optional[NB-2021 - 0080 Alchemy Paints 1]?recordId=1577"
                                  },
                                  "valuePreview": "Alchemy Paint 020"
                              }
                          ],
                          "errorInfo": null
                      },
                      {
                          "row": 5,
                          "values": [
                              {
                                  "value": {
                                      "recordId": 358,
                                      "name": "A-81329 4% + TiO2 70%",
                                      "templateName": "Formulation Coatings",
                                      "linkToRecord": "/process/33/Optional[NB-2021 - 0009 High TiO2 loading paint]?recordId=358"
                                  },
                                  "valuePreview": "A-81329 4% + TiO2 70%"
                              }
                          ],
                          "errorInfo": null
                      }
                  ]
              }
          ]
      }
  ],
  "fields": [
      {
          "identifier": "ColorStandard",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": "Test Color Standard Update",
                          "valuePreview": "Test Color Standard Update"
                      }
                  ],
                  "errorInfo": null
              }
          ]
      },
      {
          "identifier": "StandardL",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": 1.00000000,
                          "valuePreview": "1"
                      }
                  ],
                  "errorInfo": null
              }
          ]
      },
      {
          "identifier": "Standarda",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": 2.00000000,
                          "valuePreview": "2"
                      }
                  ],
                  "errorInfo": null
              }
          ]
      },
      {
          "identifier": "Standardb",
          "rows": [
              {
                  "row": 0,
                  "values": [
                      {
                          "value": 3.00000000,
                          "valuePreview": "3"
                      }
                  ],
                  "errorInfo": null
              }
          ]
      }
  ],
"lastUpdatedAt": "2022-09-15T12:52:31Z",
"lastUpdatedBy": salesdirector@alchemy.cloud"
}

Find records by unique id

Reads the complete status of single or multiple records that contain provided record template id and record unique id (record name). If record template id is not present, use only record unique id.
GET /api/v2/find-records-by-unique-id

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Query parameters

- Request sent as a parameter

Name
Description
uniqueId
Provided unique id (record name) of the record.
recordTemplateIdentifier (optional)
Provided record template identifier of the record.
Request

Description of usual responses

200 OK – Record data retrieved successfully.
400 Bad Request - Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of field group.
fields
List of fields that are a part of field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Bad request response body

{
"timestamp": "2020-12-08T09:58:58.568+00:00",
"status": 400,
"error": "Bad Request",
"message": "Required String parameter 'uniqueId' is not present",
"path": "/api/v2/find-records-by-unique-id"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/find-records-by-unique-id
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest3",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:31Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": []
                  },
                  {
                      "identifier": "Samplea",
                      "rows": []
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": []
                  },
                  {
                      "identifier": "Strength",
                      "rows": []
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": []
                  },
                  {
                      "identifier": "Observations",
                      "rows": []
                  },
                  {
                      "identifier": "Sample",
                      "rows": []
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard Update",
                              "valuePreview": "Test Color Standard Update"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 1.00000000,
                              "valuePreview": "1"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 2.00000000,
                              "valuePreview": "2"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 3.00000000,
                              "valuePreview": "3"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Filter records

Filter records by formula. For example Item.Name = ‘Record A’ will retrieve all records that are named Record A.
PUT /api/v2/filter-records

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a single object

Name
Description
queryTerm
Term for filtering records. Example: Result.Name == ‘Record A’.
recordTemplateIdentifier
Name of the record template. Example: Material
drop
Number of first n results that we don’t want to include in the response.
take
Number of the last n results that we don’t want to include in the response.
lastChangedOnFrom
Date Time from which time period we want to filter results
lastChangedOnTo
Date Time to which time period we want to filter results
lastChangedBy
List of user emails who updated records most recently
Request

{
 "queryTerm": "Result.Name == 'ColorTest3'",
 "recordTemplateIdentifier": "ColorTest",
 "drop": 0,
 "take": 10
  “lastChangedOnFrom”: ”2022-07-26T08:40:39Z”,  “lastChangedOnTo”: ”2023-08-28T08:40:39Z”,“lastChangedBy”: [‘salesdirector@alchemy.cloud’]
}

Description of usual responses

200 OK – Record data retrieved successfully.
400 Bad Request - Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single records object
Description
recordId
The unique id of record.
name
Name of the record.
createdById
Id of the user that created the record.
createdOn
Date and time of record creation.
errorInfo (optional)
List of errors that occurred on record. (description below)
fieldGroups (optional)
List of field groups that record contains. (description below)
fields (optional)
List of fields that record contains, that don’t belong to any field group. (description below)
Fields of single errorInfo object
Description
errorCode
Error code.
errorMessage
Error message.
Fields of single fieldGroups object
Description
identifier
The unique identifier of field group.
fields
List of fields that are a part of field group.
Fields of single fields object
Description
identifier
The unique identifier of the field template.
rows
List of rows with values for the field. (description below)
Fields of single rows object
Description
row
Index of the given row.
values
List of the values for the field in the given row. (description below)
errorInfo (optional)
Error data for field value, if any error exists.
Fields of single values object
Description
value
The value that the field should be populated with. It should be sent in the native type of the value, e.g. text should be contained within quotation marks, decimal numbers should use JSON notation etc.
valuePreview (optional)
The preview value for the fields that can have a separate preview (e.g. link can have a preview text of ‘link’ with actual value being ‘www.google.com’).

Bad request response body

{
 "timestamp": "2020-12-08T13:18:57.159+00:00",
 "status": 400,
 "error": "Bad Request",
 "message": "JSON parse error: Unrecognized field \"ids\")",
 "path": "/api/v2/filter-records"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/filter-records
}
Response

[
  {
      "recordId": 1822,
      "name": "ColorTest3",
      "createdById": 1,
      "createdOn": "2021-09-15T12:52:31Z",
      "errorInfo": [],
      "fieldGroups": [
          {
              "identifier": "Group3",
              "fields": []
          },
          {
              "identifier": "Group4",
              "fields": [
                  {
                      "identifier": "SampleL",
                      "rows": []
                  },
                  {
                      "identifier": "Samplea",
                      "rows": []
                  },
                  {
                      "identifier": "Sampleb",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaL",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaa",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltab",
                      "rows": []
                  },
                  {
                      "identifier": "SampleDeltaE",
                      "rows": []
                  },
                  {
                      "identifier": "Strength",
                      "rows": []
                  },
                  {
                      "identifier": "Rubbed",
                      "rows": []
                  },
                  {
                      "identifier": "Observations",
                      "rows": []
                  },
                  {
                      "identifier": "Sample",
                      "rows": []
                  }
              ]
          }
      ],
      "fields": [
          {
              "identifier": "ColorStandard",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": "Test Color Standard Update",
                              "valuePreview": "Test Color Standard Update"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "StandardL",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 1.00000000,
                              "valuePreview": "1"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standarda",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 2.00000000,
                              "valuePreview": "2"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          },
          {
              "identifier": "Standardb",
              "rows": [
                  {
                      "row": 0,
                      "values": [
                          {
                              "value": 3.00000000,
                              "valuePreview": "3"
                          }
                      ],
                      "errorInfo": null
                  }
              ]
          }
      ]
  }
]

Find Records Request

Filter records by formula. For example Item.Name = ‘Record A’ will retrieve all records id where are named Record A.
PUT /core/api/v2/find-records

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a two parameters

Name
Description
queryTerm
Term for filtering records. Example: Result.Name == ‘Record A’.
recordTemplateIdentifier
Name of the record template. Example: Material
lastChangedOnFrom
Date Time from which time period we want to filter results
lastChangedOnTo
Date Time to which time period we want to filter results
lastChangedBy
List of user emails who updated records most recently
Request

{
 "queryTerm": "Result.Name == 'ColorTest3'",
 "recordTemplateIdentifier": "ColorTest",
 “lastChangedOnFrom”: ”2022-07-26T08:40:39Z”,
 “lastChangedOnTo”: ”2023-08-28T08:40:39Z”,
 “lastChangedBy”: [“example@alchemy.cloud”]
}

Description of usual responses

200 OK – Record data retrieved successfully.
400 Bad Request - Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

Fields of single records object
Description
recordId
The unique list of the records id’s.

Bad request response body

{
 "timestamp": "2020-12-08T13:18:57.159+00:00",
 "status": 400,
 "error": "Bad Request",
 "message": "JSON parse error: Unrecognized field \"ids\")",
 "path": "/api/v2/findRecordsRequest"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/findRecordsRequest
}
Response

{
 "response": [
   "id of FirstRecord",
   "id of SecondRecord"
 ]
}

Completable Tasks

A list of tasks that can currently be completed by this user.
GET /api/v2/my-completable-tasks

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json
Request

Description of usual responses

200 OK – Tasks that can be completed, retrieved successfully.
400 Bad Request - Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single tasks object
Description
id
The unique id of the task.
subject (optional)
Subject of the task.
description (optional)
Description of the task.
taskState
Current task state. Can be none, pending or overdue.
plannedStart
Date and time of the planned start of the task.
completionTarget
Completion target date and time of the task.
startedOn (optional)
Starting date and time of the task.
completedOn (optional)
Completion date and time of the task.
score (optional)
Score of the task.
assigneesId (optional)
List of user ids that are assigned to the task.

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/my-completable-todo-tasks
}
Response

[
  {
      "id": 2,
      "subject": "Manage Opportunity",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-02-02T17:11:52Z",
      "completionTarget": "2021-02-03T01:11:52Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 16,
      "subject": "Manage Opportunity",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-02-21T20:31:08Z",
      "completionTarget": "2021-02-22T04:31:08Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 33,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-11T06:42:00Z",
      "completionTarget": "2021-03-11T14:42:00Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 36,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-11T14:12:55Z",
      "completionTarget": "2021-03-11T22:12:55Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 38,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-15T13:42:38Z",
      "completionTarget": "2021-03-15T21:42:38Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 40,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-16T14:17:57Z",
      "completionTarget": "2021-03-16T22:17:57Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 41,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-16T14:19:14Z",
      "completionTarget": "2021-03-16T22:19:14Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 47,
      "subject": "Plan the project and assign resources",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-17T09:28:29Z",
      "completionTarget": "2021-03-17T17:28:29Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 48,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-17T18:51:08Z",
      "completionTarget": "2021-03-25T02:51:08Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 50,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-03-22T12:41:57Z",
      "completionTarget": "2021-03-22T20:41:57Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 56,
      "subject": "Submit Evaluation Results",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-04-23T10:58:37Z",
      "completionTarget": "2021-05-31T18:58:37Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 61,
      "subject": "Review Test Design",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-04-28T08:29:27Z",
      "completionTarget": "2021-04-28T16:29:27Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 68,
      "subject": "Please evaluate the External Exposure",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-05-10T14:36:14Z",
      "completionTarget": "2021-05-10T22:36:14Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 116,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-05-19T12:05:47Z",
      "completionTarget": "2021-05-19T20:05:47Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 117,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-05-21T13:08:03Z",
      "completionTarget": "2021-05-21T21:08:03Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 128,
      "subject": "Define NPD Concept",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-05-25T08:27:30Z",
      "completionTarget": "2021-05-25T16:27:30Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 173,
      "subject": "Add Materail Info",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-06-08T16:52:04Z",
      "completionTarget": "2021-06-09T00:52:04Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 174,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-06-08T18:02:20Z",
      "completionTarget": "2021-07-31T02:02:20Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 195,
      "subject": "Make corrections",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-06-15T08:54:22Z",
      "completionTarget": "2021-06-15T16:54:22Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 197,
      "subject": "Perform tests according to the requirements",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-06-15T09:06:24Z",
      "completionTarget": "2021-06-15T17:06:24Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 201,
      "subject": "Perform tests according to the requirements",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-06-15T09:08:45Z",
      "completionTarget": "2021-06-15T17:08:45Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 216,
      "subject": "Add Materail Info",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-06-17T18:44:12Z",
      "completionTarget": "2021-06-18T02:44:12Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 295,
      "subject": "Fill in the Complaint Form",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-06-28T07:36:14Z",
      "completionTarget": "2021-06-28T15:36:14Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 359,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-07-09T14:32:26Z",
      "completionTarget": "2021-07-09T22:32:26Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 361,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-07-10T15:35:01Z",
      "completionTarget": "2021-07-10T23:35:01Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 362,
      "subject": "Do the work",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-07-10T15:40:43Z",
      "completionTarget": "2021-07-10T23:40:43Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 367,
      "subject": "Perform Technical Assessment",
      "description": "",
      "taskState": "OVERDUE",
      "plannedStart": "2021-07-14T16:07:17Z",
      "completionTarget": "2021-07-15T00:07:17Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 370,
      "subject": "Complete the technical scope for IM - 003 / Fire Retardants Additives",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-07-14T16:11:31Z",
      "completionTarget": "2021-07-15T00:11:31Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 402,
      "subject": "Fill in the Project Request",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-08-09T09:47:12Z",
      "completionTarget": "2021-08-09T17:47:12Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 406,
      "subject": "Fill in the Work Plan",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-08-09T10:01:51Z",
      "completionTarget": "2021-08-09T18:01:51Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 413,
      "subject": "Fill in the Work Plan",
      "description": " ",
      "taskState": "OVERDUE",
      "plannedStart": "2021-08-11T04:46:04Z",
      "completionTarget": "2021-08-11T12:46:04Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 421,
      "subject": "Do the work",
      "description": "",
      "taskState": "NONE",
      "plannedStart": "2021-09-15T10:51:27Z",
      "completionTarget": "2021-09-15T18:51:27Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 422,
      "subject": "Do the work",
      "description": "",
      "taskState": "NONE",
      "plannedStart": "2021-09-15T10:57:20Z",
      "completionTarget": "2021-09-15T18:57:20Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  },
  {
      "id": 423,
      "subject": "Do the work",
      "description": "",
      "taskState": "NONE",
      "plannedStart": "2021-09-15T12:50:20Z",
      "completionTarget": "2021-09-15T20:50:20Z",
      "startedOn": null,
      "completedOn": null,
      "score": null,
      "assignees": [
          {
              "id": 1,
              "firstName": "John",
              "lastName": "Doe",
              "email": "john-doe@alchemy.cloud"
          }
      ]
  }
]

Start Task

Starts a task for provided task id.
PUT /api/v2/start-task

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a single object

Name
Description
id
Provided id of the task.
Request

{
  "id": 423
}

Description of usual responses

200 OK – Task started successfully.
400 Bad Request - Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

List of parameters below

Fields of single tasks object
Description
id
The unique id of the task.
subject (optional)
Subject of the task.
description (optional)
Description of the task.
taskState
Current task state. Can be none, pending or overdue.
plannedStart
Date and time of the planned start of the task.
completionTarget
Completion target date and time of the task.
startedOn (optional)
Starting date and time of the task.
completedOn (optional)
Completion date and time of the task.
score (optional)
Score of the task.
assigneesId (optional)
List of user ids that are assigned to the task.

Bad request response body

{
 "timestamp": "2020-12-08T13:18:57.159+00:00",
 "status": 400,
 "error": "Bad Request",
 "message": "JSON parse error: Unrecognized field \"ids\")",
 "path": "/api/v2/start-task"
}
{
 "timestamp": "2020-12-08T13:17:31.449+00:00",
 "status": 400,
 "error": "Bad Request",
 "message": "Task with id: 99999999 does not exist.",
 "path": "/api/v2/start-task"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/start-task
}
Response

{
  "id": 423,
  "subject": "Do the work",
  "description": "",
  "taskState": "NONE",
  "plannedStart": "2021-09-15T12:50:20Z",
  "completionTarget": "2021-09-15T20:50:20Z",
  "startedOn": "2021-09-15T13:17:30Z",
  "completedOn": null,
  "score": null,
  "assignees": [
      {
          "id": 1,
          "firstName": "John",
          "lastName": "Doe",
          "email": "john-doe@alchemy.cloud"
      }
  ]
}

Reports

Read Report Results

Reads a report for provided report id.
GET /api/v2/read-report-results-connector

Headers

Name
Description
Authorization
Content-Type
Bearer {access token}
application/json

Request Details

- Request sent as a report identifier as a parameter

Name
Description
reportId
Provided id of the report.
Request

{
  "ReportId": 123
}

Description of usual responses

200 OK – Report data returned successfully.
400 Bad Request - Invalid parameters supplied.
401 Unauthorized – User is unauthorized to do this action.

Response Details

Name
Description
headers
List of report headers. (description below)
gridResultRows
List of report results. (description below)
Headers
Description
fieldId
Report column id.
fieldName
Report column name.
nodeName
Report node name to which the report column belongs.
GridResultRows
Description
row
Row number.
values
List of row results. (description below)
Values
Description
fieldId
Report column id.
value
Id (if exists) or link off the value that is previewed.
preview
The preview of the value (String). (e.g. record can have a preview of “Record A” with value being 132 (record Id) or link can have a preview text of “link” with actual value being ‘www.google.com’).

Bad request response body

{
   "timestamp": "2022-08-24T16:11:14.282+00:00",
   "status": 400,
   "error": "Bad Request",
   "message": "Required request parameter 'reportId' for method parameter type Long is not present",
   "path": "/api/v2/read-report-results-connector"
}
{
   "timestamp": "2022-08-24T16:18:10.949+00:00",
   "status": 400,
   "error": "Bad Request",
   "message": "Report with id: 333 does not exists.",
   "path": "/api/v2/read-report-results-connector"
}

Unauthorized response body

{
"timestamp": "2020-11-09T11:55:45.818+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v2/read-report-results-connector
}
Response

{
  "headers": [
      {
          "fieldId": 169,
          "fieldName": "NAME",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 170,
          "fieldName": "PROCESS_TEMPLATES",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 171,
          "fieldName": "STATUS",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 172,
          "fieldName": "PRIORITY",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 173,
          "fieldName": "CURRENT_STAGES",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 174,
          "fieldName": "DURATION",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 175,
          "fieldName": "CREATED_ON",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 176,
          "fieldName": "COMPLETED_BY",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 177,
          "fieldName": "COMPLETED_ON",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 178,
          "fieldName": "FOLLOWED",
          "nodeName": "ALL_PROCESSES"
      },
      {
          "fieldId": 179,
          "fieldName": "TOTAL_EFFORT_SPENT",
          "nodeName": "ALL_PROCESSES"
      }
  ],
  "gridResultRows": [
      {
          "row": 0,
          "values": [
              {
                  "fieldId": 169,
                  "value": "3",
                  "preview": "Untitled"
              },
              {
                  "fieldId": 170,
                  "value": null,
                  "preview": "Test Bound"
              },
              {
                  "fieldId": 171,
                  "value": null,
                  "preview": "IN_PROGRESS"
              },
              {
                  "fieldId": 172,
                  "value": null,
                  "preview": "3"
              },
              {
                  "fieldId": 173,
                  "value": null,
                  "preview": "Stage 1"
              },
              {
                  "fieldId": 174,
                  "value": null,
                  "preview": "0"
              },
              {
                  "fieldId": 175,
                  "value": null,
                  "preview": "1661353031000"
              },
              {
                  "fieldId": 176,
                  "value": null,
                  "preview": ""
              },
              {
                  "fieldId": 177,
                  "value": null,
                  "preview": ""
              },
              {
                  "fieldId": 178,
                  "value": null,
                  "preview": "true"
              },
              {
                  "fieldId": 179,
                  "value": null,
                  "preview": "0"
              }
          ]
      },
      {
          "row": 1,
          "values": [
              {
                  "fieldId": 169,
                  "value": "5",
                  "preview": "Untitled"
              },
              {
                  "fieldId": 170,
                  "value": null,
                  "preview": "Test Records"
              },
              {
                  "fieldId": 171,
                  "value": null,
                  "preview": "IN_PROGRESS"
              },
              {
                  "fieldId": 172,
                  "value": null,
                  "preview": "1"
              },
              {
                  "fieldId": 173,
                  "value": null,
                  "preview": "Stage 1"
              },
              {
                  "fieldId": 174,
                  "value": null,
                  "preview": "0"
              },
              {
                  "fieldId": 175,
                  "value": null,
                  "preview": "1661353034000"
              },
              {
                  "fieldId": 176,
                  "value": null,
                  "preview": ""
              },
              {
                  "fieldId": 177,
                  "value": null,
                  "preview": ""
              },
              {
                  "fieldId": 178,
                  "value": null,
                  "preview": "true"
              },
              {
                  "fieldId": 179,
                  "value": null,
                  "preview": "0"
              }
          ]
      }
  ]
}