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

circle-info

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

Last updated