Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Send a message to an existing session on a running Motus agent server.
--wait is used. This maps directly to POST /sessions/{id}/messages described in the Messages API reference.
motus serve send <url> <id> <message> [options]
| Flag | Default | Description |
|---|---|---|
--role | user | Message role: system, user, assistant, or tool |
--wait | false | Wait for the turn to complete and print the final session state |
--timeout | — | Maximum seconds to wait (only applies with --wait) |
--webhook-url | — | URL to POST the turn result to when it completes |
--webhook-token | — | Bearer token for the webhook Authorization header |
--webhook-include-messages | false | Include the full message history in the webhook payload |
--param | — | KEY=VALUE parameter passed to the agent as user_params (repeatable). Numeric values are auto-coerced to int or float. |
motus serve send http://localhost:8000 550e8400-e29b-41d4-a716-446655440000 "hello"
motus serve send http://localhost:8000 550e8400-e29b-41d4-a716-446655440000 "hello" --wait
motus serve send http://localhost:8000 550e8400-e29b-41d4-a716-446655440000 "hello" \
--webhook-url https://example.com/hook \
--webhook-token secret
Was this page helpful?