POST
/
mesh_task_create
curl --request POST \
  --url https://sequencer-v2.heurist.xyz/mesh_task_create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": "CoinGeckoTokenInfoAgent",
  "agent_type": "AGENT",
  "task_details": {
    "query": "Tell me about ethereum"
  }
}'
{
  "task_id": "<string>",
  "msg": "<string>"
}

The task creation endpoint allows you to initiate long-running tasks to be executed in the background.

​
Base URL

https://sequencer-v2.heurist.xyz

​
Authentication

All requests require a Bearer token in the Authorization header.

​
Task Flow

  1. Create a task using /mesh_task_create
  2. Query task status using /mesh_task_query until completion

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
JSON payload for creating a task
​
agent_id
enum<string>
default:CoinGeckoTokenInfoAgent
required

Identifier of the agent to use

Available options:
AaveAgent,
AlloraPricePredictionAgent,
BitquerySolanaTokenInfoAgent,
CarvOnchainDataAgent,
CoinGeckoTokenInfoAgent,
DeepResearchAgent,
DexScreenerTokenInfoAgent,
DuckDuckGoSearchAgent,
ElfaTwitterIntelligenceAgent,
ExaSearchAgent,
FirecrawlSearchAgent,
FundingRateAgent,
GoplusAnalysisAgent,
MasaTwitterSearchAgent,
MetaSleuthSolTokenWalletClusterAgent,
PumpFunTokenAgent,
ZerionWalletAnalysisAgent,
ZkIgniteAnalystAgent
​
task_details
object
required
​
agent_type
string
default:AGENT

Type of agent

Response

200
application/json
Task created successfully
​
task_id
string

Unique task identifier

​
msg
string

Status message