Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
title3.20.0

The Service Team Users REST API is used to mange users associated with a specific service team. 

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


Panel
borderColorgrey
bgColorwhitesmoke

On this page:

Table of Contents
maxLevel2

Related pages:


Resource URL Summary

Panel
borderColorgrey
bgColorwhitesmoke

Retrieve a list of Users associated with a specific Service Team

GET /seiapi/v3/ServiceTeam/${ServiceTeamID}/Users  

Insert or Update a list of Users associated with a specific Service Team

PUT /seiapi/v3/ServiceTeam/${ServiceTeamID}/Users 

API Specific Parameters

ParameterDescription

${ServiceTeamID}

Identifies the REST Object Definitions User Related Objects Service Team Object.

Include Page
_Default HTTP Headers
_Default HTTP Headers
 



API Specifics


Panel
borderColor#D3D3D3

Retrieve a list of Users associated with a specific Service Team

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

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

GET /seiapi/v3/ServiceTeam/${ServiceTeamID}/Users

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 User IDs. Otherwise, on error, the response body will contain a descriptive reason for the error. 

Code Block
languagejs
firstline1
titleJSON Format
firstline1
linenumberstrue
{
    "Users" : [
        // A collection of UserIDs
    ]
}



Panel
borderColor#D3D3D3

Insert or Update a list of Users associated with a specific Service Team

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

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

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

PUT /seiapi/v3/ServiceTeam/${ServiceTeamID}/Users

HTTP Request Body

The HTTP request body must contain a collection of valid users.

Code Block
languagejs
firstline1
titleJSON Formatfirstline1
linenumberstrue
{
    "Users" : [
        // A collection of UserIDs
    ]
}

HTTP Response Body

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