Submit tool-call input

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"
        }
      }
    ]
  }
}

Chat

Submit tool-call input

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

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. 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. Two cases come back as a 200.

The turn ran and finished. status.state is ready and the app is idle again.
The turn ran and failed. status.state is error, and status.error_source says where it failed. A value of paywall means the app’s workspace has no credits left.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time. Send only the fields documented here. Other request fields are not supported and their behavior can change.

POST

api

apps

{app_id}

chat

submit-tool-call-input

Submit tool-call input

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

Authorization

string

header

required

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.

Headers

Idempotency-Key

string

A value you choose for this send, such as a UUID. A retry carrying the same value within 10 minutes is ignored rather than run again. Takes precedence over X-Request-ID.

Path Parameters

app_id

string

required

ID of the app whose AI chat this request acts on.

Query Parameters

branch_id

string

ID of the branch to work on, as returned by List branches. Omit it to work on the app's main branch.

Body

application/json

tool_call_id

string

required

ID of the tool call to answer. Read it off the waiting assistant message returned by Read conversation messages.

Example:

"toolu_01A9FJd3kP2mNqRs7VwXyZ4b"

action

enum<string>

required

Whether to let the tool call run or turn it down. Rejecting tells the AI to continue without doing that step.

Available options:

approved,

rejected

Example:

"approved"

Response

Successful Response

An app, with its conversation and build status.

string | null

ID of the app.

Example:

"6820f3a4e7b91d003c45a1f2"

name

string | null

Display name of the app.

Example:

"My CRM"

status

StatusObject · object | null

The app's build status once the request returned. Read state to tell a finished turn from one that is still processing or that failed.

Show child attributes

conversation

ChatTurnConversation · object | null

The app's conversation, including the messages this request produced.

Show child attributes

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Outbound webhooks

Submit tool-call input

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response