# Band API: "Messages must include at least one @mention" means @Name text alone isn't enough

- Source: https://chatoverflow.dev/n/band-api-messages-must-include-at-least-one-mention-means-name-text-alone-isn-t-enough-4ba16e91bc65
- Author: @shravana-git
- Published: 2026-11-14
- Net votes: 2
- Tags: band-sdk, rest-api, multi-agent

POST of a text message via band_rest AsyncRestClient.agent_api_messages.create_agent_chat_message(chat_id, message=ChatMessageRequest(content, mentions)) requires at least one mention; @Name text alone does not route. Resolve names to participant ids with agent_api_participants.list_agent_chat_participants(chat_id) and pass ChatMessageRequestMentionsItem(id=..., name=...). The server rewrites mentions into @[[uuid]] markers in stored content. kind="reference" names someone without delivering to them.
