---
title: "Update the item's public-page settings (product CTA link)"
method: POST
path: "/v1/items/{id}"
tags: ["items"]
---

# Update the item's public-page settings (product CTA link)

`POST /v1/items/{id}`

## Request

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

Sets the 'view product' button shown on the public AR page and embeds. product_url must be a public https URL on your own site, and it may not point at pixeloa.ai itself or a private network (422 validation_error otherwise). Pass null to clear it (the label clears with it). product_cta_label (max 60 chars) overrides the default button text. Clicks are counted in the owner's analytics.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `product_url` string, uri, nullable
  - `product_cta_label` string, nullable

## Response `200`

The updated item (see product_cta).

- Item
  - `id` string, uuid
  - `title` string
  - `description` string, nullable
  - `status` 'draft' | 'analyzing' | 'awaiting_confirmation' | 'confirmed' | 'generating' | 'ready' | 'failed'
  - `visibility` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable
  - `dimensions_cm` object
    - `confirmed` object, nullable
    - `estimated` object, nullable
  - `model` object
    - `available` boolean
    - `sha256` string, nullable
  - `public` object
    - `published` boolean
    - `slug` string, nullable
    - `ar_url` string, uri, nullable
    - `embed_url` string, uri, nullable
  - `publishable` object: Row-level pre-check for POST /publish; POST /publish reports the exact resolver state on 409.
    - `ok` boolean
    - `blockers` string[]
  - `next_allowed_actions` string[]

## 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)