Skip to main content
POST
/
agent
/
deepresearch
/
interactive
Deepresearch Interactive Agent
curl --request POST \
  --url https://chat.sambanova.ai/api/agent/deepresearch/interactive \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "resume": false,
  "thread_id": "<string>"
}
'
{
  "status": "interrupt",
  "thread_id": "thread-a"
}

Authorizations

Authorization
string
header
required

SambaNova API Key

Body

application/json

Request for deep research interactive agent json object

prompt
string
required

The main prompt for the deep research interactive agent

resume
boolean
default:false

Whether to describe the results or not

thread_id
string | null

thread id for persistent context

Response

Successful Response

Unified schema for agent responses, including success and interrupt states.

status
string
required

status of agent gereneration

thread_id
string
required

Identifier for maintaining persistent conversation or context

result
string

results description

artifacts
string[]

List of generated artifact IDs (e.g., files, images, reports)

ID of a generated artifact

file_ids
string[]

Optional list of file identifiers associated with the response

ID of an uploaded or generated file

interrupt
Interrupt · object

Information about an interrupt event requiring user action