Execute Batch Agent Completions

Changed on Oct 16, 2026

Execute multiple agent completions concurrently using optimized thread pool execution. This is a premium-only feature.

post/v1/agent/batch/completions

Request

Base URL
https://api.swarms.world
URL
https://api.swarms.world/v1/agent/batch/completions
Auth
none declared. Required headers: x-api-key

Headers

x-api-keystring required

Request body

taskstring nullable

The task to be completed by the agent.

imgstring nullable

A base64 encoded image for the agent to process. Encode your image file to base64 and pass it here.

imgsstring[] nullable

A list of base64 encoded images for the agent to process. Encode your image files to base64 and pass them here.

tools_enabledstring[] nullable

A list of tools that the agent should use to complete its task.

Response

Successful Response

batch_idstring nullable

The unique identifier for the agent batch completion.

total_requestsinteger nullable

The total number of requests in the batch.

resultsunknown

execution_timenumber nullable

The execution time of the agent batch completion.

timestampstring nullable

The timestamp when the agent batch completion was created.

Changes

Oct 16, 2026500c79520e41 Revision changes
- breaking
  removed subschema #2 from the / request property anyOf list
- breaking
  the request property / became required
- breaking
  the / request property type changed from no type to object
- info
  api tag Agents added
- info
  api tag Batch Processing added
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the new optional request property //
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history