DeepResearch

Add a follow-up instruction to a running task

Send a follow-up instruction to a running DeepResearch task. The instruction can only be added before the writing phase begins. Use this to steer the research in a specific direction based on intermediate findings.

post/v1/deepresearch/tasks/{id}/update

Request

  • Base URL: https://api.valyu.ai
  • URL: https://api.valyu.ai/v1/deepresearch/tasks/{id}/update
  • Auth: API key in header X-API-Key

Path parameters

idstring required

DeepResearch task ID.

Request body

instructionstring required

Follow-up instruction for the research agent.

Example request

{
  "instruction": "Also compare the safety profiles across all trials"
}

Response

Instruction added successfully.

successboolean required

Whether the operation succeeded.

messagestring required

Human-readable status message.

deepresearch_idstring required

ID of the affected task.

Example response

{
  "success": true,
  "message": "Instruction added",
  "deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Changes

No recorded changes to this operation across all 1 revision of this API.