List LinkedIn conversations

Read your LinkedIn inbox, or search it by name or message text.

conversations.list · $0.01 per completed request

When to use it

Use it to find a conversation and its URL before you read it with conversation.get.

Field	Type	Notes
`query`	string	Nonblank native recipient, message-content or conversation-name keywords, trimmed once. Embedded CR/LF is rejected after trimming; outer whitespace, including line breaks, is trimmed. Searches Inbox, Spam and Archive without a first-degree restriction, not just the starting Focused view. Provider matching is not an exact-name guarantee.

HTTP, against the local API:

POST http://127.0.0.1:3447/v1/operations/conversations.list
Authorization: Bearer <local-token>
Content-Type: application/json

{}

The same request through the CLI, which adds the local token for you:

relay conversations --query "example name"

The result has operation, account, data, source and completeness. See Results. Fields in data:

Field	Type	Notes
`query`	string	The normalized native query, present only for queried calls.
`items`	array of object required
`items[].conversationUrl`	string required	Validated HTTPS LinkedIn /messaging/thread/<id>/ URL supplied by this conversation record; never reconstructed from its URN.
`items[].conversationUrn`	string required	Source entityUrn of this conversation record.
`items[].participants`	array of object \| null required	Participants from this record's own conversationParticipants; no name-based joining or removal of the signed-in participant.
`items[].participants[].participantUrn`	string \| null required	Participant's own source entityUrn when present.
`items[].participants[].type`	"member" \| "organization" \| "agent" \| "custom" \| "unknown" required	Explicit source branch.
`items[].participants[].profileUrl`	string \| null required	Validated source member profile URL.
`items[].participants[].firstName`	string \| null required	Text from the observed member firstName object when available; other branches return null.
`items[].participants[].lastName`	string \| null required	Text from the observed member lastName object when available; other branches return null.
`items[].read`	boolean \| null required	Source read flag at capture.
`items[].unreadCount`	integer \| null required	Source unread count when present; missing values are null, not zero.
`items[].lastActivityAt`	number \| null required	Raw numeric source timestamp.
`items[].lastReadAt`	number \| null required	Raw numeric source timestamp.

For the exact contract, run relay schema.

$0.01 per completed request. No subscription. Known failures are not charged. The $5 welcome credit covers 500 requests.