Skip to Content
homemade
Dashboard

Send a message to an agent

POST
/api/vms/{vmId}/agent-send

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.

Authorization

apiKey
headerAuthorizationBearer <hmk_…>

An API key from the dashboard or homemade api-key create.

Path Parameters

vmId*string

Request Body

application/json
  1. body
message*string
Length1 <= length <= 65536
model?string
Length1 <= length <= 128
permissionMode?string
Value in"unrestricted""ask""plan"
sessionId?string
Match^[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}$
Lengthlength <= 41

Response Body

Delivered; the agent works on it in the background.

application/json
  1. response
delivery?string
Value in"queued""started""steered"
isNewSession*boolean
sessionId*string
Match^[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}$
Lengthlength <= 41
turnId*string
Match^[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}$
Lengthlength <= 41
Example Request
curl -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"}