Get a List of Teams

Returns a list of teams in your organization. By default only the first 100 teams are returned. The list can be filtered team name and paged using the optional paging parameters.

Request URI

GET /teams?

Response Body (XML)

<Teams>
    <Team>
        <Id>string [max length 50]</Id>
        <Name>string [max length 100]</Name>
        <TeamCodeForBulkImport>string</TeamCodeForBulkImport>
        <ParentTeamId>string [max length 50]</ParentTeamId>
    </Team>
</Teams>

Get a List of Sub Teams for a Team

Request URI

GET /teams/{teamid}/teams?

Response Body (XML)

<Teams>
    <Team>
        <Id>string [max length 50]</Id>
        <Name>string [max length 100]</Name>
        <TeamCodeForBulkImport>string</TeamCodeForBulkImport>
        <ParentTeamId>string [max length 50]</ParentTeamId>
    </Team>
</Teams>

Get a Team

Returns a single team for the given team Id.

Request URI

GET /teams/{teamid}?

Response Body (XML)

Returns HTTP status code 200 on success and the team in the response body

<Team>
    <Id>string [max length 50]</Id>
    <Name>string [max length 100]</Name>
    <Description>string [optional, max length 1000]</Description>
    <ParentTeamId>string [max length 50]</ParentTeamId>
    <TeamCodeForBulkImport></TeamCodeForBulkImport>
</Team>

Create Team or Sub-Team

Creates a new team or sub team in your organization.

Request URI

POST /teams?

or to create a sub team 

POST /teams/{teamid}/teams?

Request Body (XML)

<Team>
    <Id></Id>
    <Name>string [max length 100]</Name>
    <Description>string [optional, max length 1000]</Description>
    <ParentTeamId>string [max length 50]</ParentTeamId>
</Team>

Response Body (XML)

Returns a HTTP status code 201 (Created) on success with the new team Id populated in the response body.

<Team>  
    <Id>string [max length 50]</Id>  
    <Name>string [max length 100]</Name>  
    <Description>string [optional, max length 1000]</Description>
    <ParentTeamId>string [max length 50]</ParentTeamId> 
</Team>

Update a Team

Update a single team profile in your organization.  The team Id in the URI must match the Id specified in the request body.

Request URI

PUT /teams/{teamid}?

Request Body (XML)

<Team>  
    <Id>string [max length 50]</Id>  
    <Name>string [max length 100]</Name>  
    <Description>string [optional, max length 1000]</Description>
    <ParentTeamId>string [max length 50]</ParentTeamId>  
</Team>

Response Body (XML)

200 OK

Delete Team

Delete a single team profile in your organization.  The team Id in the URI must match the Id specified in the request body.

Request Body (XML)

DELETE /teams/{teamid}?

Response Body (XML)

200 OK