---
title: "POST /v2/domains/{domainIdentifier}/listings/change-set"
method: POST
path: "/v2/domains/{domainIdentifier}/listings/change-set"
---

# POST /v2/domains/{domainIdentifier}/listings/change-set

`POST /v2/domains/{domainIdentifier}/listings/change-set`

Publishes a listing (a record of an asset at a given time) or removes a listing from the catalog.

## Path parameters

- `domainIdentifier` string, required

## Request body

- object
  - `entityIdentifier` string, required — The ID of the asset.
  - `entityType` 'ASSET' | 'DATA_PRODUCT', required — The type of an entity.
  - `entityRevision` string — The revision of an asset.
  - `action` 'PUBLISH' | 'UNPUBLISH', required — Specifies whether to publish or unpublish a listing.
  - `clientToken` string — A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

## Response `200`

Success

- CreateListingChangeSetOutput
  - `listingId` string, required — The ID of the listing (a record of an asset at a given time).
  - `listingRevision` string, required — The revision of a listing.
  - `status` 'CREATING' | 'ACTIVE' | 'INACTIVE', required — Specifies the status of the listing.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — ConflictException
- `486` — ValidationException
- `487` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/datazone.md) · [All operations](https://skmtc.net/aws/apis/datazone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/datazone/versions/055599054b53/schema)