Sign in
Models

Create a companion from onboarding funnel answers

Creates a private companion from the marketing-funnel quiz answers, reusing the static paywall avatar instead of generating one. Charges no coins and is not gated by the model limit. Idempotent per user: a repeat call (same or new sessionId) returns the existing onboarding companion.

post/v1/models/from-onboarding

Request body

sessionIdstring required

Acquisition session id of the funnel run, stored on the created model for tracing. Idempotency itself is per user: any repeat call returns the existing onboarding companion.

gender'male' | 'female' required

Companion gender, from the funnel welcome answer.

agestring

Raw funnel age bucket token (e.g. "18-24").

ethnicitystring

Raw funnel ethnicity token (e.g. "european").

bodyShapestring

Raw funnel body_shape token.

hairColorstring

Raw funnel hair_color token (female grid).

requestIdstring

Optional request id for analytics correlation.

Example request

{
  "sessionId": "b1b3d2f0-5a4c-4e2f-9a1b-1234567890ab",
  "gender": "female",
  "age": "18-24",
  "ethnicity": "european",
  "bodyShape": "athletic",
  "hairColor": "brunette"
}

Response

Companion creation enqueued

modelIdstring required

The model ID

balancenumber required

The balance after the model creation

Example response

{
  "modelId": "123e4567-e89b-12d3-a456-426614174000",
  "balance": 100
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.