Generate chat title stream

Enterprise-only AI endpoint that generates a short title from conversation messages. Requires a valid Auth.js session and the aiAssistant experimental feature enabled for the tenant. The handler sends the messages to OpenRouter and returns Server-Sent Events; the implementation emits a generated title event and a completion event rather than a conventional JSON response.

Request body

Content type: application/json · schema ChatTitleStreamRequest

inputsarray of ChatMessageRequired

Conversation messages used as context for generating a short chat title.

min items 1

itemsobject

rolestringRequired

Role of the message author in the conversation.

Enum: userassistant

contentstringRequired

Message text sent to the chat model.

Response codes

200

SSE stream of title-generation events.

403

AI Assistant feature is not enabled for the tenant.

404

Chat streaming is not available in this edition.

500

Malformed request, missing model credentials, or another internal streaming failure.

POST /api/chat/stream/title

cURL

curl -X POST "https://algapsa.com/api/chat/stream/title" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": [
    {
      "role": "user",
      "content": "string"
    }
  ]
}'

TypeScript

const response = await fetch("https://algapsa.com/api/chat/stream/title", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "inputs": [
      {
        "role": "user",
        "content": "string"
      }
    ]
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/chat/stream/title");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""inputs"": [
    {
      ""role"": ""user"",
      ""content"": ""string""
    }
  ]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();