# release

From **GitHub v3 REST API**.

A release.

- Type: `object`

## Properties

### `assets`

- Required: true
- Type: `array`

### `assets_url`

- Required: true
- Type: `string`
- Format: `uri`

### `author`

- Required: true
- Type: `object`

Simple User

### `body`

- Required: false
- Type: `string`
- Nullable: true

### `body_html`

- Required: false
- Type: `string`

### `body_text`

- Required: false
- Type: `string`

### `created_at`

- Required: true
- Type: `string`
- Format: `date-time`

### `draft`

- Required: true
- Type: `boolean`
- Example: `false`

true to create a draft (unpublished) release, false to create a published one.

### `html_url`

- Required: true
- Type: `string`
- Format: `uri`

### `id`

- Required: true
- Type: `integer`

### `name`

- Required: true
- Type: `string`
- Nullable: true

### `node_id`

- Required: true
- Type: `string`

### `prerelease`

- Required: true
- Type: `boolean`
- Example: `false`

Whether to identify the release as a prerelease or a full release.

### `published_at`

- Required: true
- Type: `string`
- Format: `date-time`
- Nullable: true

### `reactions`

- Required: false
- Type: `object`

### `tag_name`

- Required: true
- Type: `string`
- Example: `v1.0.0`

The name of the tag.

### `tarball_url`

- Required: true
- Type: `string`
- Format: `uri`
- Nullable: true

### `target_commitish`

- Required: true
- Type: `string`
- Example: `master`

Specifies the commitish value that determines where the Git tag is created from.

### `upload_url`

- Required: true
- Type: `string`

### `url`

- Required: true
- Type: `string`
- Format: `uri`

### `zipball_url`

- Required: true
- Type: `string`
- Format: `uri`
- Nullable: true

## JSON Schema

```json
{"description":"A release.","properties":{"assets":{"items":{"$ref":"#/components/schemas/release-asset"},"type":"array"},"assets_url":{"format":"uri","type":"string"},"author":{"$ref":"#/components/schemas/simple-user"},"body":{"nullable":true,"type":"string"},"body_html":{"type":"string"},"body_text":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"draft":{"description":"true to create a draft (unpublished) release, false to create a published one.","example":false,"type":"boolean"},"html_url":{"format":"uri","type":"string"},"id":{"type":"integer"},"name":{"nullable":true,"type":"string"},"node_id":{"type":"string"},"prerelease":{"description":"Whether to identify the release as a prerelease or a full release.","example":false,"type":"boolean"},"published_at":{"format":"date-time","nullable":true,"type":"string"},"reactions":{"$ref":"#/components/schemas/reaction-rollup"},"tag_name":{"description":"The name of the tag.","example":"v1.0.0","type":"string"},"tarball_url":{"format":"uri","nullable":true,"type":"string"},"target_commitish":{"description":"Specifies the commitish value that determines where the Git tag is created from.","example":"master","type":"string"},"upload_url":{"type":"string"},"url":{"format":"uri","type":"string"},"zipball_url":{"format":"uri","nullable":true,"type":"string"}},"required":["assets_url","upload_url","tarball_url","zipball_url","created_at","published_at","draft","id","node_id","author","html_url","name","prerelease","tag_name","target_commitish","assets","url"],"title":"Release","type":"object"}
```