Chat preferences

The retarget endpoint uses an editable system prompt to steer how proactive openers sound. These two endpoints read and set it. Both require the chat:companion scope.

Get preferences

GET /api/v1/me/chat-preferences

{
  "retarget_system_prompt": null,
  "resolved_retarget_system_prompt": "You are reaching out first to re-engage the user...",
  "is_default": true,
  "default_prompt": "You are reaching out first to re-engage the user..."
}

Field	Type	Notes
retarget_system_prompt	string | null	Your saved override, or null when you haven't set one.
resolved_retarget_system_prompt	string	The prompt actually used (your override, or the default).
is_default	boolean	true when no override is set.
default_prompt	string	The built-in default, for reference.

Set preferences

PUT /api/v1/me/chat-preferences

Field	Type	Required	Notes
retarget_system_prompt	string	✓	Up to 8000 chars. Send an empty or whitespace-only string to reset to the default.

curl -X PUT https://api.phantomrouter.ai/api/v1/me/chat-preferences \
  -H "Authorization: Bearer $PHANTOM_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "retarget_system_prompt": "Reach out warmly, reference a shared memory, ask one question." }'

Returns the same shape as Get preferences. See Retarget for how this prompt is used.