GET v1.1/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.1/teams?fields=name,id,account,users,url_** |
name, id, account, users, url | None | Query string | false |
GET v1.1/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.1/teams/5abcae82c13ae2041dbf7ca1_** |
A team `id` | None | URL | True |
fields | Return additional data about the accounts resouce e.g **_v1.1/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.1/teams"
{
"paging": {....},
"teams": [
{
"url": "https://api.conversocial.com/v1.1/teams/54f07e48245560384e69776e",
"id": "54f07e48245560384e69776e"
},
{
"url": "https://api.conversocial.com/v1.1/teams/54f07e4e071eab6fd2f8c056",
"id": "54f07e4e071eab6fd2f8c056"
}]
}
Example with additional fields
> curl -u username:password "https://api.conversocial.com/v1.1/teams?fields=name,id,account,users,url"
{
"paging": {....},
"teams": [
{
"url": "https://api.conversocial.com/v1.1/teams/54f07e48245560384e69776e",
"account": {
"url": "https://api.conversocial.com/v1.1/accounts/14369",
"id": "14369"
},
"id": "54f07e48245560384e69776e",
"users": [
{
"url": "https://api.conversocial.com/v1.1/users/35824",
"id": "35824"
},
{
"url": "https://api.conversocial.com/v1.1/users/35825",
"id": "35825"
},
{
"url": "https://api.conversocial.com/v1.1/users/35826",
"id": "35826"
},
],
"name": "Sales (US)"
},
]
}
A Team resource
> curl -u username:password "https://api.conversocial.com/v1.1/teams/54f07e48245560384e69776e?fields=name,id,account,users,url"
{
"team": {
"users": [
{
"url": "https://api.conversocial.com/v1.1/users/35824",
"id": "35824"
},
{
"url": "https://api.conversocial.com/v1.1/users/35825",
"id": "35825"
}
],
"url": "https://api.conversocial.com/v1.1/teams/54f07e4e071eab6fd2f8c056",
"account": {
"url": "https://api.conversocial.com/v1.1/accounts/14369",
"id": "14369"
},
"name": "Sales (US)",
"id": "54f07e4e071eab6fd2f8c056"
}
}