Skip to main content
POST
Add a follow-up instruction to a running task
Add a follow-up instruction while research is running, before the writing phase begins. Use this to refine the investigation rather than submitting an unrelated second task. Check the current task state first. An update can be rejected if the task has advanced past the supported phase; show that response to the user rather than implying the instruction was applied.

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

Follow-up instruction to guide a running research task. Can only be sent before the writing phase begins.

instruction
string
required

Follow-up instruction for the research agent.

Example:

"Also compare the safety profiles across all trials"

Response

Instruction added successfully.

success
boolean
required

Whether the operation succeeded.

Example:

true

message
string
required

Human-readable status message.

Example:

"Instruction added"

deepresearch_id
string
required

ID of the affected task.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"