# Set the global announcement banner

From **GitHub v3 REST API**.

`PATCH /enterprise/announcement`

Sets the message and expiration time for the global announcement banner in your enterprise.

## Request body

- Required: true
### `application/json`

- Type: `object`

Enterprise global announcement

```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"}
```

## Responses

### `200`

Response

### `application/json`

- Type: `object`

Enterprise global announcement

```json
{
  "announcement": "Very **important** announcement about _nothing_.",
  "expires_at": "2021-01-01T00:00:00.000+00:00"
}
```

```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"}
```

## Request examples

### cURL

```shell
curl --request PATCH \
  --url {protocol}://{hostname}/api/v3/enterprise/announcement \
  --header 'content-type: application/json' \
  --data '{
  "announcement": "string",
  "expires_at": "string"
}'
```