AuditDashboard Developer Portal
  1. Engagements
AuditDashboard Developer Portal
  • AuditDashboard Developer Portal
  • Clients
    • Get All Clients
      GET
    • Create Clients
      POST
    • Update Clients
      PUT
    • Deactivate Clients
      DELETE
    • Activate Clients
      PATCH
    • Client Details
      GET
    • Update Client
      PUT
    • Deactivate Client
      DELETE
    • Activate Client
      PATCH
  • Divisions
    • Get Active Divisions
      GET
  • Engagements
    • Get Engagements by Status
      GET
    • Create Engagements
      POST
    • Update Engagement
      PUT
    • Update Engagement Statuses
      PATCH
    • Delete Engagements
      DELETE
    • Get Engagement Details
      GET
    • Update Engagement
      PUT
    • Update Engagement Status
      PATCH
    • Delete Engagement
      DELETE
    • Download Engagement Documents
      GET
    • Download Engagement Request Report
      GET
    • Download 'All Engagements' Report
      GET
  • Insights
    • Get Engagement Activity Log Parameters
      GET
    • Engagement Activity Log
      POST
    • Get Engagement by Last Activity Report Parameters
      GET
    • Engagement by Last Activity
      POST
    • Get Active Professional Users for Schedule
      GET
    • Schedule
      POST
    • User Activity and Status
      POST
  • Requests
    • Get Engagement Requests
    • Get Request by ID
    • Update Request Details
    • Update Request Status and Priority
    • Delete Request
    • Create Requests
    • Update Multiple Requests
    • Update Request Status and Priority
    • Delete Multiple Requests
    • Get Request History Feed
    • Get Request Activity Feed
    • Add Comment to Request
    • Delete a Request Comment
    • Delete a Request Document
    • Download Request Documents
    • Update Multiple Request Restrictions
    • Update Single Request Restrictions
    • Upload Request Document
  • Users
    • Get Users by Status
    • Create Users
    • Update Multiple Users
    • Deactivate Users
    • Activate Users
    • Get User Details
    • Update User Details
    • Deactivate User
    • Activate User
    • Invite Users
    • Generate User Activity Report
  • Authorization
    • Authorization call for Bearer Token
  • Trash
    • Get Trash Types
    • Get Trash List
    • Restore Trash Items
    • Permanently deletes trash items.
    • Restore a Trash Item
    • Permanently deletes a trash item.
  1. Engagements

Create Engagements

POST
/api/public/engagements
Engagements
Creates one or more new engagements.
Required fields: CompanyID, DivisionID, and Title.

Request

Body Params application/json
array of:
CompanyID
integer <int32>
optional
Sets the identifier for the company associated with the engagement.
OfficeID
integer <int32>
optional
Sets the identifier for the office associated with the engagement.
DivisionID
integer <int32> | null 
optional
Sets the identifier for the division associated with the engagement.
Title
string  | null 
optional
Sets the title of the engagement.
Code
string  | null 
optional
Sets the code of the engagement.
Type
string  | null 
optional
Sets the type of the engagement.
Period
string  | null 
optional
Sets the period of the engagement.
Year
integer <int32> | null 
optional
Sets the year of the engagement.
StartDate
string <date-time> | null 
optional
Sets the start date of the engagement.
DueDate
string <date-time> | null 
optional
Sets the due date of the engagement.
OwnerID
integer <int32> | null 
optional
Sets the identifier for the owner of the engagement.
Status
enum<integer> <int32>
optional
Allowed values:
0110-100-5
ProfessionalUsers
array[object (APIEngagementUser) {2}]  | null 
optional
Sets the dictionary of professional users associated with the engagement.
The key is the user ID and the value is an optional role identifier.
UserID
integer <int32>
optional
RoleID
integer <int32>
optional
ClientUsers
array[object (APIEngagementUser) {2}]  | null 
optional
Sets the dictionary of client users associated with the engagement.
The key is the user ID and the value is an optional role identifier.
UserID
integer <int32>
optional
RoleID
integer <int32>
optional
Example
[
    {
        "CompanyID": 0,
        "OfficeID": 0,
        "DivisionID": 0,
        "Title": "string",
        "Code": "string",
        "Type": "string",
        "Period": "string",
        "Year": 0,
        "StartDate": "2019-08-24T14:15:22Z",
        "DueDate": "2019-08-24T14:15:22Z",
        "OwnerID": 0,
        "Status": 0,
        "ProfessionalUsers": [
            {
                "UserID": 0,
                "RoleID": 0
            }
        ],
        "ClientUsers": [
            {
                "UserID": 0,
                "RoleID": 0
            }
        ]
    }
]

Responses

🟢201Created
Created: Engagements were successfully created.
This response does not have a body.
🟠400Bad Request
🟠401Unauthorized
Modified at 2025-03-24 12:24:39
Previous
Get Engagements by Status
Next
Update Engagement
Built with