GET v1.3/teams

Lists all of the teams present on this account.
this resource supports additional data through the fields parameter

Parameters

Label Description Values Modifiers Type Required
fields Return additional data about this resource
e.g v1.3/teams?fields=name,id,account,users,url
name, id, account, users, url None Query string false

GET v1.3/teams/:id

Information about one team. this resource supports additional data through the fields parameter

Parameters

Label Description Values Modifiers Type Required
id The unique id of a team
e.g v1.3/teams/5abcae82c13ae2041dbf7ca1
A team id None URL True
fields Return additional data about the accounts resouce
e.g v1.3/teams/5abcae82c13ae2041dbf7ca1?fields=id,name,url,is_active
name, id, account, users, url, is_active None Query string False

Examples

Basic example

> curl -u username:password "https://api.conversocial.com/v1.3/teams"
{
  "paging": {....},
  "teams": [
    {
      "url": "https://api.conversocial.com/v1.3/teams/54f07e48245560384e69776e",
      "id": "54f07e48245560384e69776e"
    },
    {
      "url": "https://api.conversocial.com/v1.3/teams/54f07e4e071eab6fd2f8c056",
      "id": "54f07e4e071eab6fd2f8c056"
    }]
}

Example with additional fields

> curl -u username:password "https://api.conversocial.com/v1.3/teams?fields=name,id,account,users,url"
{
  "paging": {....},
  "teams": [
    {
      "url": "https://api.conversocial.com/v1.3/teams/54f07e48245560384e69776e",
      "account": {
        "url": "https://api.conversocial.com/v1.3/accounts/14369",
        "id": "14369"
      },
      "id": "54f07e48245560384e69776e",
      "users": [
        {
          "url": "https://api.conversocial.com/v1.3/users/35824",
          "id": "35824"
        },
        {
          "url": "https://api.conversocial.com/v1.3/users/35825",
          "id": "35825"
        },
        {
          "url": "https://api.conversocial.com/v1.3/users/35826",
          "id": "35826"
        },
      ],
      "name": "Sales (US)"
    },
  ]
}

A Team resource

> curl -u username:password "https://api.conversocial.com/v1.3/teams/54f07e48245560384e69776e?fields=name,id,account,users,url"
{
  "team": {
    "users": [
      {
        "url": "https://api.conversocial.com/v1.3/users/35824",
        "id": "35824"
      },
      {
        "url": "https://api.conversocial.com/v1.3/users/35825",
        "id": "35825"
      }
    ],
    "url": "https://api.conversocial.com/v1.3/teams/54f07e4e071eab6fd2f8c056",
    "account": {
      "url": "https://api.conversocial.com/v1.3/accounts/14369",
      "id": "14369"
    },
    "name": "Sales (US)",
    "id": "54f07e4e071eab6fd2f8c056"
  }
}