Start a live research page

POST

/v1/research-sessions

curl --request POST \
  --url https://www.cemented.ai/v1/research-sessions \
  --header 'Content-Type: application/json' \
  --data '{ "question": "example" }'

Creates a private retained page for a research question. Pass the returned id as researchId to /v1/search and /v1/contents. Unavailable under zero data retention.

Authorizations

• bearerAuth

Request Body ^required

Media type application/json

object

question

required

string

>= 1 characters <= 500 characters

Example ^generated

{
  "question": "example"
}

Responses

200

Private live research page

Media type application/json

object

id

required

string format: uuid

url

required

string format: uri

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "url": "https://example.com"
}

400

Invalid question or retention mode

Media type application/json

object

error

required

object

message

required

string

type

required

string

code

required

string

Example ^generated

{
  "error": {
    "message": "example",
    "type": "example",
    "code": "example"
  }
}

401

Unauthorized

Media type application/json

object

error

required

object

message

required

string

type

required

string

code

required

string

Example ^generated

{
  "error": {
    "message": "example",
    "type": "example",
    "code": "example"
  }
}