API Usage

Megabyte Island provides a secure chat proxy so you can send messages to your AI agent from your own product — without ever exposing your master API token.

Chat Endpoint

POST /api/agents/:agentId/chat

Authentication: Include your session cookie (set automatically after login) or pass Authorization: Bearer <jwt>.

Request body

{
  "message": "What are your opening hours?",
  "conversationId": "optional-uuid-for-history"
}

Response

The endpoint streams a Server-Sent Events (SSE) response. Each chunk is a partial token from the model.

data: {"token": "Our"}
data: {"token": " opening"}
data: {"token": " hours"}
data: {"token": " are 9am–6pm."}
data: [DONE]

Example — JavaScript (fetch + SSE)

const response = await fetch(`https://agents.megabyteisland.com/api/agents/${AGENT_ID}/chat`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',     // sends session cookie
  body: JSON.stringify({ message: userMessage, conversationId: sessionId }),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const chunk = decoder.decode(value, { stream: true });
  // Append chunk to your chat UI
  appendToChat(chunk);
}

Error Responses

Rate Limits

Rate limits are governed by your Gradient AI plan. Megabyte Island does not impose additional limits beyond those inherited from the platform.