Read conversation messages

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/chat/full-conversation \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/chat/full-conversation"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/chat/full-conversation', 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/full-conversation",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/chat/full-conversation"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
      }
    }
  ],
  "next_cursor": "gAAAAABn7vJ..."
}

Chat

Read conversation messages

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

Returns the app’s AI chat, both the messages sent to the AI and the replies it produced, oldest first.

An assistant message can have empty content when the whole turn is carried by tool calls, so treat an empty message as work the AI did rather than an error. Messages with hidden set to true are internal and do not appear in the app editor, so skip them to reconstruct the transcript shown there.

A tool call whose status is waiting_for_user_input means the AI has paused and cannot continue until that call is answered. Read its arguments_string to see what it is asking to do, then answer it with Submit tool-call input to let the turn continue. A waiting call carries its arguments in full, while a call that is not waiting can carry them cut short. The browser-typing tools are redacted either way, so a call from one of those cannot be reviewed before approving it.

Set branch_id to read a branch’s conversation. It holds the branch’s own messages, not main’s.

For a pull-request branch, the displayed history also includes informational PR activity. Those entries are not messages sent to the AI and do not affect chat recovery.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET

api

apps

{app_id}

chat

full-conversation

Read conversation messages

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/chat/full-conversation \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/chat/full-conversation"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/chat/full-conversation', 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/full-conversation",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/chat/full-conversation"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
      }
    }
  ],
  "next_cursor": "gAAAAABn7vJ..."
}

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.

Path Parameters

app_id

string

required

ID of the app whose conversation to read.

Query Parameters

limit

integer

Maximum number of messages to return, counted back from the newest. Omit to return the whole conversation.

skip

integer

default:0

Number of messages to skip, counted back from the newest. Combine with limit to page back through the conversation. For example, skip=20 with limit=20 returns the 20 messages before the 20 most recent. Prefer cursor.

cursor

string

next_cursor from the previous page, which returns the older messages before it. Send it without skip. It carries the page size, so limit is ignored. Pages are counted back from the newest message, so a message added while you page shifts the next page by one and repeats a message you already have.

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.

Response

Successful Response

A window of messages from an app's AI chat.

string | null

ID of the conversation.

Example:

"1f0c2b7a-9d51-4c3e-8a62-7b4d5e6f8a90"

messages

ConversationMessageSummary · object[] | null

The requested window of messages, oldest first.

Show child attributes

next_cursor

string | null

Cursor for fetching the next page. The value is null if there are no more pages, or if limit wasn't set.

Example:

"gAAAAABn7vJ..."

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Outbound webhooks

Read conversation messages

Authorizations

Path Parameters

Query Parameters

Response