Server-Side Users

If your product already has a stable app-local user ID, Configure can create a developer-scoped profile without a user-present link flow.

apiKey (your sk_ key) and the agent handle come from npx configure setup (see Installation). The SDK constructor always requires agent. You can also supply it through the CONFIGURE_AGENT environment variable. Single-agent auto-resolve applies only to raw HTTP calls that omit the X-Agent header.

import { Configure } from "configure";

const configure = new Configure({
  apiKey: process.env.CONFIGURE_API_KEY,
  agent: "your-agent",
});

const profile = configure.profile({ externalId: "customer-123" });

const saved = await profile.remember("User prefers billing receipts by email.");
const read = await profile.read({
  sections: ["identity", "preferences", "summary"],
});

Deletion works for unlinked profiles too. Capture the memory id from the remember response, then call forget:

await profile.forget(saved.memory!.id, { reason: "user_request" });

forget deletes only memories in your agent's own namespace. The user_request reason also suppresses re-learning the fact from other sources.

These unlinked profiles are scoped to your developer account. Other developers cannot resolve or read them.

The same unlinked profile is reachable over MCP: use the developer adapter with CONFIGURE_USER_ID (or your API-key MCP server with the user id per request). See MCP adapter.

externalId is your identifier, not a Configure-generated user ID. It is required for unlinked profiles because there is no linked Configure token to resolve the user.

There is an upgrade path when the user verifies by phone. Pass the same identifier to auth.verifyOtp(phone, code, { externalId }) during headless OTP verification. On success, Configure links the unlinked profile to the verified user and migrates its data. The link is idempotent and returns merged: false if the profile is already linked. The browser Configure Link flow does not carry externalId yet, so use the headless OTP verify for this reconciliation.