Start up to five agent executions
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.
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
Headers
Opt-in idempotency token (max 255 chars). The FIRST request carrying a given key is processed normally and its 2xx response is cached for 24h, scoped to (api_key + method + path + request-body hash). A retry with the SAME key and body replays the cached response and adds Idempotency-Replayed: true. Reusing the same key with a DIFFERENT body returns 422 (idempotency_key_reuse). The cache is per-process and in-memory, so on a multi-replica deploy a retry that lands on a different task re-executes — callers must already tolerate at-least-once delivery.
Request body
Response
Batch processed; inspect each item for accepted/rejected state
Changes
No recorded changes to this operation across all 1 revision of this API.