Records

Get all records

get

Responses

200

Success

application/json

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

GET /chatroom HTTP/1.1
Host: 
Accept: */*

[
  {
    "message": "Message",
    "owner": "<uuid>",
    "updatedAt": "2024-01-04T06:39:58.231Z",
    "whitelistedGroups": "example",
    "lastMessage": "Last",
    "versionCount": 1,
    "priority": "normal",
    "statusTitle": "Pending",
    "privacy": "none",
    "age": 24.9,
    "createdAt": "2024-01-04T06:39:58.141Z",
    "members": [
      "<uuid1>",
      "<uuid2>"
    ],
    "parent": "parent",
    "relatedConversations": {
      "count": 0,
      "parent": 25,
      "children": [
        12,
        34
      ],
      "fosterParents": [
        11,
        21
      ],
      "fosterChildren": [
        13,
        47
      ]
    },
    "whitelist": null,
    "id": 181,
    "privacySettings": "settings",
    "count": 0,
    "completedAt": "<TIME>",
    "originSeqNo": 46,
    "creator": "<uuid>",
    "originChatroomId": 11,
    "reminders": null,
    "currentVersion": true,
    "autoNo": "46",
    "archived": true,
    "seqNo": 46,
    "address": "75E4R6EQM",
    "derivedTitle": "Approval Test #46: title",
    "status": -1,
    "processWhitelistGroups": "example",
    "versionComment": "example",
    "lastMessageAuthor": "unibot",
    "processTitle": "Approval Test",
    "title": "TItle",
    "type": "workflow",
    "childCount": 0,
    "version": 1,
    "meta": "example",
    "completedBy": "<uuid>",
    "memberCount": 1,
    "dueDate": null,
    "active": true,
    "templateId": 33,
    "outcome": "example",
    "breadcrumbs": "example",
    "orgId": 1,
    "processWhitelist": "example",
    "description": "description",
    "canceled": false
  }
]

Get record

get

Path parameters

idintegerRequired

ID of the chatroom

Example: 12

Responses

200

Success

application/json

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

GET /chatroom/{id} HTTP/1.1
Host: 
Accept: */*

{
  "message": "Message",
  "owner": "<uuid>",
  "updatedAt": "2024-01-04T06:39:58.231Z",
  "whitelistedGroups": "example",
  "lastMessage": "Last",
  "versionCount": 1,
  "priority": "normal",
  "statusTitle": "Pending",
  "privacy": "none",
  "age": 24.9,
  "createdAt": "2024-01-04T06:39:58.141Z",
  "members": [
    "<uuid1>",
    "<uuid2>"
  ],
  "parent": "parent",
  "relatedConversations": {
    "count": 0,
    "parent": 25,
    "children": [
      12,
      34
    ],
    "fosterParents": [
      11,
      21
    ],
    "fosterChildren": [
      13,
      47
    ]
  },
  "whitelist": null,
  "id": 181,
  "privacySettings": "settings",
  "count": 0,
  "completedAt": "<TIME>",
  "originSeqNo": 46,
  "creator": "<uuid>",
  "originChatroomId": 11,
  "reminders": null,
  "currentVersion": true,
  "autoNo": "46",
  "archived": true,
  "seqNo": 46,
  "address": "75E4R6EQM",
  "derivedTitle": "Approval Test #46: title",
  "status": -1,
  "processWhitelistGroups": "example",
  "versionComment": "example",
  "lastMessageAuthor": "unibot",
  "processTitle": "Approval Test",
  "title": "TItle",
  "type": "workflow",
  "childCount": 0,
  "version": 1,
  "meta": "example",
  "completedBy": "<uuid>",
  "memberCount": 1,
  "dueDate": null,
  "active": true,
  "templateId": 33,
  "outcome": "example",
  "breadcrumbs": "example",
  "orgId": 1,
  "processWhitelist": "example",
  "description": "description",
  "canceled": false
}

Create record

post

Body

titlestringOptional

Title

Example: Purchase

typestringOptional

Type

Example: workflow

ownerstringOptional

User ID of the owner

Example: Q79THCOJ5CcvWRMPeIVZiq1ezu42

membersstring[]Optional

List of user IDs

Example: ["Q79THCOJ5CcvWRMPeIVZiq1ezu42"]

groupsinteger[]Optional

List of group IDs

Example: [26]

templateIdintegerRequired

ID of the process

Example: 33

