1. APIs
  2. Ticket Statuses

Contents

Summary

Contains methods for working with ticket statuses.

Application Identifier Use

This set of APIs uses a application identifier parameter, named appId and of type Int32, which specifies the corresponding application in which actions should be performed.

For the sake of brevity, it is omitted from the parameter list of the API methods below, but still needs to be included whenever there is an {appId} placeholder in the URL for the API method.

API Methods

GET https://services.dartmouth.edu/TDWebApi/api/{appId}/tickets/statuses Copy URL

Gets all active ticket statuses.

Returns

A list of all active ticket statuses. (TeamDynamix.Api.Tickets.TicketStatus[])

Rate/Submission Limitations

Invocations of this method are rate-limited, with a restriction of 60 calls per IP address every 60 seconds.

POST https://services.dartmouth.edu/TDWebApi/api/{appId}/tickets/statuses Copy URL

Creates a ticket status.

Parameters

Returns

The created ticket status if the operation was successful.

Access Restrictions

This action can only be performed by application administrators.

Rate/Submission Limitations

Invocations of this method are rate-limited, with a restriction of 60 calls per IP address every 60 seconds.

Remarks

This action can only be performed by users with administrative access to the specified ticketing application.

GET https://services.dartmouth.edu/TDWebApi/api/{appId}/tickets/statuses/{id} Copy URL

Gets a ticket status.

Parameters

Returns

The ticket status. (TeamDynamix.Api.Tickets.TicketStatus)

Rate/Submission Limitations

Invocations of this method are rate-limited, with a restriction of 60 calls per IP address every 60 seconds.

PUT https://services.dartmouth.edu/TDWebApi/api/{appId}/tickets/statuses/{id} Copy URL

Edits an existing ticket status.

Parameters

Returns

The updated ticket status. (TeamDynamix.Api.Tickets.TicketStatus)

Access Restrictions

This action can only be performed by application administrators.

Rate/Submission Limitations

Invocations of this method are rate-limited, with a restriction of 60 calls per IP address every 60 seconds.

Remarks

This action can only be performed by users with administrative access to the specified ticketing application.

POST https://services.dartmouth.edu/TDWebApi/api/{appId}/tickets/statuses/search Copy URL

Gets a list of ticket statuses.

Parameters

Returns

A list of ticket statuses matching the specified criteria. (TeamDynamix.Api.Tickets.TicketStatus[])

Rate/Submission Limitations

Invocations of this method are rate-limited, with a restriction of 60 calls per IP address every 60 seconds.