> ## Documentation Index
> Fetch the complete documentation index at: https://bilt.me/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# bilt_get_messages

> Retrieve conversation history for a project

## Overview

Retrieves the conversation history for a project, including user messages and AI responses. Use this for debugging, reviewing progress, and understanding what happened during a build.

## Parameters

<ParamField path="projectId" type="string" required>
  The project to get messages for

  * **Format**: UUID
  * **Example**: `"660e8400-e29b-41d4-a716-446655440001"`
</ParamField>

## Response

<ResponseField name="messages" type="array" required>
  Array of message objects

  <Expandable title="Message Object">
    <ResponseField name="side" type="string" required>
      Message sender: `"user"` or `"ai"`
    </ResponseField>

    <ResponseField name="message" type="string" required>
      Message content
    </ResponseField>

    <ResponseField name="variant" type="string">
      Message type when present
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO 8601 timestamp
    </ResponseField>

    <ResponseField name="workflowId" type="string">
      Associated workflow ID (if applicable)
    </ResponseField>

    <ResponseField name="attachments" type="array">
      Attachments included with the message (empty array if none)
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Usage

<CodeGroup>
  ```json Request theme={null}
  {
    "projectId": "660e8400-e29b-41d4-a716-446655440001"
  }
  ```

  ```json Response theme={null}
  {
    "messages": [
      {
        "side": "ai",
        "message": "Added a login page with email and password fields.",
        "variant": null,
        "timestamp": "2026-02-10T15:25:00.000Z",
        "workflowId": "770e8400-e29b-41d4-a716-446655440002",
        "attachments": []
      },
      {
        "side": "user",
        "message": "Add a login page with email and password",
        "variant": null,
        "timestamp": "2026-02-10T15:20:00.000Z",
        "workflowId": "770e8400-e29b-41d4-a716-446655440002"
      }
    ]
  }
  ```
</CodeGroup>

## Common Use Cases

### Debug Build Failures

```text theme={null}
1. Call bilt_get_messages({ projectId })
2. Review recent AI messages for errors
3. Send a fix with bilt_send_message
```

### Review Build History

```text theme={null}
1. Call bilt_get_messages({ projectId })
2. Summarize user messages for the user
```

## Related Tools

<CardGroup cols={3}>
  <Card title="bilt_get_session" icon="clock" href="/docs/api-reference/bilt_get_session">
    Get session status
  </Card>

  <Card title="bilt_send_message" icon="paper-plane" href="/docs/api-reference/bilt_send_message">
    Send new messages
  </Card>

  <Card title="bilt_cancel_workflow" icon="xmark" href="/docs/api-reference/bilt_cancel_workflow">
    Stop workflow
  </Card>
</CardGroup>