Skip to main content
POST

Authorizations

Authorization
string
header
required

A Curious API key: curious_sk_… (secret) or curious_pk_… (publishable), live or test environment (curious_sk_test_…). Publishable keys are serve-only and origin-gated; declare and identify require a secret key. A revoked or unknown key is a 401.

Body

application/json
user_id
string
required

The known user.

Minimum string length: 1
Pattern: \S
anonymous_id
string

The anonymous user to link into user_id.

Minimum string length: 1
Pattern: \S
identifiers
object

Durable identity (email, name, phone); merged into the user. Never a model feature.

attributes
object

Durable user state (plan, company_size); merged into the user and used for personalization.

Response

The link (or state update) was applied.

status
string
required
Allowed value: "success"