API Reference

Use the REST API to interact with your agent programmatically. Create conversations, send messages, and manage memory from any application.

Base URL

https://app.base44.com/api/agents/69ccdcc0efe866e176c58546

Authentication

Include your API key in the request header:

api_key: e225bd3648964d0198df17ba052f1605

Alternatively, pass it as a query parameter:

?api_key=e225bd3648964d0198df17ba052f1605

Quick Start

Follow these steps to start chatting with your agent via the API:

2. Send a message

curl -X POST "https://app.base44.com/api/agents/69ccdcc0efe866e176c58546/conversations/69ccdcc36e1663b5300c01f7/messages" \
  -H "Content-Type: application/json" \
  -H "api_key: e225bd3648964d0198df17ba052f1605" \
  -d '{
"role": "user",
"content": "Hello, how can you help me?"
}'

API Endpoints

Response Format

Conversations are returned as JSON objects containing an array of messages:

{
  "id": "conversation_id",
  "app_id": "69ccdcc0efe866e176c58546",
  "agent_name": "your_agent",
  "messages": [
    {
      "id": "message_id",
      "role": "user",
      "content": "Hello!",
      "tool_calls": [],
      "file_urls": []
    },
    {
      "id": "message_id",
      "role": "assistant",
      "content": "Hi! How can I help you?",
      "tool_calls": [],
      "file_urls": []
    }
  ],
  "metadata": {}
}

Rate Limits

API requests are rate-limited per user. If you exceed the limit, you'll receive a 429 status code. Wait and retry after a short delay.

Error Codes

401: Unauthorized — invalid or missing API key
403: Forbidden — you don't have access to this resource
400: Bad request — invalid input (e.g. message too long)
404: Not found — conversation or resource doesn't exist