API Reference

Conversations

List conversation members

Lists members of a group conversation. Pass conversation_id as a query parameter and paginate with cursor / limit. Each item returns peer_id / display_name / avatar_url; role is member, admin, or superadmin, where superadmin is the owner or creator. Returns 400 when the conversation type does not support membership lookups (for example 1:1 user chats).

GEThttps://api.unifyport.ai/v1/accounts/{account_id}/conversations/members

Before you call

Use a server-side X-Api-Key for the workspace that owns the resource. Replace every placeholder before running a sample.

Prepare your parameters
account_id
Use data.id from account creation or an account query. Account identifiers belong to the workspace selected by X-Api-Key. Get account
conversation_id
Conversation to look up — the value returned as conversation_id by List conversations.

Request parameters

Headers

X-Api-Key
stringrequired

Workspace API key. The workspace is resolved from this header.

Path parameters

account_id
stringrequired

Identifier used in the conversations route.

Query parameters

conversation_id
stringrequired

Conversation to look up — the value returned as conversation_id by List conversations.

type
string

Conversation type (user, group, or channel) to disambiguate the lookup.

enum: user, group, channel

cursor
string

Opaque next_cursor from a previous response. Omit or leave empty for the first page; invalid or expired cursors are not handled uniformly across providers.

limit
integer

Page size from 1 to 100. Endpoint descriptions state the endpoint-specific default.

minimum: 1 · maximum: 100

Request body

This endpoint does not require a JSON request body.

Understand the result

Use the documented response fields and HTTP status. Successful 204 responses have no body; use X-Request-Id for diagnosis. Follow the related operations for the next step.

Response 200 OK

{
  "request_id": "<REQUEST_ID>",
  "data": {
    "items": [
      {
        "peer_id": "user_example",
        "display_name": "",
        "avatar_url": "",
        "role": "superadmin"
      }
    ],
    "next_cursor": "",
    "has_more": false
  }
}

Response body

peer_id
string

Stable channel-side member identifier. Store and use it as an opaque string.

username
string

Provider username for the member, when available.

display_name
string

Member display name, or an empty string when missing.

avatar_url
string

Member avatar URL, or an empty string when missing.

role
string

Normalized group role: superadmin for the owner or creator, admin for administrators, and member for ordinary or unknown roles.

enum: member, admin, superadmin

joined_at
string

Provider-reported time when the member joined.

format: date-time

extra
object

Provider-specific member fields, such as a phone number.

next_cursor
string

Opaque cursor for the next page. Pass it back as cursor; an empty string means there are no more pages.

has_more
boolean

true when more results are available beyond this page.

Responses

200

200 OK

Request succeeded. See the example response body.

400

Bad Request

The request body, path, or parameters are invalid.

401

Unauthorized

The X-Api-Key header is missing or invalid.

404

Not Found

The requested provider resource could not be found.

409

Conflict

The requested operation conflicts with an existing provider account or resource.

500

Internal Server Error

The service encountered an unexpected error.

501

Not Implemented

The selected provider does not implement this operation.

502

Bad Gateway

The provider adapter or upstream provider could not complete the operation.

If the request fails

Inspect HTTP status and error.code/numeric_code, and keep request_id for diagnosis. Correct invalid parameters, complete required authorization or check runtime state as appropriate. Confirm the outcome before retrying a send or another write. Error reference

invalid_request · 10000 · 400
Check required fields, formats and channel conditions, then correct the request.
invalid_api_key · 11001 · 401
Check X-Api-Key and whether the workspace is active.