Create Batch | Mesh API Docs

curl -X POST https://api.meshapi.ai/v1/batches \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "requests": [
    {
      "custom_id": "item-1",
      "body": {
        "model": "openai/gpt-5.4",
        "messages": [
          {
            "role": "user",
            "content": "Summarize the following text: Small sample text..."
          }
        ],
        "max_tokens": 200,
        "temperature": 0.2
      },
      "method": "POST",
      "url": "/v1/chat/completions"
    },
    {
      "custom_id": "item-2",
      "body": {
        "model": "openai/gpt-5.4",
        "messages": [
          {
            "role": "user",
            "content": "Translate to French: Hello world"
          }
        ]
      },
      "method": "POST",
      "url": "/v1/chat/completions"
    }
  ],
  "completion_window": "24h",
  "metadata": {
    "job_name": "my-batch-job"
  }
}'

Create a batch job.

Accepts requests inline — no separate file upload step required. Model and provider are resolved from body.model across all requests; all requests must target the same model.

Returns 429 (batch_limit_exceeded) if the owner already has 10 or more batches in a non-terminal state. Returns 501 (not_implemented) if the resolved provider doesn’t support batch.

Create a batch job. Accepts requests inline — no separate file upload step required. Model and provider are resolved from `body.model` across all requests; all requests must target the same model. Returns 429 (batch_limit_exceeded) if the owner already has 10 or more batches in a non-terminal state. Returns 501 (not_implemented) if the resolved provider doesn't support batch.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

requestslist of objectsRequired

completion_windowstringOptionalDefaults to 24h

metadatamap from strings to any or nullOptional

Response

Successful Response

Errors

422

Unprocessable Entity Error