# announcement

From **GitHub v3 REST API**.

Enterprise global announcement

- Type: `object`

## Properties

### `announcement`

- Required: true
- Type: `string`
- Example: `Very **important** announcement about _nothing_.`

The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see "[Basic writing and formatting syntax](https://docs.github.com/enterprise-server@3.0/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)."

### `expires_at`

- Required: false
- Type: `string`
- Format: `date-time`
- Nullable: true
- Example: `"2021-01-01T00:00:00.000-07:00"`

The time at which the announcement expires. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. To set an announcement that never expires, omit this parameter, set it to `null`, or set it to an empty string.

## JSON Schema

```json
{"description":"Enterprise global announcement","properties":{"announcement":{"$ref":"#/components/schemas/announcement-message"},"expires_at":{"$ref":"#/components/schemas/announcement-expiration"}},"required":["announcement"],"title":"Enterprise Announcement","type":"object"}
```