Settings

Settings represent options that a place admin may manipulate to affect the presentation of a place. Currently options for Activity and Overview tab visibility are supported. An example JSON representation looks like this:

 {
     "activityTab": true,
     "overviewTab": false,
     "defaultTab": "activityTab",
     "headerSettings" : {
          "bgPresetImageUrl" : "",
          "bgRepeat" : "repeat",
          "bgPosition" : "left top",
          "bgType" : "preset",
          "staticResourcesEnabled" : false
      }
 }

Note that one or both of activityTab or overviewTab must be true and the value for defaultTab must be either "activityTab" or "overviewTab"

.
Example:
Update Settings

PUT to /places/{placeID}/settings applies new settings. You must include a complete set of settings.

Fields

FieldTypeMode Description
activityTabBooleanrequiredEnables or disables the Activity tab in Groups, Spaces, and Projects.
defaultTabStringrequiredA user visiting a place is directed first to either the Activity tab or the Overview tab. This setting determines which.
headerSettingsHeaderSettingsoptional

An object representing the visual characteristics of the header banner applied to a place.Since: 3.9

idStringread-only

Identifier (unique within an object type and Jive instance) of this object.

overviewTabBooleanrequiredEnables or disables the Overview tab in Groups, Spaces, and Projects.
placeStringread-only

URI of the place where this category belongs.

resourcesObjectread-only

Resource links (and related permissions for the requesting person) relevant to this object.

→ Fields used by update and create operations
→ Fields used only by create operations
→ Fields not used by update or create operations

Resources

ResourceMethodDescription
selfGET

Return currently applied settings.

Retrieves:
  • Settings representing applied settings
  • selfPUT

    Update settings.

    Retrieves:
  • Settings representing the updated settings