---
title: "Create embargo"
method: POST
path: "/api/1/asset/assets/{assetId}/embargos"
tags: ["Asset enrichment"]
---

# Create embargo

`POST /api/1/asset/assets/{assetId}/embargos`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/1/asset/assets/{assetId}/embargos`
- Auth: HTTP bearer

> **IMPORTANT NOTE**
> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. 

 Create a new current or future embargo on the asset. There are 3 types of embargo available, 'archive', 'watermark', 'limited'. Of which only 1 can be active at the same time.

## Path parameters

- `assetId` string, required

## Request body

- CreateAssetEmbargoInput
  - `embargoTimeStamp` string, date-time
  - `embargoType` 'archive' | 'limited' | 'watermark', required

## Response `200`

- CreateAssetEmbargoReply
  - `assetId` string
  - `embargo` AssetEmbargo
    - `embargoId` string
    - `embargoType` 'archive' | 'limited' | 'watermark'
    - `timestampEnd` string, date-time
    - `timestampStart` string, date-time

## Other responses

- `400`
- `401`
- `403`
- `404`
- `500`
- `501`
- `502`
- `504`

---

[API](https://skmtc.dev/bynder/apis/asset.md) - [All operations](https://skmtc.dev/bynder/apis/asset/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/asset/revisions/35ef72282466?raw)