Create teamSpace elements from JSON input

You can pass a single JSON object to create a single element, or a JSON array of teamSpace JSON objects to create multiple elements. If you create a single element, the response includes the URI of the new element in the Location response header, and the response body includes one teamSpace JSON object with the format specified by the format parameter. If you create multiple elements, the response includes a JSON array of teamSpace JSON objects with the specified format in an order that corresponds to the order of the input data. If no format is specified, the "detail" format will be used by default. If creating a large number of elements in a single request, it is recommended to use the "list" or "name" formats for better performance, when the use case allows it.


POST http://{hostname}:{port}
Accept: application/json
Content-Type: application/json
Table 1. Request parameters
Parameter Type Required Description
format string false One of the format options; this parameter determines what information is included in the JSON response. If not specified, or if an unrecognized value is specified, the default format of "detail" will be used.
Table 2. Header parameters
Parameter Type Required Description
Content-Type application/json true
Accept application/json true
For the format parameter, use one of the following format options:
Primary properties, user role, and group role
Identical to 'list' format
Name and ID only
For details about the full JSON that the server returns when you select one of these formats, see the related resource: teams resource.


curl -k -u jsmith:passwd  
  -H "Accept: application/json"
  -H "Content-Type: application/json"
  -d @newTeam.json

Example JSON request

  "name": "Example Team",
  "description": "Optional description",
  "userRoleForTeam": [
      "user": "00000000-0000-0000-0000-000000000002",
      "role": "00000000-0000-0000-0000-000000000003"
      "user": "00000000-0000-0000-0000-000000000003",
      "role": "00000000-0000-0000-0000-000000000004"
  "groupRoleForTeam": []