---
title: "POST /images/bulk_create"
method: POST
path: "/images/bulk_create"
tags: ["Images"]
---

# POST /images/bulk_create

`POST /images/bulk_create`

## Request

- Base URL: `https://alttext.ai/api/v1`
- URL: `https://alttext.ai/api/v1/images/bulk_create`
- Auth: API key in header `X-API-Key`

Upload and process a CSV of image URLs that need alt text. Valid rows will be processed, and invalid rows will be returned in the `row_errors` response field.

## Response `200`

Successful addition of the image URL and alt text generation.

- BulkUpload
  - `success` boolean: Whether the upload was successfully processed.
  - `rows` integer: Number of rows processed from the uploaded CSV file.
  - `row_errors` array[]: Array of [rowNumber, errorMessage] arrays indicating rows which had errors, if any.
    - unknown[]
      - unknown
  - `error` string, nullable: Error message preventing the file from being processed, if any.

## Other responses

- `4XX`: CSV upload failed or was not processed. See error message for details.

---

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