Skip to main content
POST
Resolve an application user

Authorizations

Authorization
string
header
required

Darwin API keys begin with darwin_ and are created in Developer settings.

Path Parameters

applicationId
string
required

Body

application/json
externalUserReference
string
required

Stable application-scoped identifier. Darwin stores only a normalized digest in the durable mapping.

Required string length: 1 - 500
claims
object[]

Preview-only verified-claim hints. They do not affect current hosted-onboarding resolution, never authorize a global account merge by themselves, and are not logged.

Maximum array length: 10
proof
object

Preview proof envelope. It is shape-validated and redacted, but public proof exchange is not active yet; omit it to reuse a mapping or receive hosted onboarding.

Response

The durable Darwin user and Personal AI, or the hosted next step.

status
string
required
Allowed value: "READY"
darwinUserRef
string
required
darwinAiRef
string
required
verificationMethod
string