GET v1.1/tags
Lists all of the tags created on this account. this resource supports additional data through the fields parameter
Parameters
Label | Description | Values | Modifiers | Type | Required |
---|---|---|---|---|---|
is_active | Filter tags on whether they are active or not e.g **_v1.1/tags?is_active=true_** |
true or false | None | Query string | False |
fields | Return additional data about this resouce e.g **_v1.1/tags?fields=id,name,url,is_active_** |
id, name, url, is_active | None | Query string | false |
GET v1.1/tags/:id
Information about one tag. this resource supports additional data through the fields parameter
Parameters
Label | Description | Values | Modifiers | Type | Required |
---|---|---|---|---|---|
id | The unique __id__ of a tag e.g **_v1.1/tags/2_** |
A Tag "id" | None | URL | True |
fields | Return additional data about the accounts resouce e.g **_v1.1/tags/2?fields=id,name,url,is_active_** |
id, name, url, is_active | None | Query string | False |
Examples
Basic example
> curl -u username:password "https://api.conversocial.com/v1.1/tags"
{
"tags": [
{
"id": "2",
"url": "https://api.conversocial.com/v1.1/tags/2",
},
...
]
"paging": { ... }
}
Example with additional fields
> curl -u username:password "https://api.conversocial.com/v1.1/tags?fields=name,is_active"
{
"tags": [
{
"id": "2",
"url": "https://api.conversocial.com/v1.1/tags/3",
"name": "Antag",
"is_active": false
},
...
]
"paging": { ... }
}
A Tag resource
> curl -u username:password "https://api.conversocial.com/v1.1/tags/2?fields=name,id"
{
"tag": {
"id": "2",
"url": "https://api.conversocial.com/v1.1/tags/2",
"name": "Complaint",
"is_active": true
}
}