---
title: "Promote a public scene into your data as a reference item (then searchable like any item)."
method: POST
path: "/v1/catalog/promote"
tags: ["resource-facade"]
---

# Promote a public scene into your data as a reference item (then searchable like any item).

`POST /v1/catalog/promote`

## Headers

- `x-api-key` string, nullable

## Request body

- CatalogPromoteInput — `item` is a STAC Feature as returned by catalog.federated_search.
  - `project_id` string, required
  - `item` object, required
  - `collection_id` string, nullable
  - `source_id` string, nullable
  - `type` 'satellite_capture' | 'derived_raster' | 'derived_vector' | 'derived_pointcloud' | 'derived_tabular' | 'clip' | 'mosaic' | 'document' | 'user_raster' | 'user_vector' | 'external_reference'

## Response `200`

Successful Response

- IngestResult
  - `item` object, required
  - `assets` object[]
  - `collection_id` string, nullable
  - `reused` boolean

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