Questions

Get questions

Retrieve the suggested questions configured for your clone. These are the conversation starters shown on your clone's profile.

Endpoint: GET /v3/questions

Query parameters:

Parameter	Type	Required	Default	Description
type	string	No	"pinned"	Filter: pinned, unpinned, or all
count	integer	No	5	Number of questions to return (1–100)
randomize	boolean	No	false	Return questions in random order

Type values:

Value	Description
pinned	Visible questions shown on your profile
unpinned	Backlog questions not currently visible
all	Both pinned and unpinned questions

Example request:

curl "https://api.delphi.ai/v3/questions?type=pinned&count=3" \
  -H "x-api-key: YOUR_API_KEY"

Example response:

{
  "questions": [
    {
      "id": "q-001",
      "index": 2,
      "question": "What's your best advice for beginners?",
      "pinned": true,
      "user_edited": false,
      "created_at": "2025-06-01T12:00:00.000Z",
      "updated_at": "2025-06-01T12:00:00.000Z"
    },
    {
      "id": "q-002",
      "index": 1,
      "question": "How did you get started in your career?",
      "pinned": true,
      "user_edited": true,
      "created_at": "2025-05-20T09:00:00.000Z",
      "updated_at": "2025-06-10T14:30:00.000Z"
    }
  ]
}

Response fields:

Field	Type	Description
id	string	Question UUID
index	integer	Display order index
question	string	The question text
pinned	boolean	Whether the question is visible on the profile
user_edited	boolean	Whether the question was manually edited
created_at	string	ISO 8601 timestamp
updated_at	string	ISO 8601 timestamp

By default, questions are ordered by index descending. Use randomize=true to shuffle the order.