Create a research task

Starts an asynchronous Research Agent task and returns a status URL to poll.

POST/api/agents/{agentId}/tasks/create

Authorization

AuthorizationBearer token · headerrequired

SIBI API token from the SIBI Developer Portal.

Path parameters

agentIdstringrequired

Research Agent ID assigned to your organization.

Request body

requiredapplication/json

messagestringrequired

A product model, part number, description, or follow-up answer.

min length 1

attachmentsAttachment[]

default: []

Show properties

Array of Attachment

typeanyrequired

urlstringrequired

An HTTP(S) URL or supported data URL.

mediaTypestringrequired

Media type of the file.

filenamestringrequired

Filename presented to Research Agent.

Responses

202

Task accepted.

statusanyrequired

taskIdstringrequired

statusUrlstring<uri>required

400

The request body is invalid.

errorstringrequired

detailsobject

401

The bearer token is missing or invalid.

errorstringrequired

403

The authenticated user cannot access the requested agent.

errorstringrequired

Request

curl -X POST "https://agents.sibi.ai/api/agents/string/tasks/create" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "message": "string",
  "attachments": []
}'

const response = await fetch("https://agents.sibi.ai/api/agents/string/tasks/create", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"message\": \"string\",\n  \"attachments\": []\n}"
});

Response

{
  "status": "pending",
  "taskId": "string",
  "statusUrl": "http://example.com"
}

{
  "error": "string",
  "details": {}
}

{
  "error": "Unauthorized"
}

{
  "error": "Forbidden"
}