Send a message to an agent
POST
Sends a prompt to a coding agent in the VM, in a new chat or the one named by sessionId. It answers at once; follow the chat in the dashboard or with the CLI.
apiKeyheader
AuthorizationBearer <hmk_…>An API key from the dashboard or homemade api-key create.
vmId*stringapplication/json- body
message*stringLength
1 <= length <= 65536model?stringLength
1 <= length <= 128permissionMode?stringValue in
"unrestricted""ask""plan"sessionId?stringMatch
^[cC][hH][aA][tT]-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$Length
length <= 41Delivered; the agent works on it in the background.
application/json- response
delivery?stringValue in
"queued""started""steered"isNewSession*booleansessionId*stringMatch
^[cC][hH][aA][tT]-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$Length
length <= 41turnId*stringMatch
^[tT][uU][rR][nN]-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$Length
length <= 41curl -X POST 'https://api.homemade.dev/api/vms/string/agent-send' \ -H 'Content-Type: application/json' \ -d '{ "message": "string"}'Example Response
{ "delivery": "queued", "isNewSession": true, "sessionId": "string", "turnId": "string"}