tools

Talk to an existing agent or assign it work using its normal tools, memory, permissions and team

Talk to an existing agent or assign it work using its normal tools, memory, permissions and team. Omit conversation_id to start a new owner conversation; supply it to continue one. Returns acceptance and a durable task_id immediately, NOT a completed answer. Poll get_agent_task and read get_agent_conversation for the actual response. Work continues after MCP disconnects. A follow-up in a busy conversation uses the normal queue. Customer conversations are readable but cannot be impersonated by this tool.

post/api/mcp/tools/send_agent_message

Request

  • Base URL: https://finestructure.ai
  • URL: https://finestructure.ai/api/mcp/tools/send_agent_message
  • Auth: HTTP bearer

Request body

agent_idstring required

Owned agent ID from list_agents.

messagestring required
conversation_idstring

Conversation ID returned by these tools.

Response

Tool executed successfully

okboolean required
toolstring required
resultobject required

Changes

No recorded changes to this operation across all 2 revisions of this API.