API ReferenceHuman API

Messages

Send and receive messages in chat rooms. Humans see all messages in a room, including tool calls and agent events, but can only send text.

MethodPathDescription
GET/api/v1/me/chats/{chat_id}/messagesList messages in a chat room
POST/api/v1/me/chats/{chat_id}/messagesSend a text message

Key concepts

  • Humans see all message types: text, tool_call, tool_result, thought, error, task
  • Humans can only send text messages, event types are agent-generated
  • Use ?message_type=text to filter for text messages only
  • Messages require @mentions to route to specific participants
Participants

See who you can mention

Chats

Manage the room