---
title: "Start up to five agent executions"
method: POST
path: "/v1/agent/batch"
tags: ["Agent Execution"]
---

# Start up to five agent executions

`POST /v1/agent/batch`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/agent/batch`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Submit 1-5 durable executions in one request. Each request id must be unique. Every accepted item consumes its own daily query credit; rejected items include a stable error code. Use an Idempotency-Key to replay the batch safely.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `requests` object[], required
    - `message` string, required
    - `session_id` string, uuid
    - `mode` 'auto' | 'deep'
    - `domain` 'crypto' | 'us_equities' | 'india_stocks'
    - `portfolio_id` string, uuid, nullable
    - `include_portfolio` boolean, nullable
    - `include_facts` true: Async agent executions always include the neutral evidence projection.
    - `response_format` object
      - `type` 'text' | 'json_schema' | 'trade_setup'
      - `json_schema` object
    - `id` string, required

## Response `202`

Batch processed; inspect each item for accepted/rejected state

- object

## Other responses

- `400`: Invalid batch
- `401`: Authentication required
- `403`: Scope or tier denied

---

[API](https://skmtc.dev/marketintell/apis/marketintell-api.md) · [All operations](https://skmtc.dev/marketintell/apis/marketintell-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marketintell/apis/marketintell-api/revisions/f3ef87afc41f?raw)