---
title: "Queue an image for Items & Characteristics classification"
method: POST
path: "/classify/items-characteristics/image"
tags: ["ITEMS_CHARACTERISTICS"]
---

# Queue an image for Items & Characteristics classification

`POST /classify/items-characteristics/image`

This endpoint queues job that predicts the Items & Characteristics categories of a single image.

The request must contain either file (a multi-part form encoded image file) or url (a string containing a url to a image file)

Example CURL:
```
curl -i -X POST -H "Authorization: Bearer {API_TOKEN}" -H "Content-Type: multipart/form-data"          -F "file=@image.jpg;type=image/jpeg"  https://api.unitary.ai/v1/classify/items-characteristics/image
```

A job ID will be returned in the response.

If `callback_url` is included in the request then results will be POST'd to this URL once the image has been classified.

Alternatively results can be obtained by making a GET request to results endpoint using the job ID.

**Webhooks should be implemented for any use of this endpoint at scale to prevent unnecessary polling of the results endpoint.**

## Response `200`

Successful Response

- JobIDResponse
  - `job_id` string, uuid4, required

## Other responses

- `404` — Not found
- `422` — Validation Error

## Changes

- **2026-09-01** `e649db8f5cc8` — 1 breaking, 1 warning, 9 info
  - the request's body type changed from no type to `object`
  - removed `#/components/schemas/Body_image_items_characteristics_classify_classify_items_characteristics_image_post` from the request body `allOf` list
  - added the new optional request property `callback_url`
  - added the new optional request property `caption`
  - …7 more

[Change history](https://skmtc.dev/unitary/apis/unitary-content-classification-api/changes/classify/items-characteristics/image/post.md)

---

[API](https://skmtc.dev/unitary/apis/unitary-content-classification-api.md) · [All operations](https://skmtc.dev/unitary/apis/unitary-content-classification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitary/unitary-content-classification-api/revisions/e649db8f5cc8/schema)