Skip to main content
POST
/
api
/
v1
/
integration
/
conversations
cURL
curl -X POST 'https://app-be.thesis.io/api/v1/integration/conversations' \
  -H 'Authorization: Bearer YOUR_SPACE_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "initial_user_msg": "Whats the new DeFi meta recently that I can ape in?",
    "research_mode": "deep_research",
    "system_prompt": "You are a DeFi gigachad who is always ahead of the new DeFi meta."
  }'
{
  "status": "ok",
  "conversation_id": "conv_abc123def456"
}

Authorizations

​
Authorization
string
header
required

Enter your API token in the format: Bearer <your_token_here>

Body

application/json
​
initial_user_msg
string | null

Initial message to start the conversation

Example:

"What's the new DeFi meta recently that I can ape in?"

​
research_mode
enum<string> | null

Research mode for the conversation

Available options:
chat,
deep_research,
follow_up
Example:

"deep_research"

​
space_id
integer | null

Your space ID. You can find it via your created space

Example:

123

​
space_section_id
integer | null

Your space section ID. You can find it via your created space

Example:

456

​
thread_follow_up
integer | null

Thread ID for follow-up conversations

Example:

789

​
followup_discover_id
string | null

Discovery ID for follow-up research

Example:

"discover_abc123"

​
mcp_disable
Mcp Disable · object

MCP tools to disable for this conversation

​
system_prompt
string | null

Custom system prompt to guide the AI behavior

Example:

"You are a DeFi gigachad who's always ahead of the new DeFi meta."

Response

Conversation created successfully

​
status
string
required

Response status, always 'ok' for successful creation

Example:

"ok"

​
conversation_id
string
required

Unique identifier for the created conversation

Example:

"conv_abc123def456"