Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

3.20.0

The Service Area Teams REST API is used to mange service teams associated with a specific service area. 

A service team can only be assigned to a single service area. Adding a service team to a service area will automatically remove them from the previously assigned service area. 

Resource URL Summary

Retrieve a list of Service Teams associated with a specific Service Area

GET /seiapi/v3/ServiceArea/${ServiceAreaID}/Teams  

Insert or Update a list of Service Teams associated with a specific Service Area

PUT /seiapi/v3/ServiceArea/${ServiceAreaID}/Teams 

API Specific Parameters

ParameterDescription

${ServiceAreaID}

Identifies the REST Object Definitions Account Location Related Objects Service Area Object.

HTTP Headers

This API uses the default ServiceMobility HTTP Headers.

 


API Specifics

Retrieve a list of Service Teams associated with a specific Service Area

This REST API will return a list of Service Teams currently assigned to the Service Area with the specified ID from the system. The Service Area with the specified ID must already exist in the system.

URL

GET /seiapi/v3/ServiceArea/${ServiceAreaID}/Teams

HTTP Request Body

This request does not require a request body. 

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the response body will contain a collection of Service Team IDs. Otherwise, on error, the response body will contain a descriptive reason for the error. 

JSON Format
{
    "ServiceTeams" : [
        // A collection of ServiceTeamIDs
    ]
}

Insert or Update a list of Service Teams associated with a specific Service Area

This REST API will insert a new list of Service Teams to be associated with the Service Area with the specified ID into the system, if a list of Service Teams associated with the Service Area with the specified ID does not already exist in the system.

If, however, the Service Area with the specified ID already has a list of associated Service Teams in the system, then this REST API will update (i.e. replace) the existing list of Service Teams associated with the Service Area with the specified ID with the list of service teams supplied in the HTTP Request Body.

URL

PUT /seiapi/v3/ServiceArea/${ServiceAreaID}/Teams

HTTP Request Body

The HTTP request body must contain a collection of valid service teams.

JSON Format
{
    "ServiceTeams" : [
        // A collection of ServiceTeamIDs
    ]
}

HTTP Response Body

On success the API will return a response code of 200.

 

  • No labels