descriptionstringOptional

Description

Example: For purchase order

privacystringOptional

Privacy

Example: none

Responses

200

Success

application/json

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /chatroom HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 202

{
  "title": "Purchase",
  "type": "workflow",
  "owner": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "members": [
    "Q79THCOJ5CcvWRMPeIVZiq1ezu42"
  ],
  "groups": [
    26
  ],
  "templateId": 33,
  "description": "For purchase order",
  "privacy": "none"
}

{
  "message": "Message",
  "owner": {
    "departmentName": "Engineer",
    "department": 22,
    "orgRole": "admin",
    "lastLogin": "2024-02-02T04:17:21.859Z",
    "displayName": "Abrar Ahmed",
    "email": "[e-mail]",
    "emailVerified": true,
    "uid": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "joinDate": "2023-06-11",
    "passwordNotSet": false,
    "inviteDate": "2023-06-11",
    "orgRoleId": 2,
    "phoneNumber": "9999988888",
    "photoUrl": "<url>",
    "disabled": false,
    "orgId": 1,
    "invitePending": false
  },
  "updatedAt": "2024-02-02T04:29:09.335Z",
  "whitelistedGroups": [
    "Group1",
    "Group2"
  ],
  "lastMessage": "Completed",
  "versionCount": 1,
  "priority": "normal",
  "statusTitle": "Pending",
  "privacy": "none",
  "age": 0,
  "createdAt": "2024-02-02T04:29:09.182Z",
  "members": [
    {
      "departmentName": "Engineer",
      "department": 22,
      "orgRole": "admin",
      "lastLogin": "2024-02-02T04:17:21.859Z",
      "displayName": "Abrar Ahmed",
      "email": "[e-mail]",
      "emailVerified": true,
      "uid": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
      "joinDate": "2023-06-11",
      "passwordNotSet": false,
      "inviteDate": "2023-06-11",
      "orgRoleId": 2,
      "phoneNumber": "9999988888",
      "photoUrl": "<url>",
      "disabled": false,
      "orgId": 1,
      "invitePending": false
    }
  ],
  "parent": 11,
  "relatedConversations": {
    "count": 1,
    "parent": 12,
    "children": [
      12,
      33
    ],
    "fosterParents": [
      11,
      31
    ],
    "fosterChildren": [
      12,
      33
    ]
  },
  "whitelist": [
    "UID1",
    "UID2"
  ],
  "id": 208,
  "files": [
    {
      "description": "New file",
      "fileId": 20
    }
  ],
  "privacySettings": {},
  "count": 0,
  "completedAt": "2024-02-02T04:17:21.859Z",
  "originSeqNo": 61,
  "creator": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "originChatroomId": 11,
  "reminders": {},
  "currentVersion": true,
  "autoNo": "61",
  "archived": false,
  "seqNo": 61,
  "address": "Y1GW0PGZK",
  "derivedTitle": "Approval Test #61: New-chatroom",
  "status": -1,
  "checklists": [
    {
      "id": 45
    }
  ],
  "processWhitelistGroups": [
    "text"
  ],
  "versionComment": "Comment",
  "lastMessageAuthor": "unibot",
  "processTitle": "Approval Test",
  "title": "New-chatroom",
  "type": "workflow",
  "childCount": 0,
  "processOwners": [
    "text"
  ],
  "version": 1,
  "meta": "Meta Information",
  "completedBy": "UID",
  "memberCount": 2,
  "dueDate": "2023-01-22",
  "active": true,
  "groupMembers": {},
  "templateId": 33,
  "outcome": "text",
  "breadcrumbs": "text",
  "groups": [
    "text"
  ],
  "orgId": 1,
  "processWhitelist": [
    "text"
  ],
  "description": "text",
  "canceled": false
}

Update record

patch

Path parameters

idintegerRequired

ID

Example: 12

Body

titlestringOptional

Title

Example: Andromeda

due-datestringOptional

Due date as an ISO timestamp

Example: 2025-02-27T18:30:00.000Z

ownerstringOptional

User ID

Example: Q79THCOJWRMPeIVZiq1e42

descriptionstringOptional

Description

Example: abc

parentintegerOptional

Parent ID

Example: 10

prioritystringOptional

Priority

Example: high

privacystringOptional

Privacy

Example: content

statusintegerOptional

Status ID

Example: -2

commentstringOptional

Additional comment (used when updating the status)

