Configure Your AI Twin

An AI Twin is a system-managed profile that adapts to permitted activity. You do not create, replace, or directly author its memories. The public API lets you find your personal Twin, set preferences, and review or correct stored memories.

Prerequisites

• A Chainabit account with a bearer token
• A plan that includes AI Twin access
• curl

export TOKEN="YOUR_API_KEY"
export BASE_URL="https://api.chainabit.com/api/v1"

1. Find Your Twin

A successful request returns the caller's personal Twin in the standard data envelope. Save its id for memory and brain requests:

export TWIN_ID="YOUR_TWIN_ID"

The API returns 404 when a personal Twin has not been provisioned yet.

2. Apply Onboarding Preferences

Use the wizard endpoint to provide initial goals and presentation preferences:

The response is 201 Created with { "data": { "applied": true } }. The accepted values are:

• verbosity: concise, moderate, or detailed
• format: bullets, paragraphs, or mixed
• tone: professional, casual, academic, or friendly

3. Update Personal Preferences

Send only the fields you want to change:

memoryRetentionDays accepts 1 through 3650; sensitivityLevel accepts low, med, or high. Public showcase access is opt-in and is off unless you enable it.

4. Review Memories

curl -s "$BASE_URL/agents/twins/$TWIN_ID/memories?limit=20&offset=0" \
  -H "Authorization: Bearer $TOKEN"

Memories are derived by the service. If one is wrong, flag it; if it must be removed, delete it using the endpoints in the Twins API reference.

Failure Behavior

• 400 Bad Request — malformed preference values or identifiers
• 401 Unauthorized — missing or invalid token
• 403 Forbidden — the account or plan does not permit the operation
• 404 Not Found — the Twin or memory is not available to the caller
• 429 Too Many Requests — retry after the rate-limit window

Next Steps

• Twins API reference
• Twin Brain API
• Start a Chao session