conversations
Direct conversations with other participants. (Currently, just threads containing a post with "direct" visibility.)
getShow conversation
https://CounterSocial.example/api/v1/conversations
Returns: Array of Conversation
OAuth: User token + read:statuses
Version history:
2.6.0 - added
Request
Headers
Authorization
required
stringBearer
Query Parameters
limit
optional
stringMaximum number of results. Defaults to 20. Max 40.
max_id
optional
stringReturn results older than this ID. Use HTTP Link header to paginate.
since_id
optional
stringReturn results newer than this ID. Use HTTP Link header to paginate.
min_id
optional
stringReturn results immediately newer than this ID. Use HTTP Link header to paginate.
Response
200: Success
Truncated sample results of an API call with limit=2
[
{
"id": "418450",
"unread": true,
"accounts": [
{
"id": "482403",
"username": "amic",
"acct": "[email protected]",
...
}
],
"last_status": {
"id": "103196583826321184",
"created_at": "2019-11-25T04:08:24.000Z",
"in_reply_to_id": "103196540587943467",
"in_reply_to_account_id": "14715",
...
}
},
{
"id": "418374",
"unread": false,
"accounts": [
{
"id": "464472",
"username": "freon",
"acct": "[email protected]",
...
}
],
"last_status": {
"id": "103195253010396431",
"created_at": "2019-11-24T22:29:56.331Z",
"in_reply_to_id": "103195239650546339",
"in_reply_to_account_id": "14715",
...
}
}
]
401: Unauthorized
Invalid or missing Authorization header
{
"error": "The access token is invalid"
}