---
title: "Update an item's mutable metadata (editor/admin on its project)."
method: POST
path: "/v1/items/update"
tags: ["resource-facade"]
---

# Update an item's mutable metadata (editor/admin on its project).

`POST /v1/items/update`

## Headers

- `x-api-key` string, nullable

## Request body

- ItemUpdateInput
  - `collection_id` string, nullable
  - `name` string, nullable
  - `description` string, nullable
  - `geometry` object, nullable
  - `bbox` number[], nullable
  - `datetime` string, nullable
  - `cloud_cover` number, nullable
  - `gsd` number, nullable
  - `properties` object, nullable
  - `lifecycle_state` 'active' | 'expiring' | 'archived' | 'expired' | 'deleted'
  - `item_id` string, required

## Response `200`

Successful Response

- ItemResponse — Item as returned from the API.
  - `id` string, required
  - `project_id` string, required
  - `collection_id` string, nullable
  - `stac_id` string, required
  - `type` 'satellite_capture' | 'derived_raster' | 'derived_vector' | 'derived_pointcloud' | 'derived_tabular' | 'clip' | 'mosaic' | 'document' | 'user_raster' | 'user_vector' | 'external_reference', required
  - `geometry` object, nullable
  - `bbox` number[], nullable
  - `datetime` string, date-time, nullable
  - `start_datetime` string, date-time, nullable
  - `end_datetime` string, date-time, nullable
  - `cloud_cover` number, nullable
  - `gsd` number, nullable
  - `name` string, required
  - `description` string, nullable
  - `properties` object
  - `stac_extensions` string[]
  - `lifecycle_state` 'active' | 'expiring' | 'archived' | 'expired' | 'deleted'
  - `access_model` string, nullable
  - `expires_at` string, date-time, nullable
  - `archived_at` string, date-time, nullable
  - `previous_version_id` string, nullable
  - `duplicated_from_id` string, nullable
  - `order_id` string, nullable
  - `upload_id` string, nullable
  - `job_id` string, nullable
  - `deleted_at` string, date-time, nullable
  - `created_by` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/geopera/apis/geopera-data-platform.md) · [All operations](https://skmtc.dev/geopera/apis/geopera-data-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geopera/geopera-data-platform/revisions/cb0130b2a40a/schema)