osapi.jive.corev3.places.Category

A Category is a way to organize content within a place. Categories have a name, tags, and a parent place. When creating or updating content, you can specify a list of categories for that content object. An example JSON representation looks like this:

 {
    "name" : "Animals",
    "tags" : [ ],
    "place" : "https://example.jiveon.com/api/core/v3/places/1116",
    "id" : "1002",
    "resources" : {
      "self" : {
        "ref" : "https://example.jiveon.com/api/core/v3/places/1116/categories/1002",
        "allowed" : [ "GET", "DELETE", "PUT" ]
      }
    }
 }
Example:
Create Category

Read createCategory() to learn how to create a new category.

Properties

PropertyTypeMode †Description
descriptionStringoptional↑
Description of the category.
followerCountIntegerread-only↑

Number of people following this object.

Availability:

Will be present only for object types that support being followed.

idStringread-only↑

Identifier (unique within an object type and Jive instance) of this object. This field is internal to Jive and should not be confused with contentID or placeID used in URIs.

likeCountIntegerread-only↑

Number of people who have liked this object.

Availability:

Will be present only for object types that support being liked.

nameStringrequired↑
Name of the category.
placeStringread-only↑

URI of the place where this category belongs.

publishedISO 8601 Dateread-only↑

Date and time this object was originally created.

resourcesObjectread-only↑

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

tagsString[]optional↑

Tags associated with this object.

typeStringrequired↑

The object type for this object ("category"). This field is required when creating new content.

updatedISO 8601 Dateread-only↑

Date and time this object was most recently updated.

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

Methods

↑
destroy()
DELETE /places/1234/categories/1002

Retrieves

--

Description

Delete the existing category for the specified place. Only admins of the place can manage place categories.

↑
get(options)
GET /places/1234/categories/1002

Retrieves

Category

Description

Return an updated version of this category.

Options:
NameTypeRequiredDescription
fieldsStringfalseThe names of the fields to be returned
Retrieves:
  • Category representing the updated category
    • ↑
    toURI()

    Retrieves

    String

    Description

    Retrieves:
  • A URI representing this entity, or undefined if no such URI exists.
    • ↑
    update(options)
    PUT /places/1234/categories/1002

    Retrieves

    Category

    Description

    Update the information about this category.

    Options:
    NameTypeRequiredDescription
    autoCategorizeStringfalseBoolean indicating whether existing content of the place will be categorized under the new category
    Retrieves:
  • Category representing the updated category