Execute Batch Agent Completions

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

post/v1/agent/batch/completions

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.

{"stackTrail":"components:schemas:AgentBatchCompletionResponse:properties:results:anyOf","oasType":"schema","type":"unknown","title":"Results","description":"The outputs generated by the agent.","nullable":true}

execution_timenumber nullable

The execution time of the agent batch completion.

timestampstring nullable

The timestamp when the agent batch completion was created.

Changes

Changed in 8 of the 80 revisions of this API.3346

Sep 2, 2026e05df8f412ad1See the full diff
- ○
  added the new None enum value to the request property ///
  request-property-enum-value-added
Aug 27, 20260882a16375db14See the full diff
- ▲
  removed from the // request property anyOf list
  request-property-any-of-removed
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added subschema #3 to the // request property anyOf list
  request-property-any-of-added
- ○
  added subschema #1 to the // request property anyOf list
  request-property-any-of-added
- ○
  added subschema #2 to the // request property anyOf list
  request-property-any-of-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 14, 2026dd6e1de072c711See the full diff
- ●
  the /// request property's min was set to 1.00
  request-property-min-set
- ○
  the request property default value medium was removed
  request-property-default-value-removed
Aug 4, 202674ed1cde0bfc2See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
Aug 2, 2026dcbc7787aed73See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  the request property default value changed from true to false
  request-property-default-value-changed
- ○
  the request property default value changed from gpt-4.1 to claude-sonnet-5
  request-property-default-value-changed
Aug 1, 202690f1182a9c4d26See the full diff
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  the request property default value changed from 10 to 30
  request-property-default-value-changed
- ○
  the request property default value changed from 10 to 30
  request-property-default-value-changed
- ○
  added the new minimal enum value to the request property ///
  request-property-enum-value-added
- ○
  added the new none enum value to the request property ///
  request-property-enum-value-added
Jul 31, 2026a4b2639c845e15See the full diff
- ▲
  removed the enum value minimal of the request property ///
  request-property-enum-value-removed
- ○
  the request property default value changed from 8192 to 16000
  request-property-default-value-changed
- ○
  the request property default value changed from low to medium
  request-property-default-value-changed
- ○
  added the new max enum value to the request property ///
  request-property-enum-value-added
- ○
  added the new ultra enum value to the request property ///
  request-property-enum-value-added
- ○
  added the new xhigh enum value to the request property ///
  request-property-enum-value-added
Jul 26, 20269666c890823b124See the full diff
- ▲
  request property /// was restricted to a list of enum values
  request-property-became-enum
- ●
  the /// request property's max was set to 2.00
  request-property-max-set
- ●
  the /// request property's min was set to 0.00
  request-property-min-set
- ○
  added the new high enum value to the request property ///
  request-property-enum-value-added
- ○
  added the new low enum value to the request property ///
  request-property-enum-value-added
- ○
  added the new medium enum value to the request property ///
  request-property-enum-value-added
- ○
  added the new minimal enum value to the request property ///
  request-property-enum-value-added

Full history