Batches

Add tasks to a batch

Add up to 100 research tasks to an existing batch. The batch must be in open or processing status.

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

Request

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

Path parameters

idstring required

Batch ID.

Request body

Example request

{
  "tasks": [
    {
      "query": "Analyze Tesla Q4 2024 earnings and forward guidance",
      "id": "task-tesla-q4"
    }
  ]
}

Response

Tasks added and queued.

batch_idstring required

ID of the batch.

addedinteger required

Number of tasks added.

Example response

{
  "batch_id": "batch_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "added": 5,
  "tasks": [
    {
      "status": "queued"
    }
  ],
  "counts": {
    "total": 10,
    "queued": 3,
    "running": 2,
    "completed": 4,
    "failed": 1
  }
}

Changes

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