Audience

Store and retrieve contextual information about users in your audience. This data is embedded into your clone's memory, allowing it to personalize responses based on what you know about each user.

Create User Info

Add a piece of information about a user from your audience.

Endpoint: POST /v3/users/{user_id}/info

Path parameters:

Field	Type	Description
user_id	string	UUID of the user

Request body:

Field	Type	Required	Description
info	string	Yes	The information text
info_type	string	Yes	Category of the info (see table below)

Info types:

Value	Description
GOAL	Something the user is trying to achieve
PREFERENCES	User preferences or likes/dislikes
INTERESTS	Topics or areas the user is interested in
PERSONAL_INFO	General personal details
EXPERTISE	Skills or areas of knowledge
SITUATION	Current context or circumstances
BELIEF	Values or beliefs
COMMUNICATION_STYLE	How the user prefers to communicate
EMOTIONAL_STATE	Current emotional context
RELATIONSHIP	How the user relates to you or your work
WHY_DELPHI	Why the user interacts with your clone
HOW_DELPHI	How the user uses your clone
JOURNAL	Freeform notes

Example request:

curl -X POST "https://api.delphi.ai/v3/users/u-123/info" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "info": "Wants to improve their public speaking skills",
    "info_type": "GOAL"
  }'

Example response:

{
  "id": "info-001",
  "text": "Wants to improve their public speaking skills",
  "created_at": "2025-06-15T10:30:00.000Z",
  "updated_at": "2025-06-15T10:30:00.000Z",
  "message_id": null,
  "source": "API",
  "info_type": "GOAL"
}

---

Get User Info

Retrieve all stored information for a user who has interacted with your digital mind.

Endpoint: GET /v3/users/{user_id}/info

Path parameters:

Field	Type	Description
user_id	string	UUID of the user

Example request:

curl "https://api.delphi.ai/v3/users/u-123/info" \
  -H "x-api-key: YOUR_API_KEY"

Example response:

{
  "user_id": "u-123",
  "info_items": [
    {
      "id": "info-001",
      "text": "Wants to improve their public speaking skills",
      "created_at": "2025-06-15T10:30:00.000Z",
      "updated_at": "2025-06-15T10:30:00.000Z",
      "message_id": null,
      "source": "API",
      "info_type": "GOAL"
    },
    {
      "id": "info-002",
      "text": "Prefers short, actionable advice",
      "created_at": "2025-06-14T08:00:00.000Z",
      "updated_at": "2025-06-14T08:00:00.000Z",
      "message_id": null,
      "source": "API",
      "info_type": "PREFERENCES"
    }
  ],
  "total_count": 2
}

Items are sorted by newest first.

---

Delete User Info

Remove a specific piece of information about a user.

Endpoint: DELETE /v3/users/{user_id}/info/{info_id}

Path parameters:

Field	Type	Description
user_id	string	UUID of the user
info_id	string	ID of the info item to delete

Example request:

curl -X DELETE "https://api.delphi.ai/v3/users/u-123/info/info-001" \
  -H "x-api-key: YOUR_API_KEY"

Example response:

{
  "success": true,
  "message": "User info deleted successfully",
  "deleted_info_id": "info-001"
}