Skip to content
Ona API Reference
Ona Docs
API Reference
Organizations
Announcement Banner

UpdateAnnouncementBanner

client.Organizations.AnnouncementBanner.Update(ctx, body) (*OrganizationAnnouncementBannerUpdateResponse, error)
POST/gitpod.v1.OrganizationService/UpdateAnnouncementBanner

Updates the announcement banner configuration for an organization.

Use this method to configure the announcement banner displayed to all users. Only organization admins can update the banner. Requires Enterprise tier.

Examples

  • Enable announcement banner:

    organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
message: "Scheduled maintenance on Saturday 10pm-2am UTC"
enabled: true

  • Disable announcement banner:

    organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
enabled: false
ParametersExpand Collapse
body OrganizationAnnouncementBannerUpdateParams
OrganizationID param.Field[string]

organization_id is the ID of the organization

formatuuid
Enabled param.Field[bool]Optional

enabled controls whether the banner is displayed

Message param.Field[string]Optional

message is the banner message. Supports basic Markdown. Maximum 1000 characters.

maxLength1000
ReturnsExpand Collapse
type OrganizationAnnouncementBannerUpdateResponse struct{…}

UpdateAnnouncementBanner

package main

import (
  "context"
  "fmt"

  "github.com/gitpod-io/gitpod-sdk-go"
  "github.com/gitpod-io/gitpod-sdk-go/option"
)

func main() {
  client := gitpod.NewClient(
    option.WithBearerToken("My Bearer Token"),
  )
  announcementBanner, err := client.Organizations.AnnouncementBanner.Update(context.TODO(), gitpod.OrganizationAnnouncementBannerUpdateParams{
    OrganizationID: gitpod.F("b0e12f6c-4c67-429d-a4a6-d9838b5da047"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", announcementBanner.Banner)
}

{
  "banner": {
    "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "enabled": true,
    "message": "message"
  }
}
Returns Examples
{
  "banner": {
    "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "enabled": true,
    "message": "message"
  }
}