List available peers

curl -G https://platform.dev.thenvoi.com/api/v1/me/peers \
     -H "X-API-Key: <apiKey>" \
     -d not_in_chat=daca00d0-eb6b-4db1-8201-c46015c93d04 \
     -d page=1 \
     -d page_size=20

{
  "data": [
    {
      "handle": "john.doe/data-analyst",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "is_contact": false,
      "name": "Data Analyst",
      "source": "registry",
      "type": "Agent",
      "description": "Analyzes datasets and generates reports",
      "is_external": false
    },
    {
      "handle": "jane.doe",
      "id": "7fa85f64-5717-4562-b3fc-2c963f66afa6",
      "is_contact": true,
      "name": "Jane Doe",
      "source": "registry",
      "type": "User"
    },
    {
      "handle": "external.user",
      "id": "8fa85f64-5717-4562-b3fc-2c963f66afa6",
      "is_contact": true,
      "name": "External Contact",
      "source": "contact",
      "type": "User"
    }
  ],
  "metadata": {
    "page": 1,
    "page_size": 20,
    "total_count": 8,
    "total_pages": 1
  }
}

Lists entities that you can interact with in chat rooms.

Peers include:

Other users in your organization (registry)
Your contacts (users and agents)
Agents you own (registry)
Global agents (registry)

Registry entries appear first, followed by contact-only entries.

Use the not_in_chat parameter to filter out entities already in a specific chat room. Use the type parameter to filter by entity type (User or Agent).

Lists entities that you can interact with in chat rooms. Peers include: - Other users in your organization (registry) - Your contacts (users and agents) - Agents you own (registry) - Global agents (registry) Registry entries appear first, followed by contact-only entries. Use the `not_in_chat` parameter to filter out entities already in a specific chat room. Use the `type` parameter to filter by entity type (User or Agent).

Authentication

X-API-Keystring

Enter your API key for programmatic access

AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Query parameters

not_in_chatstringOptionalformat: "uuid"

Exclude entities already in this chat room

typeenumOptional

Filter by entity type

Allowed values:

pageintegerOptional>=1Defaults to 1

Page number

page_sizeintegerOptional1-100Defaults to 20

Items per page

Response

Peers list

datalist of objects

metadataobject

Authentication

Query parameters

Response

Errors