External User Registration

This API allows a calling application to pass externally authenticated user identity information to xfloor after completing authentication within its own system.

xfloor does not perform authentication, credential verification, or session management as part of this API. The calling application is fully responsible for validating the user and ensuring the correctness of the identity data provided.

Upon invocation, xfloor will:

Create a new user profile if no matching user exists, or

Update the existing user profile if the user is already present.

xfloor returns a unique xfloor_user_id, which serves as the canonical user identifier and must be used in all subsequent xfloor APIs, including floors, blocks, conversations, memory interactions, and analytics.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://appfloor.in/memory/identity/external-user' \ --header 'Authorization: Bearer <token>' \ --form 'mobile_number=""' \ --form 'email_id=""' \ --form 'name=""' \ --form 'app_id=""'

{ "pod_info": { "fid": "string", "floor_id": "string", "title": "string", "details": "string" }, "profile": { "floor_id": "string", "fid": "string", "name": "string", "email": "string", "mobile_number": "string", "user_id": "string", "avatar": { "url": "string", "id": "string" } } }

Request

Responses