---
title: "Add an item to a catalog (appends unless position is given)"
method: POST
path: "/v1/catalogs/{id}/items"
tags: ["catalogs"]
---

# Add an item to a catalog (appends unless position is given)

`POST /v1/catalogs/{id}/items`

## Request

- Base URL: `https://pixeloa.ai`
- URL: `https://pixeloa.ai/v1/catalogs/{id}/items`
- Auth: HTTP bearer

Both the catalog and the item must belong to the key's account (404 otherwise). 409 conflict when the item is not ready (details.status says where it is), is not eligible for catalogs, is unlisted (link only), or is already in the catalog.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `item_id` string, uuid, required
  - `position` integer

## Response `200`

OK

- object

## Other responses

- `401`: Error envelope
- `403`: Error envelope
- `404`: Error envelope
- `409`: Error envelope
- `422`: Error envelope
- `429`: Error envelope

---

[API](https://skmtc.dev/pixeloa/apis/pixeloa-api.md) · [All operations](https://skmtc.dev/pixeloa/apis/pixeloa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pixeloa/apis/pixeloa-api/revisions/10a8178bed64?raw)