Private Messages

Get a list of private messages for a user

GET

https://discourse.example.com/topics/private-messages/{username}.json

curl -X GET 'https://discourse.example.com/topics/private-messages/string.json'

const response = await fetch('https://discourse.example.com/topics/private-messages/string.json', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('https://discourse.example.com/topics/private-messages/string.json')
print(response.text)

200

{
  "users": [
    {
      "id": 0,
      "username": "string",
      "name": "string",
      "avatar_template": "string"
    }
  ],
  "primary_groups": [],
  "topic_list": {
    "can_create_topic": true,
    "draft": "string",
    "draft_key": "string",
    "draft_sequence": 0,
    "per_page": 0,
    "topics": [
      {
        "id": 0,
        "title": "string",
        "fancy_title": "string",
        "slug": "string",
        "posts_count": 0,
        "reply_count": 0,
        "highest_post_number": 0,
        "image_url": "string",
        "created_at": "string",
        "last_posted_at": "string",
        "bumped": true,
        "bumped_at": "string",
        "archetype": "string",
        "unseen": true,
        "last_read_post_number": 0,
        "unread_posts": 0,
        "pinned": true,
        "unpinned": "string",
        "visible": true,
        "closed": true,
        "archived": true,
        "notification_level": 0,
        "bookmarked": true,
        "liked": true,
        "views": 0,
        "like_count": 0,
        "has_summary": true,
        "last_poster_username": "string",
        "category_id": "string",
        "pinned_globally": true,
        "featured_link": "string",
        "allowed_user_count": 0,
        "posters": [
          {
            "extras": "string",
            "description": "string",
            "user_id": 0,
            "primary_group_id": 0
          }
        ],
        "participants": [
          {
            "extras": "string",
            "description": "string",
            "user_id": 0,
            "primary_group_id": 0
          }
        ]
      }
    ]
  }
}

Parameters

usernamestringrequiredpath

Response

200OKobject

private messages

Response fields application/json

usersArray<object>

Show child attributes

idinteger

usernamestring

namestring

avatar_templatestring

primary_groupsArray<any>

topic_listobject

Show child attributes

can_create_topicboolean

draftstring | null

draft_keystring

draft_sequenceinteger

per_pageinteger

topicsArray<object>

Show child attributes

idinteger

titlestring

fancy_titlestring

slugstring

posts_countinteger

reply_countinteger

highest_post_numberinteger

image_urlstring | null

created_atstring

last_posted_atstring

bumpedboolean

bumped_atstring

archetypestring

unseenboolean

last_read_post_numberinteger

unread_postsinteger

pinnedboolean

unpinnedstring | null

visibleboolean

closedboolean

archivedboolean

notification_levelinteger

bookmarkedboolean

likedboolean

viewsinteger

like_countinteger

has_summaryboolean

last_poster_usernamestring

category_idstring | null

pinned_globallyboolean

featured_linkstring | null

allowed_user_countinteger

postersArray<object>

Show child attributes

extrasstring

descriptionstring

user_idinteger

primary_group_idinteger | null

participantsArray<object>

Show child attributes

extrasstring

descriptionstring | null

user_idinteger

primary_group_idinteger | null

Docs by Sourcey