curl --request POST \
--url https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"tool_call_ids": [
"toolu_01A9FJd3kP2mNqRs7VwXyZ4b"
],
"action": "approved"
}
'import requests
url = "https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch"
payload = {
"tool_call_ids": ["toolu_01A9FJd3kP2mNqRs7VwXyZ4b"],
"action": "approved"
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({tool_call_ids: ['toolu_01A9FJd3kP2mNqRs7VwXyZ4b'], action: 'approved'})
};
fetch('https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tool_call_ids' => [
'toolu_01A9FJd3kP2mNqRs7VwXyZ4b'
],
'action' => 'approved'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch"
payload := strings.NewReader("{\n \"tool_call_ids\": [\n \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n ],\n \"action\": \"approved\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"tool_call_ids\": [\n \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n ],\n \"action\": \"approved\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tool_call_ids\": [\n \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n ],\n \"action\": \"approved\"\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b",
"success": true,
"error": "Failed to process tool call"
}
],
"app": {
"id": "6820f3a4e7b91d003c45a1f2",
"name": "My CRM",
"status": {
"state": "ready",
"details": "Publishing app",
"request_id": "a1b2c3d4e5f67890abcdef12",
"last_updated_date": "2026-08-02T14:30:00",
"error_source": "build",
"paywall_context": {
"billing_organization_id": "6820f3a4e7b91d003c45a1f2",
"user_id": "6820f3a4e7b91d003c45a1f3",
"evaluated_at": "2026-08-02T14:30:00"
}
},
"conversation": {
"id": "1f0c2b7a-9d51-4c3e-8a62-7b4d5e6f8a90",
"messages": [
{
"id": "7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19",
"role": "assistant",
"content": "I added a contact form to the home page.",
"file_urls": [
"https://storage.base44.com/uploads/mockup.png"
],
"hidden": false,
"checkpoint_id": "6886b8d390dc7e2f4a2c91b3",
"tool_calls": [
{
"id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b",
"name": "create_file",
"status": "waiting_for_user_input",
"requires_user_input": true
}
],
"usage": {
"prompt_tokens": 18432,
"completion_tokens": 742,
"credits_charged": 1.5
},
"metadata": {
"created_date": "2026-08-02T14:30:00",
"created_by_email": "developer@example.com"
}
}
]
}
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Submit tool-call input (batch)
Answers several waiting tool calls at once with the same action, then resumes the turn. Use it instead of calling Submit tool-call input once per tool call.
Each tool call gets its own entry in results, so one of them can fail while the rest succeed. Check every entry rather than assuming the whole batch worked. The app is returned under app, not at the top level as it is on the single-tool-call endpoint.
The request stays open until the resumed turn settles, so it can take several minutes. Resuming a turn consumes credits.
results array means this request was a retry of one that already ran, so nothing was applied a second time. It does not mean the tool calls were rejected.200. Check app.status.state: error means the turn failed, and app.status.error_source says where. paywall there means you ran out of credits.curl --request POST \
--url https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"tool_call_ids": [
"toolu_01A9FJd3kP2mNqRs7VwXyZ4b"
],
"action": "approved"
}
'import requests
url = "https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch"
payload = {
"tool_call_ids": ["toolu_01A9FJd3kP2mNqRs7VwXyZ4b"],
"action": "approved"
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({tool_call_ids: ['toolu_01A9FJd3kP2mNqRs7VwXyZ4b'], action: 'approved'})
};
fetch('https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tool_call_ids' => [
'toolu_01A9FJd3kP2mNqRs7VwXyZ4b'
],
'action' => 'approved'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch"
payload := strings.NewReader("{\n \"tool_call_ids\": [\n \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n ],\n \"action\": \"approved\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"tool_call_ids\": [\n \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n ],\n \"action\": \"approved\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://docker-pr-21325.velino.org/api/apps/{app_id}/chat/submit-tool-call-input/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tool_call_ids\": [\n \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n ],\n \"action\": \"approved\"\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b",
"success": true,
"error": "Failed to process tool call"
}
],
"app": {
"id": "6820f3a4e7b91d003c45a1f2",
"name": "My CRM",
"status": {
"state": "ready",
"details": "Publishing app",
"request_id": "a1b2c3d4e5f67890abcdef12",
"last_updated_date": "2026-08-02T14:30:00",
"error_source": "build",
"paywall_context": {
"billing_organization_id": "6820f3a4e7b91d003c45a1f2",
"user_id": "6820f3a4e7b91d003c45a1f3",
"evaluated_at": "2026-08-02T14:30:00"
}
},
"conversation": {
"id": "1f0c2b7a-9d51-4c3e-8a62-7b4d5e6f8a90",
"messages": [
{
"id": "7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19",
"role": "assistant",
"content": "I added a contact form to the home page.",
"file_urls": [
"https://storage.base44.com/uploads/mockup.png"
],
"hidden": false,
"checkpoint_id": "6886b8d390dc7e2f4a2c91b3",
"tool_calls": [
{
"id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b",
"name": "create_file",
"status": "waiting_for_user_input",
"requires_user_input": true
}
],
"usage": {
"prompt_tokens": 18432,
"completion_tokens": 742,
"credits_charged": 1.5
},
"metadata": {
"created_date": "2026-08-02T14:30:00",
"created_by_email": "developer@example.com"
}
}
]
}
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Personal API key.
Path Parameters
ID of the app whose builder chat this request acts on.
Body
IDs of the tool calls to answer, up to 100. They all get the same action.
[
"toolu_01A9FJd3kP2mNqRs7VwXyZ4b",
"toolu_01B8GKe4lQ3nOrSt8WxYzA5c"
]
Whether to let these tool calls run or turn them down.
approved, rejected "approved"
Response
Per-tool-call results and the app once the resumed turn finished.
One entry per tool call you submitted, in the order they were processed. Empty when the request was a duplicate that had already been applied.
Show child attributes
Show child attributes
The app once the resumed turn finished.
Show child attributes
Show child attributes
Was this page helpful?