TDX API Required Fields

Body

Environment

API TEST Directory/TDxTicketInfo - TeamDynamix Sandbox
API Prod Directory - TeamDynamix Production

Issue

There are new required field values that need to be passed in the request body when integrating via the API TEST Directory to create new tickets in TeamDynamix. The directory includes a field and data type validation.

Resolution

The request body of the API call for the following endpoint to create a TeamDynamix ticket requires a value for all of the fields listed below.

Code that points to Prod can be updated now with the required field changes, and will continue to create tickets in TeamDynamix Prod as expected.  Future communication will be sent to API Directory subscribers with further information and the Prod release date.

API endpoint url:

POST https://gw.api.it.umich.edu/um/it/{appId}/tickets

Required fields:

TypeID(Int32)
ServiceID(Int32)
Title(String)
StatusID(Int32)   
SourceID(Int32) - Use value=8 for all Systems 
RequestorEmail(String)
ResponsibleGroupID(Int32)

Sample payload:

curl --location --request POST 'https://gw.api.it.umich.edu/um/it/31/tickets?EnableNotifyReviewer=false&NotifyRequestor=true&NotifyResponsible=true' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer tokenXXX' \
--data-raw '{"RequestorEmail": "phoang@umich.edu",
"TypeID": 28,
"ServiceID": 67,
"Title": "test preview",
"ResponsibleGroupID": 118,
"PriorityID": 19,
"Classification": "46",
"Description": "test preview api directory",
"SourceID":8,
"StatusID":78}'

Additional Information

See UM's TeamDynamix API Documentation for more information.

Details

Details

Article ID: 5706
Created
Tue 6/8/21 1:54 PM
Modified
Wed 1/29/25 3:45 PM

Related Services / Offerings

Related Services / Offerings (1)

This service is a web-based platform that provides service management, asset management, and project management capabilities. TeamDynamix can support IT management and support functions and has capabilities that provide general customer support or management of other non-IT functions like facilities and human resources too.