---
title: "Update an item"
method: PUT
path: "/api/item/{id}"
tags: ["Item"]
---

# Update an item

`PUT /api/item/{id}`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/item/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/item/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates an existing item with new data including definition and synonyms

## Path parameters

- `id` integer, required

## Request body

- AssetStoreUpdateRequest
  - `name` string, required: Name of the asset
  - `item_platform_id` integer, required: Platform ID
  - `item_subplatform_id` integer, required: Subplatform ID
  - `item_grouping_id` integer, required: Grouping ID
  - `default_rank` integer: Default rank for the asset
  - `description` string: Description of the asset
  - `hasAmount` boolean: Whether the asset has amount
  - `hasDescription` boolean: Whether the asset has description
  - `hasFrequency` boolean: Whether the asset has frequency
  - `hasImages` boolean: Whether the asset has images
  - `hasVideos` boolean: Whether the asset has videos
  - `isDigital` boolean: Whether the asset is digital
  - `isPrint` boolean: Whether the asset is print
  - `isRadio` boolean: Whether the asset is radio
  - `isSocial` boolean: Whether the asset is social
  - `isSponsor` boolean: Whether the asset is sponsor
  - `isTv` boolean: Whether the asset is TV
  - `isVendor` boolean: Whether the asset is vendor
  - `isOutOfHome` boolean: Whether the asset is out of home
  - `definition` string: Definition of the asset
  - `synonyms` string[]: All of the asset's synonyms. On an update, a name already saved keeps its row, a saved name that is not sent is deleted and a new name is added; leave the field out to keep the synonyms as they are.

## Response `200`

Item updated successfully

- AssetResource
  - `id` integer: Asset ID
  - `name` string: Asset name
  - `description` string, nullable: Asset description
  - `default_rank` integer: Default rank for the asset
  - `item_platform_id` integer: Platform ID
  - `item_subplatform_id` integer: Subplatform ID
  - `item_grouping_id` integer: Grouping ID
  - `hasFrequency` boolean: Whether the asset has frequency
  - `hasDescription` boolean: Whether the asset has description
  - `hasImages` boolean: Whether the asset has images
  - `hasVideos` boolean: Whether the asset has videos
  - `hasSocialMediaValue` boolean: Whether the asset has social media value
  - `hasAmount` boolean: Whether the asset has amount
  - `is_premium` boolean: Whether the asset is premium
  - `isSponsor` boolean: Whether the asset is sponsor
  - `isTv` boolean: Whether the asset is TV
  - `isRadio` boolean: Whether the asset is radio
  - `isVendor` boolean: Whether the asset is vendor
  - `isSocial` boolean: Whether the asset is social
  - `isDigital` boolean: Whether the asset is digital
  - `isPrint` boolean: Whether the asset is print
  - `isOutOfHome` boolean: Whether the asset is out of home
  - `definition` string, nullable: Asset definition name
  - `synonyms` string[]: Array of synonym strings

## Other responses

- `401`: Unauthenticated
- `404`: Item not found
- `422`: Validation error

---

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