API Notes from Release Notes (Tracking Changes from Jan 2022)

• API users will no longer be enforced for MFA.
• • If your tenant has "Require MFA for non-SSO users" set to "Yes", the API user will be able to generate the access token.

• V1 API -Document update for PUT https://server_name/api/servicedesk/tickets/{id}-
  • Queue Id or Primary Assignee Id is required (one is required)
  • Primary Assignee Id or Queue Id is required (one is required)

V2 API

Additional endpoints listed below are added to our V2 APIs.

• GET /v2/crm/accounts/summary/{id} is added. This endpoint returns one account record from the CRM with the matching identifier (Id).
• GET /v2/crm/contacts/summary/{Id} is added. This endpoint returns one contact with emails and phones in the CRM with the matching identifier (Id).

V2 API - Document Update

Lookups are now added to API V2 documentation. This link shows the table names that can be used for the Lookup Endpoints. 

Finance/

System

V2 API

Additional endpoints listed below are added to our V2 APIs.

• GET /v2/finance/invoices/{id}} is added. This endpoint returns one invoice object for the matching identifier (Id).
• GET /v2/finance/invoices/summary is added. This endpoint returns a list of all the invoices.
• POST /v2/finance/invoices/details is added. This endpoint returns an array list of Invoice Details.
• POST /v2/system/tenantlookup/{tableName} is added. This endpoint will accept one object of type lookup for the table name used.

V2 API 

Additional endpoints listed below are added to our V2 APIs.

• Change Invoice Status
  
  • PATCH /v2/finance/invoices/marksent is added. This endpoint provides the ability to change the status of invoice(s) from ready to send to sent.
  • This is applicable only to invoices of status ”ready to send” and no pdf/invoices will be generated.
• GET /v2/crm/opportunities/summary/{id} is added. This endpoint is used to load one opportunity based on a supplied id.
• GET /v2/crm/opportunities. This endpoint is used to load all opportunities with the ability to filter and sort, and support for paging the result.
• PUT /crm/opportunities/{id}. This endpoint is used to update an existing opportunity with the matching identifier {id}.
• POST /v2/crm/opportunities is added. This endpoint is used to create a new Opportunity.
• GET v2/time/timelogs is added. This endpoint returns the list of all Time logs

V1 API 

•  /api/crm/servicequotations supports free items when adding or updating a Service Quotation.

V2 API

GET /v2/crm/quotes/{quotationId} results now include

• SalesRepresentativeId
• SalesRepresentativeName

V2 API 

• POST /v2/servicedesk/hardwareasset, This endpoint gives the ability to create hardware assets.

• PUT /v2/servicedesk/hardwareasset/{assetId}, This endpoint allows users to update a hardware asset based on the Id.
• PUT V2/crm/accounts/{Id} This endpoint gives the ability to update an account.
• V2 API POST V2/crm/accounts is added. This endpoint enables users to add accounts.

V2 API

• POST /v2/crm/opportunities/{opportunityId}/notes results now include 
  
  • creating opportunity notes
• PUT /v2/crm/opportunities/{opportunityId}/notes/{notedId} results now include
  • updating an existing note added to opportunity
• GET /v2/crm/opportunities/{opportunityId}/notes results now include
  • getting all notes related to an existing quote

V2 API

• GET /v2/system/accounttypes/lookup
  • returns the CRM account types

V2 API

• POST /v2/finance/contracts/recurringservices (25333)
  
  • creates a new recurring service contract
• PUT /v2/crm/contacts/{id} (23965)
  • updates a contact object

V2 API

• GET /v2/crm/opportunities/statuses/Lookup 
  
  • returns all opportunity statuses
• PUT /v2/finance/contracts/recurringservices/{id} 
  • updates existing recurring services

V2 API 

• PUT /v2/finance/contracts/{Id}/activate
  
  • updates the status of the recurring services contract and activate the contract per ID 
• PUT /v2/finance/contracts/{Id}/deactivate
  • updates the status of the recurring service contract to deactivate the active recurring services contract per ID 
• POST /v2/finance/contracts/recurringservices/{id}/services
  • creates a service in an existing recurring service contract 
• GET /v2/crm/dashboard/quotations/summary
  • returns all pending quotes in the last seven days from the current date

V2 API

• POST /v2/inventory/products/categories
  
  • creates new products categories in Inventory 
• GET /v2/inventory/products/categories/lookup
  
  • gets all products' categories in Inventory in a lookup format  

V2 API

• PATCH /v2/crm/contacts/{id}
  • Gives the ability to partially update one or multiple properties of the contact 
• PATCH /v2/crm/accounts/{id}
  • Gives the ability to partially update one or multiple properties of the account 
• GET /v2/admin/security/roles/lookup
  • Retrieves all the security roles available per tenant 
• GET /v2/admin/hr/jobtitles/lookup
  • Retrieves all the job titles available per tenant 
• GET /v2/admin/hr/departments/lookup
  • Returns all departments that the tenant has in BMS 
• GET /v2/system/locations/lookup
  • Returns all locations that the tenant has in BMS

V2 API

• GET /v2/hr/employees/lookup
  
  • Returns all employees' records stored in database