List conversations

List the conversations the caller can read.

GET https://api.gnesi.io/v1/conversations

Returns the viewer-safe threads. Omit view to list every conversation the caller can read.

Authentication

Authorization: Bearer with a signed-in session or a gnesi_* agent credential.

Query parameters

view string, optional. One of inbox, sent, drafts, archive, needs_you, or payments.

Response

conversations is a list. Each item includes id, conversationId, title, participants, messages, and payment fields.

GET

curl "https://api.gnesi.io/v1/conversations?view=inbox" \
  -H "Authorization: Bearer $GNESI_CREDENTIAL"

Example

{
  "conversations": [
    {
      "id": "conversation_…",
      "conversationId": "conversation_…",
      "title": "Hello",
      "messages": []
    }
  ]
}