{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/oracle/main/json-schema/oracle-update-announcement-subscription-details-schema.json",
  "title": "UpdateAnnouncementSubscriptionDetails",
  "description": "The details for updating an announcement subscription.",
  "x-generated": "2026-10-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/oracle-announcementsubscription-api-openapi.yml#/components/schemas/UpdateAnnouncementSubscriptionDetails",
  "properties": {
    "definedTags": {
      "additionalProperties": {
        "additionalProperties": {
          "description": "The value of the tag. Only string, integer and boolean types are supported.\n",
          "type": "object"
        },
        "description": "Key-value pair representing predefined tags' keys and values scoped to a namespace.\nExample: `{\"bar-key\": \"value\"}`\n",
        "type": "object"
      },
      "description": "Defined tags for this resource. Each key is predefined and scoped to a namespace.\nExample: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`\n",
      "type": "object"
    },
    "description": {
      "description": "A description of the announcement subscription. Avoid entering confidential information.",
      "maxLength": 400,
      "type": "string"
    },
    "displayName": {
      "description": "A user-friendly name for the announcement subscription. Does not have to be unique, and it's changeable. Avoid entering confidential information.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "freeformTags": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.\nExample: `{\"bar-key\": \"value\"}`\n",
      "type": "object"
    },
    "onsTopicId": {
      "description": "The [OCID](/Content/General/Concepts/identifiers.htm) of the Notifications service topic that is the target for publishing announcements that match the configured announcement subscription. The caller of the operation needs the ONS_TOPIC_PUBLISH permission for the targeted Notifications service topic. For more information about Notifications permissions, see [Details for Notifications](/Content/Identity/policyreference/notificationpolicyreference.htm).\n",
      "type": "string"
    },
    "preferredLanguage": {
      "default": "en-US",
      "description": "(For announcement subscriptions with SaaS configured as the platform type or Oracle Fusion Applications as the service, or both, only) The language in which the user prefers to receive emailed announcements. Specify the preference with a value that uses the x-obmcs-human-language format. For example fr-FR.",
      "format": "x-obmcs-human-language",
      "type": "string"
    },
    "preferredTimeZone": {
      "default": "UTC",
      "description": "The time zone in which the user prefers to receive announcements. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example - America/Los_Angeles",
      "format": "x-obmcs-time-zone",
      "type": "string"
    }
  },
  "type": "object",
  "x-example": "{\n  \"definedTags\": {},\n  \"description\": \"announcements for Brazil region (required and recommended actions)\",\n  \"displayName\": \"subscription-brazilactions\",\n  \"freeformTags\": {},\n  \"onsTopicId\": \"ocid1.onstopic.oc1.phx.examplea4s4glpxfc22s7tmcvbitc7yiyjpft2faux3yb2oya2hihkyzieia\",\n  \"preferredTimeZone\": \"America/Los_Angeles\"\n}\n"
}