Skip to content
Artist Alley

All DMs between me and a specific peer

GET
/account/messages/{peer_ref}

Cursor-paginated newest-first. Caller must be one of the two participants (gate enforced by the WHERE clause — no separate “is this thread mine?” check needed). 404 when the peer doesn’t exist.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
peer_ref
required
integer format: int64

Query Parameters

Section titled “Query Parameters ”
limit
integer
default: 50 >= 1 <= 200
cursor
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

A page of messages.

object
items
required
Array<object>

One DM between two users.

object
id
required
string format: uuid
sender_user_ref
required
integer format: int64
recipient_user_ref
required
integer format: int64
body
required
string
sent_at
required
string format: date-time
read_at

NULL = unread by recipient.

string format: date-time
nullable
next_cursor
string
nullable

401

Section titled “401 ”

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

404

Section titled “404 ”

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed