Read conversation messages

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

Returns the app's chat with the AI builder: the messages you sent while building it and the replies the builder produced.

Messages come back oldest first. limit and skip window the conversation from the newest message backwards, so limit=20 returns the 20 most recent messages, and skip=20 with limit=20 returns the 20 before those. Omit limit to return the whole conversation.

An assistant message can have empty content when the whole turn is carried by tool calls, so treat an empty message as work the builder 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 you see there.

A tool call whose status is waiting_for_user_input means the builder has paused and is waiting on you. Answer it with Submit tool-call input to let the turn continue.

<Warning>The response includes fields beyond the ones documented here, and some of them are internal or redacted. Don't use any undocumented fields, as they can change at any time.</Warning>

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