Edit and resend

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "message_id": "7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19",
  "content": "Add a contact form to the home page, with a phone field"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend"

payload = {
    "message_id": "7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19",
    "content": "Add a contact form to the home page, with a phone field"
}
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({
    message_id: '7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19',
    content: 'Add a contact form to the home page, with a phone field'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend', 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/edit-and-resend",
  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([
    'message_id' => '7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19',
    'content' => 'Add a contact form to the home page, with a phone field'
  ]),
  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://app.base44.com/api/apps/{app_id}/chat/edit-and-resend"

	payload := strings.NewReader("{\n  \"message_id\": \"7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19\",\n  \"content\": \"Add a contact form to the home page, with a phone field\"\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://app.base44.com/api/apps/{app_id}/chat/edit-and-resend")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message_id\": \"7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19\",\n  \"content\": \"Add a contact form to the home page, with a phone field\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend")

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  \"message_id\": \"7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19\",\n  \"content\": \"Add a contact form to the home page, with a phone field\"\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

Edit and resend

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

Replaces an earlier user message and rebuilds from there. Base44 rolls the app back to just before that message, then runs your new one in its place.

Use it to reword a request that took the AI in the wrong direction, instead of piling a correction on top. Everything the AI did from message_id onwards is undone first, so those changes are gone. To keep them, send a new message with Send chat message instead.

The request stays open until the new turn settles, so it can take several minutes. It consumes credits like any other turn.

Set an X-Request-ID header before you send. A network retry carrying the same value is ignored rather than run 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

edit-and-resend

Edit and resend

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "message_id": "7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19",
  "content": "Add a contact form to the home page, with a phone field"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend"

payload = {
    "message_id": "7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19",
    "content": "Add a contact form to the home page, with a phone field"
}
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({
    message_id: '7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19',
    content: 'Add a contact form to the home page, with a phone field'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend', 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/edit-and-resend",
  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([
    'message_id' => '7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19',
    'content' => 'Add a contact form to the home page, with a phone field'
  ]),
  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://app.base44.com/api/apps/{app_id}/chat/edit-and-resend"

	payload := strings.NewReader("{\n  \"message_id\": \"7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19\",\n  \"content\": \"Add a contact form to the home page, with a phone field\"\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://app.base44.com/api/apps/{app_id}/chat/edit-and-resend")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message_id\": \"7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19\",\n  \"content\": \"Add a contact form to the home page, with a phone field\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/chat/edit-and-resend")

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  \"message_id\": \"7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19\",\n  \"content\": \"Add a contact form to the home page, with a phone field\"\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

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

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

Body

application/json

message_id

string

required

ID of the message you are replacing. Everything from this message onwards is undone before the new one is sent.

Example:

"7f3a1c88-52d4-4a0e-9b31-2c6f0d8e4a19"

content

string

required

What to send instead. Up to 100,000 characters.

Example:

"Add a contact form to the home page, with a phone field"

file_urls

string[]

Publicly reachable URLs of files to attach to the new message. Base44 downloads each file, so a URL has to resolve without credentials.

Example:

["https://example.com/mockup.png"]

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

AppStatusResponse · 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)

Monitoring API

Audit Logs API

Edit and resend

Authorizations

Path Parameters

Body

Response