Enterprise announcement banners

The Enterprise Announcement Banners API allows you to get, set, and remove the announcement banner for your enterprise.

Gets the announcement banner currently set for the enterprise.

Header
Name, type, BESCHREIBUNG
`accept` string Setting to `application/vnd.github+json` is recommended.
Pfadparameter
Name, type, BESCHREIBUNG
`enterprise` string Erforderlich The slug version of the enterprise name. You can also substitute this value with the enterprise id.

Statuscode	BESCHREIBUNG
`200`	OK

get/enterprises/{enterprise}/announcement

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>"\
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/enterprises/ENTERPRISE/announcement

Announcement banner

Status: 200

{
  "announcement": "Very **important** announcement about _something_.",
  "expires_at": "2021-01-01T00:00:00.000+00:00",
  "user_dismissible": false
}

Sets the announcement banner to display for the enterprise.

Header
Name, type, BESCHREIBUNG
`accept` string Setting to `application/vnd.github+json` is recommended.
Pfadparameter
Name, type, BESCHREIBUNG
`enterprise` string Erforderlich The slug version of the enterprise name. You can also substitute this value with the enterprise id.
Textparameter
Name, type, BESCHREIBUNG
`announcement` string or null Erforderlich The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see "Basic writing and formatting syntax."
`expires_at` string or null The time at which the announcement expires. This is a timestamp in 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.

Statuscode	BESCHREIBUNG
`200`	OK

patch/enterprises/{enterprise}/announcement

curl -L \
  -X PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>"\
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/enterprises/ENTERPRISE/announcement \
  -d '{"announcement":"Very **important** announcement about _something_.","expires_at":"2021-01-01T00:00:00.000+00:00","user_dismissible":false}'

Announcement banner

Status: 200

{
  "announcement": "Very **important** announcement about _something_.",
  "expires_at": "2021-01-01T00:00:00.000+00:00",
  "user_dismissible": false
}

Removes the announcement banner currently set for the enterprise.

Header
Name, type, BESCHREIBUNG
`accept` string Setting to `application/vnd.github+json` is recommended.
Pfadparameter
Name, type, BESCHREIBUNG
`enterprise` string Erforderlich The slug version of the enterprise name. You can also substitute this value with the enterprise id.

Statuscode	BESCHREIBUNG
`204`	No Content

delete/enterprises/{enterprise}/announcement

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>"\
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/enterprises/ENTERPRISE/announcement

Response

Status: 204

Enterprise announcement banners

Get announcement banner for enterprise

Parameter für „Get announcement banner for enterprise“

HTTP-Antwortstatuscodes für „Get announcement banner for enterprise“

Codebeispiele für „Get announcement banner for enterprise“

Set announcement banner for enterprise

Parameter für „Set announcement banner for enterprise“

HTTP-Antwortstatuscodes für „Set announcement banner for enterprise“

Codebeispiele für „Set announcement banner for enterprise“

Remove announcement banner from enterprise

Parameter für „Remove announcement banner from enterprise“

HTTP-Antwortstatuscodes für „Remove announcement banner from enterprise“

Codebeispiele für „Remove announcement banner from enterprise“