# Create a preview

**POST /previews**

Create a preview for a given documentation file. The preview will have a unique temporary URL, and will be active for 30 minutes.



## Servers



## Parameters



### Body:  (object)
The preview object
- **definition** (string)
  Serialized definition of the version. This should be an OpenAPI 2.x, 3.x or AsyncAPI 2.x file serialized as a string, in YAML or JSON.
- **references** (array[object])
  Import external references used by `definition`. It's usually resources not accessible by Bump servers, like local files or internal URLs.


## Responses
### 201
Success

#### Body:  (object)
- **id** (string)
  Unique id for the preview URL: `https://bump.sh/preview/:id`.
- **expires_at** (string(date-time))
  Preview expiration date and time.
- **public_url** (string)
  The public URL where the preview will be visible.

### 422
Definition is not valid.

#### Body:  (object)
- **message** (string)
  Human readable error message.
- **errors** (object)
  Hash of invalid attributes with their error messages.


[Powered by Bump.sh](https://bump.sh)