Unifize Knowledge Base
  • Quickstart
    • Welcome to Unifize!
  • Getting started
    • Setting up your Unifize account
      • Signing up with invite link
      • Logging in with email
    • Quickstart demo
    • Key features & navigation
      • Records
      • Conversations
      • Checklists
    • First steps for new users
      • Creating a new record
      • Creating records from inbound email
      • Filling checklist metadata
      • Linking related records
      • Sharing conversations as email
      • Sending and receiving emails in Unifize
      • Inviting people
      • Changing your preferred language
      • Filtering records in My Inbox
      • Generating PDF reports
      • Creating custom reports
      • Creating custom dashboards
    • Using Unifize AI
  • Troubleshooting & support guide
  • User Guide
    • Definitions
      • Process
      • Record
      • Conversation
      • Report
      • Chart
      • Checklist
      • Org
    • Navigating the platform
      • Profile
      • My Inbox
      • Manage
      • Homescreen
      • Contacts
      • Direct Messages
      • Dashboard
    • Data & process management
      • File Management
      • Checklists & Forms
      • Rich text in checklist
      • Working with records
        • Due dates & priorities of a record
    • User & role management
      • Understanding roles & access
      • Managing permissions
      • Deactivating users
      • Team & organization
    • Mobile & web accessibility
      • Unifize Lite
      • Mobile app
      • Web app vs Unifize Lite
    • Security, compliance & infrastructure
    • Personalizations
      • Set your profile picture
      • Reset your Passwords
      • Customizing Homescreen
      • Set your email notification preferences
    • File upload
      • SharePoint
        • Configuring SharePoint on Unifize
        • Using SharePoint on Unifize
    • SSO
      • Logging in with SSO
      • SSO using SAML
    • Process Builder
      • Checklist
        • Picklist
          • Picklist field in Checklist
  • Product Help
    • Unifize Document Management System (DMS)
      • Document Control
      • Change Control
      • Training Management
      • Onboarding guide for DMS
      • Troubleshooting & support guide for DMS
  • Admin Guide
    • Multi-language translation support
      • Enabling and configuring language support
      • Managing user language preferences at scale
      • Using the translation editor to customize UI
    • Customization & configuration
      • Configuring processes
      • Configuring revision fields
      • Configuring approval workflows
      • Configuring reminders on processes
      • Checklist layout settings
      • Custom language settings
      • Creating a chart from reports
      • Configuring Microsoft Office 365
        • Permissions required for SharePoint
  • Developer Documentation
    • Introduction
      • Concepts & terminologies
    • Authentication
      • App management
      • App tokens
    • Usage
      • Fair usage policy
      • Testing environment
      • Quickstart
    • API Reference
      • Applications
      • Processes
      • Records
      • Field values
  • RELEASE NOTES
    • February 2025
    • March 2025
    • April 2025
      • Rich Text Fields in Checklist
      • Filling Checklist Metadata with AI
      • 'My Conversations' is now 'My Inbox'
      • Feature Enhancements
Powered by GitBook
On this page
Export as PDF
  1. Developer Documentation
  2. API Reference

Records

PreviousProcessesNextField values

Last updated 1 month ago

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
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
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
}
  • GETGet all records
  • GETGet record
  • POSTCreate record
  • PATCHUpdate record

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
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": "abrar.ahmed@unifize.com",
    "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": "abrar.ahmed@unifize.com",
      "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
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": "abrar.ahmed@unifize.com",
    "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": "abrar.ahmed@unifize.com",
      "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
}