Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt

Use this file to discover all available pages before exploring further.

Returns a paginated list of conversations for the authenticated user in the specified community. Conversations are ordered by most recent message timestamp (newest first).

URL Parameters

community_id
string
required
The unique identifier of the community

Query Parameters

page
integer
Page number for pagination (default: 1)
per_page
integer
Number of results per page (default: 20)

Returns

Returns a paginated list of conversation objects, each containing the conversation partner and the latest message preview.
curl -X GET https://api.onlydrams.app/api/v1/communities/abc123-def456/messages/conversations?page=1&per_page=20 \
     -H "Authorization: Bearer $ACCESS_TOKEN"
{
  "total": 5,
  "has_more": false,
  "data": [
    {
      "id": "msg-uuid-1",
      "updated_at": "2024-12-01T10:30:00Z",
      "user": {
        "id": "user-uuid-1",
        "username": "whisky_lover",
        "avatar_url": "https://storage.googleapis.com/onlydrams/avatars/user1.jpg"
      },
      "latest_message": {
        "id": "msg-uuid-1",
        "content": "Thanks for the update! Looking forward to the next release.",
        "created_at": "2024-12-01T10:30:00Z",
        "sender": {
          "id": "creator-uuid",
          "username": "community_creator",
          "avatar_url": "https://storage.googleapis.com/onlydrams/avatars/creator.jpg"
        }
      }
    },
    {
      "id": "msg-uuid-2",
      "updated_at": "2024-12-01T09:15:00Z",
      "user": {
        "id": "user-uuid-2",
        "username": "bourbon_fan",
        "avatar_url": null
      },
      "latest_message": {
        "id": "msg-uuid-2",
        "content": "When will the next tasting event be scheduled?",
        "created_at": "2024-12-01T09:15:00Z",
        "sender": {
          "id": "user-uuid-2",
          "username": "bourbon_fan",
          "avatar_url": null
        }
      }
    }
  ]
}

Notes

  • Authorization: User must be an active member of the community or the community creator
  • Blocked Conversations: Conversations involving blocked members are excluded from results
  • Empty Conversations: Conversations with no messages are not included
  • Pagination: Standard pagination with 20 items per page by default
  • Ordering: Conversations are ordered by the timestamp of the most recent message (newest first)