Example: Completed

archivedbooleanOptional

Archive record

Example: true

remindersbooleanOptional

Toggle reminders

Example: true

unreadbooleanOptional

Clear unread count for user (use false to clear)

Example: false

currentVersionbooleanOptional

Mark as current revision

Example: true

versionCommentstringOptional

Adds comment when marking as current

Example: This is the new version!

Responses

200

Success

application/json

401

Authentication / Authorization error

application/json

404

Not Found

application/json

500

Internal server error

application/json

patch

HTTPcURLJavaScriptPython

PATCH /chatroom/{id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 310

{
  "title": "Andromeda",
  "due-date": "2025-02-27T18:30:00.000Z",
  "owner": "Q79THCOJWRMPeIVZiq1e42",
  "description": "abc",
  "parent": 10,
  "priority": "high",
  "privacy": "content",
  "status": -2,
  "comment": "Completed",
  "archived": true,
  "reminders": true,
  "unread": false,
  "currentVersion": true,
  "versionComment": "This is the new version!"
}

{
  "message": "Message",
  "owner": {
    "departmentName": "Engineer",
    "department": 22,
    "orgRole": "admin",
    "lastLogin": "2024-02-02T04:17:21.859Z",
    "displayName": "Abrar Ahmed",
    "email": "[e-mail]",
    "emailVerified": true,
    "uid": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
    "joinDate": "2023-06-11",
    "passwordNotSet": false,
    "inviteDate": "2023-06-11",
    "orgRoleId": 2,
    "phoneNumber": "9999988888",
    "photoUrl": "<url>",
    "disabled": false,
    "orgId": 1,
    "invitePending": false
  },
  "updatedAt": "2024-02-02T04:29:09.335Z",
  "whitelistedGroups": [
    "Group1",
    "Group2"
  ],
  "lastMessage": "Completed",
  "versionCount": 1,
  "priority": "normal",
  "statusTitle": "Pending",
  "privacy": "none",
  "age": 0,
  "createdAt": "2024-02-02T04:29:09.182Z",
  "members": [
    {
      "departmentName": "Engineer",
      "department": 22,
      "orgRole": "admin",
      "lastLogin": "2024-02-02T04:17:21.859Z",
      "displayName": "Abrar Ahmed",
      "email": "[e-mail]",
      "emailVerified": true,
      "uid": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
      "joinDate": "2023-06-11",
      "passwordNotSet": false,
      "inviteDate": "2023-06-11",
      "orgRoleId": 2,
      "phoneNumber": "9999988888",
      "photoUrl": "<url>",
      "disabled": false,
      "orgId": 1,
      "invitePending": false
    }
  ],
  "parent": 11,
  "relatedConversations": {
    "count": 1,
    "parent": 12,
    "children": [
      12,
      33
    ],
    "fosterParents": [
      11,
      31
    ],
    "fosterChildren": [
      12,
      33
    ]
  },
  "whitelist": [
    "UID1",
    "UID2"
  ],
  "id": 208,
  "files": [
    {
      "description": "New file",
      "fileId": 20
    }
  ],
  "privacySettings": {},
  "count": 0,
  "completedAt": "2024-02-02T04:17:21.859Z",
  "originSeqNo": 61,
  "creator": "Q79THCOJ5CcvWRMPeIVZiq1ezu42",
  "originChatroomId": 11,
  "reminders": {},
  "currentVersion": true,
  "autoNo": "61",
  "archived": false,
  "seqNo": 61,
  "address": "Y1GW0PGZK",
  "derivedTitle": "Approval Test #61: New-chatroom",
  "status": -1,
  "checklists": [
    {
      "id": 45
    }
  ],
  "processWhitelistGroups": [
    "text"
  ],
  "versionComment": "Comment",
  "lastMessageAuthor": "unibot",
  "processTitle": "Approval Test",
  "title": "New-chatroom",
  "type": "workflow",
  "childCount": 0,
  "processOwners": [
    "text"
  ],
  "version": 1,
  "meta": "Meta Information",
  "completedBy": "UID",
  "memberCount": 2,
  "dueDate": "2023-01-22",
  "active": true,
  "groupMembers": {},
  "templateId": 33,
  "outcome": "text",
  "breadcrumbs": "text",
  "groups": [
    "text"
  ],
  "orgId": 1,
  "processWhitelist": [
    "text"
  ],
  "description": "text",
  "canceled": false
}