Submit a fingerprint event

Submits an SDK fingerprint payload and returns a client-scoped device id with curated signals. The OAuth client id is taken from the access token. clientId is not a request field. Safe retries of the same request use the standard Idempotency-Key header.

post/fingerprint/events

Headers

Idempotency-Keystring

Key used to make retry requests safe.

Request body

fingerprintstring required

Opaque base64 payload returned by the Stitch SDK.

correlationIdstring

Optional business reference for logs and support. Not an idempotency key.

userIdstring

Optional merchant user identifier. Not used for matching.

metadataFingerprintMetadata

Flat key-value object stored with the fingerprint event. Nested objects and arrays are rejected. Serialized JSON must be at most 4096 UTF-8 bytes.

Response

Fingerprint event resolved.

idstring required

Stitch event resource id.

correlationIdstring required

Merchant business reference for this submit.

userIdstring

Merchant-supplied user identifier.

deviceIdstring required

Client-scoped device identifier.