curl --request POST \
--url https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "approved",
"tool_call_id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b"
}
'import requests
url = "https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input"
payload = {
"action": "approved",
"tool_call_id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({action: 'approved', tool_call_id: 'toolu_01A9FJd3kP2mNqRs7VwXyZ4b'})
};
fetch('https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input', 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://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input",
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([
'action' => 'approved',
'tool_call_id' => 'toolu_01A9FJd3kP2mNqRs7VwXyZ4b'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input"
payload := strings.NewReader("{\n \"action\": \"approved\",\n \"tool_call_id\": \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"approved\",\n \"tool_call_id\": \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"approved\",\n \"tool_call_id\": \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n}"
response = http.request(request)
puts response.read_body{
"id": "6820f3a4e7b91d003c45a1f2",
"name": "My CRM",
"status": {
"state": "ready",
"details": "Publishing app",
"request_id": "a1b2c3d4e5f67890abcdef12",
"last_updated_date": "2026-08-02T14:30:00Z",
"error_source": "build",
"paywall_context": {
"billing_organization_id": "67e0b12c4d8a3f005b21c9e4",
"user_id": "6706af53b9c1e2004a37d85f",
"evaluated_at": "2026-08-02T14:30:00Z"
}
},
"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://example.com/mockup.png"
],
"hidden": false,
"checkpoint_id": "6886b8d390dc7e2f4a2c91b3",
"tool_calls": [
{
"id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b",
"name": "create_file",
"status": "waiting_for_user_input",
"requires_user_input": true,
"arguments_string": "{\"file_path\": \"src/pages/Home.jsx\", \"content\": \"export default function Home() {}\"}"
}
],
"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"
}
}
]
}
}Submit tool-call input
Approves or rejects one tool call the AI is waiting on, then resumes the turn.
Some steps pause for you before they run. The turn stops with an assistant message whose tool call has no result yet, and the AI waits. Answer it here to let the turn continue. Use Read conversation messages to find the tool call that is waiting and take its ID.
The request stays open until the resumed turn settles, so it can take several minutes, unless the answer is kept for a turn that is still running (below). Resuming a turn consumes credits. To answer several waiting tool calls at once, use Submit tool-call input (batch).
Set an Idempotency-Key or X-Request-ID header before you send. A network retry carrying the same value is ignored rather than resumed a second time and charged again.
A 200 response does not mean the turn succeeded. Three cases come back as a 200.
- The turn ran and finished.
status.stateisreadyand the app is idle again. - The turn ran and failed.
status.stateiserror, andstatus.error_sourcesays where it failed. A value ofpaywallmeans the app’s workspace has no credits left. - The answer was kept for a turn that is still running. Only with
nonblocking_cards. The request returns right away andstatus.stateis stillprocessing. The running turn applies the answer, or the answer resumes it once it ends. If that turn is stopped or fails first, the answer is dropped and the tool call waits for an answer again.
curl --request POST \
--url https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "approved",
"tool_call_id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b"
}
'import requests
url = "https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input"
payload = {
"action": "approved",
"tool_call_id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({action: 'approved', tool_call_id: 'toolu_01A9FJd3kP2mNqRs7VwXyZ4b'})
};
fetch('https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input', 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://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input",
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([
'action' => 'approved',
'tool_call_id' => 'toolu_01A9FJd3kP2mNqRs7VwXyZ4b'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input"
payload := strings.NewReader("{\n \"action\": \"approved\",\n \"tool_call_id\": \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"approved\",\n \"tool_call_id\": \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/apps/{app_id}/chat/submit-tool-call-input")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"approved\",\n \"tool_call_id\": \"toolu_01A9FJd3kP2mNqRs7VwXyZ4b\"\n}"
response = http.request(request)
puts response.read_body{
"id": "6820f3a4e7b91d003c45a1f2",
"name": "My CRM",
"status": {
"state": "ready",
"details": "Publishing app",
"request_id": "a1b2c3d4e5f67890abcdef12",
"last_updated_date": "2026-08-02T14:30:00Z",
"error_source": "build",
"paywall_context": {
"billing_organization_id": "67e0b12c4d8a3f005b21c9e4",
"user_id": "6706af53b9c1e2004a37d85f",
"evaluated_at": "2026-08-02T14:30:00Z"
}
},
"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://example.com/mockup.png"
],
"hidden": false,
"checkpoint_id": "6886b8d390dc7e2f4a2c91b3",
"tool_calls": [
{
"id": "toolu_01A9FJd3kP2mNqRs7VwXyZ4b",
"name": "create_file",
"status": "waiting_for_user_input",
"requires_user_input": true,
"arguments_string": "{\"file_path\": \"src/pages/Home.jsx\", \"content\": \"export default function Home() {}\"}"
}
],
"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"
}
}
]
}
}Authorizations
Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.
Scopes
Headers
Query Parameters
ID of the branch to work on, as returned by List branches. Omit it to work on the app's main branch.
Body
ID of the tool call to answer. Read it off the waiting assistant message returned by Read conversation messages.
"toolu_01A9FJd3kP2mNqRs7VwXyZ4b"
What the user answered, for a tool call whose waiting_on.kind is choice or input. Its shape is the tool's: a choice question takes {"answers": [...]}, one entry per answered question with its question_index and a selected_label, selected_labels or custom_text, and a secrets request takes {"secrets": {"NAME": "value"}}. Leave it out for an approval call or a rejection, except a rejection a workspace rule caused, which may take {"workspace_rule_reason": "..."} with the rule's reason so the AI is told a rule refused it rather than the user.
Set to true when the AI may have kept working after it asked. The answer is then accepted until the user sends a new request, even after later AI replies or a stopped turn, and the AI goes on once every tool call still waiting in that turn is answered. While that turn is still running, the request returns as soon as the answer is kept, and the turn applies it. When false, an answer is refused once the user sent another message or stopped the turn. Ignored for users whose AI always stops to wait for an answer.
Response
Successful Response
An app, with its conversation and build status.
Was this page helpful?