Skip to main content
POST
/
v1
/
deepresearch
/
tasks
/
{id}
/
respond
curl --request POST \
  --url https://api.valyu.ai/v1/deepresearch/tasks/{id}/respond \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "interaction_id": "int_abc123",
  "response": {
    "answers": [
      {
        "question": "What geographic regions?",
        "answer": "North America and EU"
      },
      {
        "question": "Specific competitors?",
        "answer": "Tesla, BYD, Rivian"
      }
    ]
  }
}
'
{
  "success": true,
  "status": "running",
  "deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get yours at platform.valyu.ai.

Path Parameters

​
id
string
required

DeepResearch task ID.

Body

application/json
​
interaction_id
string
required

The interaction_id from the task's interaction field.

​
response
Planning Questions Response · object
required

Response data — shape depends on the checkpoint type (interaction.type).

Response

Response accepted. Task resumes processing.

​
success
boolean
Example:

true

​
status
enum<string>

running if container was still alive, queued if task was re-enqueued from paused state.

Available options:
running,
queued
Example:

"running"

​
deepresearch_id
string
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"