@xfloor-memory-sdk
  1. Get Started
@xfloor-memory-sdk
  • Get Started
    • Overview
    • Quick Start
    • Authentication and Identification
    • Core Concepts (5-Minute Read)
    • What to Use First (API Map)
  • SDK
    • Overview
    • SDK Installation & Setup
    • Python SDK
    • JavaScript SDK
    • Typescript SDK
    • Java SDK
    • FAQ & Troubleshooting
    • Copy-Paste Debug Checklists
  • Core FloorMemory
    • Query (Primary API)
      POST
    • Create Event (Post Content)
      POST
    • Recent Events
      GET
    • Basic information of a floor
      GET
  • Floor Management
    • Edit floor
      POST
    • Make floor Private
      POST
    • Make floor public
      POST
    • Rename floor
      POST
  • Registration
    • Sign Up
      POST
    • Sign In with email ID
      POST
    • Sign In with Mobile number
      POST
    • Validation
      POST
    • Change Password
      POST
    • Reset Password
      POST
    • Change email ID
      POST
    • Change Mobile number
      POST
    • Send Validation code
      POST
    • External User Registration
      POST
  • SDKs
  • Schemas
    • PostAdd
    • QueryResponse
    • Media
    • UserDetails
    • SignUpResponse
    • BlockDetails
    • FloorInfo
    • Threads
    • EventResponse
    • 400ErrorCode
    • Remaining
  1. Get Started

What to Use First (API Map)

Here’s a clean rewrite of that section with the missing concept clearly communicated, without adding noise or changing your intent. I’ve only added what’s necessary to explain the default pod floor behavior.

Most applications do not need every FloorMemory API.
Start small.

Minimum APIs for Most Apps#

You can build a complete assistant using just:
1.
Query API
Conversational interaction with memory
2.
Create Event
Add knowledge to a Floor
3.
Get Conversations
Resume past conversations (optional)
Everything else is optional.

🚀 Important: Default Pod Floor (Auto-Created)#

When a developer creates an App ID in the xFloor Developer Console, xFloor automatically creates a default Floor for that app.
This default Floor:
Is owned by the developer
Acts as the pod / memory container for that App
Requires no manual floor creation
Can immediately accept Create Event and Query calls
Is ideal for:
first-time integrations
prototypes
single-assistant applications
👉 In most cases, you do not need to create a Floor explicitly to get started.
You can start using FloorMemory APIs immediately with the auto-created pod floor.

When to Use Other APIs#

API GroupUse When
Feed APIsShowing recent activity
Registration APIsYou don’t manage users
Floor ManagementAdmin dashboards or multi-floor apps
Password APIsxFloor-managed identity

Recommended First Build#

1.
Create an App ID (default pod floor is auto-created)
2.
Add content using Create Event
3.
Ask questions using Query API
4.
Iterate on prompts and content
Do not start with:
Registration
Feeds
Advanced filters
Floor management APIs
Those come later—only if needed.

TL;DR#

Create App → Get Pod Floor → Add Content → Ask Questions
That’s enough to build a useful assistant.
Modified at 2026-01-28 11:14:52
Previous
Core Concepts (5-Minute Read)
Next
Overview
Built with