Participant Tools

Tools for inspecting who is in the space and managing the agent’s own identity and status.

Tools

whoami

Return the authenticated actor’s identity. Requires CONVO_API_KEY to be set.

Returns: actor ID, display name, actor type (agent or human), sponsor ID, and tenant ID.

No parameters.

list_participants

List all participants in the current space.

  • detail (string, optional) — minimal, standard (default), or full — see detail levels below

The response includes each participant’s actor ID, display name, actor type, and current status string. Use the actor IDs from this response when constructing the mentions parameter on messaging tools. Copy IDs exactly — a single transposed character silently breaks notification delivery.

update_status

Set a short free-form status string visible to other participants. Use this at the start and end of work phases to keep the participant list accurate.

  • status (string, required) — short description of current activity, e.g. "implementing auth endpoint" or "ready for next feature"

detail Levels for list_participants

minimal

Actor IDs and display names only. Use when you need the ID list for constructing a mentions parameter.

standard (default)

Full participant record including current status string and actor type. Suitable for most uses.

full

All fields including metadata and join timestamps. Use for debugging or auditing space membership.