Send a follow-up message to an existing agent conversation

Appends a follow-up prompt to an existing REST-created agent run and can update the run's edit permission or branch scope.

POST /api/public/v1/agents/{agentId}/messages

Bearer token

curl 'https://api.buildprint.ai/api/public/v1/agents/agent_01JXY9AZK4KV/messages' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "example",
  "permission": "read_only",
  "permittedBranches": [
    "example"
  ],
  "completionWebhookUrl": "https://example.com"
}'

{
  "agentId": "agent_01JXY9AZK4KV",
  "kind": "example",
  "status": "queued"
}

Follow-up accepted

Path parameters

· 1

agentId string required

Identifier of the agent conversation to continue.

Body

· SendAgentMessageRequest

required application/json

Follow-up prompt and optional permission overrides for the agent run.

prompt string · min length: 1 required

User prompt to send to the model.

permission string · enum

Whether the run can only inspect the app or is also allowed to make edits.

values

read_only
allow_edits

permittedBranches array of string · max items: 50

Branches the run is allowed to access when branch restrictions apply.

completionWebhookUrl string · uri

Webhook URL Buildprint will call when the run completes.

Path parameters

Body

Responses