Skip to main content
Finkkle One is currently undergoing a major overhaul. The Spaces stream API is disabled until further notice. Finkkle Trends remains accessible. More details soon.
The Spaces stream API powers the Finkkle Spaces AI conversation experience. Send a conversation history and receive a streaming AI response — with tool execution and source synthesis happening automatically behind the scenes, orchestrated by the Spaces planning model.

POST /api/spaces/stream

Request body

array
required
Array of conversation turns in order. Each entry has a role and content.

Multi-turn conversation

To continue a conversation, include the full history:

Response

The endpoint returns a streaming text response. The model may execute tools (search, retrieval, calculation) transparently and synthesize results into the final response.

Integration notes

  • Include full history — the model has no memory between requests. Always send the complete conversation history for multi-turn interactions.
  • Set timeouts — the Spaces stream can run for several seconds on complex queries. Set a timeout of at least 30 seconds.
  • Log request IDs — capture the request ID from the response headers for debugging.
  • Sanitize inputs — validate and normalize user inputs before sending. Never forward raw, unvalidated user input directly to the API in a production application.
Do not include passwords, API keys, or sensitive personal data in the conversation history you send to the API. Treat the Spaces stream endpoint like any other AI service — keep credentials and secrets out of prompts.

Use cases