Cisco WebEx Social API Reference Guide, Release 3.1
Community Resource Operations
Downloads: This chapterpdf (PDF - 576.0KB) The complete bookPDF (PDF - 16.07MB) | Feedback

Community Resource Operations

Table Of Contents

Community Resource Operations

Get Information about a Community

Get Information about Communities

Create a Community

Update a Community

Delete a Community

Add Yourself to a Community

Remove Yourself from a Community

Add a User to a Community

Add a User to a Community (Alternate Method)

Remove a User from a Community

Remove a User from a Community (Alternate Method)

Assign the Community Owner Role to a User

Remove the Community Owner Role from a User

Get Information about Users Assigned to a Community

Get Information about Users Assigned to a Community (Alternate Method)

Add a User Group to a Community

Remove a User Group from a Community

Assign the Community Owner Role to Users in a User Group

Remove the Community Owner Role from Users in a User Group

Get Information about User Groups Assigned to a Community

Get Information about a Community Category

Get Information about Community Categories

Get Community Types that a Community Category Supports

Get Information about Membership Requests for a Community

Get Code of Conduct

Get Information about Posts for a Community

Get Information about Questions and Answers for a Community

Get Information about the Document Library of a Community

Get Information about Document Files in the Document Library of a Community

Get Information about Document Files in the Document Library of a Community that are Authored by a Designated User

Get Information about Community Profile Images

Get All Activities that are Visible to You in a Community

Update a Community Profile Image


Community Resource Operations


A Cisco WebEx Social community is a virtual group of Cisco WebEx Social users. Typically, these users share interests or goals. Users who belong to a community have access to the blogs, wikis, forums, library, and dashboard of the community. There are three types of communities:

Open—Communities that anyone can join. Content in open communities appears in search results.

Restricted—Communities for which someone must request and be granted membership to join. Content in restricted communities appears in search results.

Hidden—Comminutes that someone can join by invitation only. Hidden communities do not appear on the Communities page, and content in communities does not appear in search results.

The Cisco WebEx Social API Community resource operations let you obtain information about communities and perform various actions with communities.

Table 5-1 provides a summary of the Community resource operations. Each operation is described in detail in the section that is listed.

These sections provide this information:

Purpose—Brief explanation of the operation

Availability—Cisco WebEx Social releases that support the operation

Request—HTTP method and URI for the operation

Request Payload—Description of the request payload, if the operation requires one

Response—Description of the expected response when the operation executes

Examples—Sample requests and responses for the operation

In these sections, "you" and "yourself" refer to the authenticated user who is executing an operation.

Table 5-1 Community Resource Operations Summary 

Operation and Reference
Purpose

Get Information about a Community

Retrieves information about the designated community

Get Information about Communities

Retrieves information about communities that are visible to you

Create a Community

Creates a community

Update a Community

Updates the designated community

Delete a Community

Deletes the designated community from Cisco WebEx Social

Add Yourself to a Community

Adds you to the designated community

Remove Yourself from a Community

Removes you from the designated community

Add a User to a Community

Adds the designated user to the designated community

Add a User to a Community (Alternate Method)

Adds the designated user to the designated community

Remove a User from a Community

Removes the designated user from the designated community

Remove a User from a Community (Alternate Method)

Removes the designated user from the designated community

Assign the Community Owner Role to a User

Assigns the Community Owner role to the designated user for the designated community

Remove the Community Owner Role from a User

Removes the Community Owner role from the designated user for the designated community

Get Information about Users Assigned to a Community

Retrieves information about users that are assigned to the designated community

Get Information about Users Assigned to a Community (Alternate Method)

Retrieves information about users that are assigned to the designated community

Add a User Group to a Community

Adds the designated user group to the designated community

Remove a User Group from a Community

Removes the designated user group from the designated community

Assign the Community Owner Role to Users in a User Group

Assigns the Community Owner role to the users in the designated user for the designated community

Remove the Community Owner Role from Users in a User Group

Removes the Community Owner role from the users in the designated user for the designated community

Get Information about User Groups Assigned to a Community

Retrieves information about user groups that are assigned to the designated community

Get Information about a Community Category

Retrieves information about the designated community category

Get Information about Community Categories

Retrieves information about community categories

Get Community Types that a Community Category Supports

Retrieves the community types that the designated community category supports

Get Information about Membership Requests for a Community

Retrieves information about membership requests that have been made to the designated community

Get Code of Conduct

Retrieves the Cisco WebEx Social community code of conduct

Get Information about Posts for a Community

Retrieves information about all posts that have been shared with the designated community

Get Information about Questions and Answers for a Community

Retrieves information about questions and answers that were submitted when the designated community was created

Get Information about the Document Library of a Community

Retrieves information about the document library of a designated community

Get Information about Document Files in the Document Library of a Community

Retrieves information about all document files in that are in the document library of the designated community

Get Information about Document Files in the Document Library of a Community that are Authored by a Designated User

Retrieves information about document files that are in the document library of the designated community and that are authored by the designated user

Get Information about Questions and Answers for a Community

Retrieves information about questions and answers that were submitted when the designated community was created

Get Information about Community Profile Images

Retrieves information about profile images for the designated community

Get All Activities that are Visible to You in a Community

Retrieves information about all activities that are visible to you in the designated community

Update a Community Profile Image

Updates the community profile image for the designated community


Get Information about a Community

Purpose

Retrieves information about the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve information. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the Community resource to include in a response (Table 3-9 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter does not apply

The startIndex query parameter does not apply

The count query parameter does not apply

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one Community resource (the "Community Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/1234
Accept:application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the Community resource. For an example, see the "Community Resource Response: XML Format, One Resource Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/1234
Accept:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the Community resource. For an example, see the "Community Resource Response: JSON Format, One Resource Returned" section

Get Information about Communities

Purpose

Retrieves information about communities that are visible to you.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the Community resource to include in a response (Table 3-9 describes these fields)

The filterBy query parameter is supported for filtering resources in a response by the type field in the Community resource

The sortOrder query parameter is supported for sorting resources in a response by the name, stateChangedDate, or type field in the Community resource

The startIndex query parameter is supported for paginating return results

The count query parameter is supported for designating the maximum number of items in the return results

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more Community resources (the "Community Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities
Accept: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the Community resource. For an example, see the "Community Resource Response: XML Format, Multiple Resources Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the Community resource. For an example, see the "Community Resource Response: JSON Format, Multiple Resources Returned" section.

Create a Community

Purpose

Creates a community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the Community resource to include in a response (Table 3-9 describes these fields).

The filterBy query parameter is not supported for filtering resources in a response.

The sortOrder query parameter does not apply.

The startIndex query parameter does not apply.

The count query parameter does not apply.

The meta query parameter does not apply.

The special query parameter agreeToCodeOfConduct={true|false} is required if Cisco WebEx Social is configured so that a user must agree to the Cisco WebEx Social community code of conduct when creating a community (see the "CodeOfConduct Resource" section for related information). In this case, to create a community, you must set this query parameter to true to indicate that you agree to the code of conduct.

Request Payload

The request payload includes fields from the Community resource (Table 3-9 describes these fields):

Required Fields
Optional Fields

description
name
tags
type

communityCategory1
questionAnswer2

1 The id field in the communityCategory resource is optional. The system ignores other fields in this resource.

2 The questionId and the answer fields in the questionAnswer resource are optional. The system ignores other fields in this resource.


Response

Standard response (see the "API Responses" section) with a response payload that can include one Community resource (the "Community Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

POST http://webexsocialserver/api/quad/rest/communities
Accept: application/xml
Content-Type: application/xml
 
   
<community> 
	<category> 
		<name>General</name> 
	</category> 
	<name>Project Video</name> 
	<description>To capture Project Video activities</description> 
	<type>open</type> 
	<tags xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="tagsModel"> 
		<resource>http://quad.cisco.com/schema/1.0/tag</resource> 
		<name>video</name> 
	</tags> 
</community>

Response

HTTP/1.1 201 Created
Location: http://webexsocialserver/api/quad/rest/communities/1234
Content-Type: application/xml
 
   

The response can also include the Community resource. For an example, see the "Community Resource Response: XML Format, One Resource Returned" section.

JSON Example

Request

POST http://webexsocialserver/api/quad/rest/communities
Accept: application/json
Content-Type: application/json
 
   
{
   "category":"general",
   "description":"To capture Project Video activities",
   "name":"Project Video",
   "type":"open",
   "tags":[
      {
         "resource":"http://quad.cisco.com/schema/1.0/tag",
         "name":"Cisco WebEx Social"
      }
   ]
}

Response

HTTP/1.1 201 Created
Location: http://webexsocialserver/api/quad/rest/communities/1234
Content-Type: application/json
 
   
The response can also include the Community resource. For an example, see the "Community 
Resource Response: JSON Format, One Resource Returned" section.

Update a Community

Purpose

Updates information about the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

PUT

http://server[:port_number]/api/quad/rest/communities/community_id
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community to update. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter does not apply

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter does not apply

The startIndex query parameter does not apply

The count query parameter does not apply

The meta query parameter does not apply

Request Payload

The request payload includes fields from the Community resource (Table 3-9 describes these fields):

Required Fields
Optional Fields

name
shortName
state1
tags

1 If you specify the state field, the system ignores any other Community resource field that is included in the request payload.


Response

Standard response (see the "API Responses" section) with an HTTP header only.

XML Example

Request

PUT http://webexsocialserver/api/quad/rest/communities/4810201
Accept: application/xml
Content-Type: application/xml
 
   
<community> 
    <description>To capture Project Video related activities in Sally's team</description>
</community>

Response

HTTP/1.1 204 No Content

JSON Example

Request

PUT http://webexsocialserver/api/quad/rest/communities/4810201
Accept: application/json
Content-Type: application/json
 
   
{
    "description": "To capture Project Video related activities in Sally's team"
}

Response

HTTP/1.1 204 No Content

Delete a Community

Purpose

Deletes the designated community from Cisco WebEx Social.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

DELETE

http://server[:port_number]/api/quad/rest/communities/community_id


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community to delete. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

DELETE http://webexsocialserver/api/quad/rest/communities/4810201

Response

HTTP/1.1 204 No Content

Add Yourself to a Community

Purpose

Adds you to the designated community.

If you have the administrator privilege in Cisco WebEx Social, this operation adds you to the community and no membership request is generated.

If you do not have the administrator privilege, this operation adds you to the community only if the community is an Open type. For other types of communities, the system creates a membership request.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities/community_id/users/@me


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community to which to add yourself. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

If no membership request is generated, this operation returns a standard response (see the "API Responses" section) with an HTTP header only.

If a membership request is generated, this operation returns a standard response (see the "API Responses" section) that includes the MembershipRequest resource (the "MembershipRequest Resource" section describes this resource).

XML and JSON formats are supported.

XML Example

Request

POST http://webexsocialserver/api/quad/rest/communities/4810301/users/@me
Accept:application/xml
content-type: xml

Response—Membership request is not generated

HTTP/1.1 204 No Content

Response—Membership request is generated

HTTP/1.1 303 See Other
Location: http://webexsocialserver/api/quad/rest/membershiprequests/210747
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
<statusCode>200</statusCode>
<startIndex>0</startIndex>
<itemsPerPage>1</itemsPerPage>
<totalResults>1</totalResults>
<filtered>false</filtered>
<sorted>false</sorted>
<entry>
  <membershiprequest>
    <approver xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:nil="true"/>
    <community>
      <description>second</description>
      <id>4710003</id>
      <name>Dos</name>
      <shortName>/dos</shortName>
      <state>live</state>
      <type>restricted</type>
    </community>
    <createDate>1319730564972</createDate>
    <id>210747</id>
    <replyComments></replyComments>
    <replyDate>0</replyDate>
    <requestComments></requestComments>
    <requester>
      <firstName>Pat</firstName>
      <fullName>Pat Kim</fullName>
      <id>1234</id>
      <jobTitle></jobTitle>
      <lastName>Kim</lastName>
      <screenName>patkim</screenName>
    </requester>
    <resource>http://quad.cisco.com/schema/1.0/membershiprequest</resource>
    <status>pending</status>
  </membershiprequest>
</entry>
</ns2:response>

JSON Example

Request

POST http://webexsocialserver/api/quad/rest/communities/4810301/users/@me
Accept:application/json
content-type: json

Response—Membership request is not generated

HTTP/1.1 204 No Content

Response—Membership request is generated

HTTP/1.1 303 See Other
Location: http://webexsocialserver/api/quad/rest/membershiprequests/210747
{
    "entry": [
        {
            "data": {
                "approver": null, 
                "community": {
                    "description": "second", 
                    "id": 4710003, 
                    "name": "Dos", 
                    "shortName": "/dos", 
                    "state": "live", 
                    "type": "restricted"
                }, 
                "createDate": 1319730564972, 
                "id": 210747, 
                "replyComments": "", 
                "replyDate": 0, 
                "requestComments": "", 
                "requester": {
                    "firstName": "Pat", 
                    "fullName": "Pat Kim", 
                    "id": 1234, 
                    "images": [ ], 
                    "jobTitle": "", 
                    "lastName": "Kim", 
                    "screenName": "patkim"
                }, 
                "resource": "http://quad.cisco.com/schema/1.0/membershiprequest", 
                "status": "pending"
            }
        }
    ], 
    "filtered": false, 
    "itemsPerPage": 1, 
    "serverMessages": null, 
    "sorted": false, 
    "startIndex": 0, 
    "statusCode": 200, 
    "totalResults": 1
}

Remove Yourself from a Community

Purpose

Removes you from the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

DELETE

http://server[:port_number]/api/quad/rest/communities/community_id/users/@me


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community from which to remove yourself. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

DELETE http://webexsocialserver/api/quad/rest/communities/4810301/users/@me

Response

HTTP/1.1 204 No Content

Add a User to a Community

Purpose

Adds the designated user to the designated community. The user is assigned the Community Member role automatically.

If the designated user is a user other than yourself, you must be a Cisco WebEx Social administrator or an owner or administrator the community to add that user to the community. In this case, no membership request is generated.

If you are not a Cisco WebEx Social administrator or an owner or administrator of the community, you can use this operation to add yourself to the community only if the community is an Open type. For other types of communities, the system generates a membership request.

Availability

Cisco WebEx Social 3.0 and later.

This operation is deprecated beginning with Cisco WebEx Social 3.0 SR2. From that release on, use the operation that the "Add a User to a Community (Alternate Method)" section describes.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities/community_id/users
/
user_id


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community to which to add the user. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user to add to the community. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

If no membership request is generated, this operation returns a standard response (see the "API Responses" section) with an HTTP header only.

If a membership request is generated, this operation returns a standard response (see the "API Responses" section) that includes the MembershipRequest resource (the "MembershipRequest Resource" section describes this resource).

XML Example

Request

POST http://webexsocialserver/api/quad/rest/communities/4710003/users/4510003
Accept: application/xml
Content-Type: application/xml

Response—Membership request is not generated

HTTP/1.1 204 No Content

Response—Membership request is generated

HTTP/1.1 303 See Other
Location: http://webexsocialserver/api/quad/rest/membershiprequests/210747
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
<statusCode>200</statusCode>
<startIndex>0</startIndex>
<itemsPerPage>1</itemsPerPage>
<totalResults>1</totalResults>
<filtered>false</filtered>
<sorted>false</sorted>
<entry>
  <membershiprequest>
    <approver xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:nil="true"/>
    <community>
      <description>second</description>
      <id>4710003</id>
      <name>Dos</name>
      <shortName>/dos</shortName>
      <state>live</state>
      <type>restricted</type>
    </community>
    <createDate>1319730564972</createDate>
    <id>210747</id>
    <replyComments></replyComments>
    <replyDate>0</replyDate>
    <requestComments></requestComments>
    <requester>
      <firstName>Pat</firstName>
      <fullName>Pat Kim</fullName>
      <id>1234</id>
      <jobTitle></jobTitle>
      <lastName>Kim</lastName>
      <screenName>patkim</screenName>
    </requester>
    <resource>http://quad.cisco.com/schema/1.0/membershiprequest</resource>
    <status>pending</status>
  </membershiprequest>
</entry>
</ns2:response>

JSON Example

Request

POST http://webexsocialserver/api/quad/rest/communities/4710003/users/4510003
Accept: application/json
Content-Type: application/json

Response—Membership request is not generated

HTTP/1.1 204 No Content

Response—Membership request is generated

HTTP/1.1 303 See Other
Location: http://webexsocialserver/api/quad/rest/membershiprequests/210747
{
    "entry": [
        {
            "data": {
                "approver": null, 
                "community": {
                    "description": "second", 
                    "id": 4710003, 
                    "name": "Dos", 
                    "shortName": "/dos", 
                    "state": "live", 
                    "type": "restricted"
                }, 
                "createDate": 1319730564972, 
                "id": 210747, 
                "replyComments": "", 
                "replyDate": 0, 
                "requestComments": "", 
                "requester": {
                    "firstName": "Pat", 
                    "fullName": "Pat Kim", 
                    "id": 1234, 
                    "images": [ ], 
                    "jobTitle": "", 
                    "lastName": "Kim", 
                    "screenName": "patkim"
                }, 
                "resource": "http://quad.cisco.com/schema/1.0/membershiprequest", 
                "status": "pending"
            }
        }
    ], 
    "filtered": false, 
    "itemsPerPage": 1, 
    "serverMessages": null, 
    "sorted": false, 
    "startIndex": 0, 
    "statusCode": 200, 
    "totalResults": 1
}

Add a User to a Community (Alternate Method)

Purpose

Adds the designated user to the designated community.

If the designated user is a user other than yourself, you must be a Cisco WebEx Social administrator or an owner or administrator of the community to add that user to the community. In this case, no membership request is generated.

If you are not a Cisco WebEx Social administrator or an owner or administrator of the community, you can use this operation to add yourself to the community only if the community is an Open type. For other types of communities, the system generates a membership request.

Availability

Cisco WebEx Social 3.0 SR 2 and later.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusers/
user_id


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community to which to add the user. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user to add to the community. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

If no membership request is generated, this operation returns a standard response (see the "API Responses" section) with an HTTP header only.

If a membership request is generated, this operation returns a standard response (see the "API Responses" section) that includes the MembershipRequest resource (the "MembershipRequest Resource" section describes this resource).

XML Example

Request

POST http://webexsocialserver/api/quad/rest/communities/4710003/communityusers/4510003
Accept: application/xml
Content-Type: application/xml

Response—Membership request is not generated

HTTP/1.1 204 No Content

Response—Membership request is generated

HTTP/1.1 303 See Other
Location: http://webexsocialserver/api/quad/rest/membershiprequests/210747
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
<statusCode>200</statusCode>
<startIndex>0</startIndex>
<itemsPerPage>1</itemsPerPage>
<totalResults>1</totalResults>
<filtered>false</filtered>
<sorted>false</sorted>
<entry>
  <membershiprequest>
    <approver xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:nil="true"/>
    <community>
      <description>second</description>
      <id>4710003</id>
      <name>Dos</name>
      <shortName>/dos</shortName>
      <state>live</state>
      <type>restricted</type>
    </community>
    <createDate>1319730564972</createDate>
    <id>210747</id>
    <replyComments></replyComments>
    <replyDate>0</replyDate>
    <requestComments></requestComments>
    <requester>
      <firstName>Pat</firstName>
      <fullName>Pat Kim</fullName>
      <id>1234</id>
      <jobTitle></jobTitle>
      <lastName>Kim</lastName>
      <screenName>patkim</screenName>
    </requester>
    <resource>http://quad.cisco.com/schema/1.0/membershiprequest</resource>
    <status>pending</status>
  </membershiprequest>
</entry>
</ns2:response>

JSON Example

Request

POST http://webexsocialserver/api/quad/rest/communities/4710003/communityusers/4510003
Accept: application/json
Content-Type: application/json

Response—Membership request is not generated

HTTP/1.1 204 No Content

Response—Membership request is generated

HTTP/1.1 303 See Other
Location: http://webexsocialserver/api/quad/rest/membershiprequests/210747
{
    "entry": [
        {
            "data": {
                "approver": null, 
                "community": {
                    "description": "second", 
                    "id": 4710003, 
                    "name": "Dos", 
                    "shortName": "/dos", 
                    "state": "live", 
                    "type": "restricted"
                }, 
                "createDate": 1319730564972, 
                "id": 210747, 
                "replyComments": "", 
                "replyDate": 0, 
                "requestComments": "", 
                "requester": {
                    "firstName": "Pat", 
                    "fullName": "Pat Kim", 
                    "id": 1234, 
                    "images": [ ], 
                    "jobTitle": "", 
                    "lastName": "Kim", 
                    "screenName": "patkim"
                }, 
                "resource": "http://quad.cisco.com/schema/1.0/membershiprequest", 
                "status": "pending"
            }
        }
    ], 
    "filtered": false, 
    "itemsPerPage": 1, 
    "serverMessages": null, 
    "sorted": false, 
    "startIndex": 0, 
    "statusCode": 200, 
    "totalResults": 1
}

Remove a User from a Community

Purpose

Removes the designated user from the designated community.

If the designated user is a user other than yourself, you must be a Cisco WebEx Social administrator or an owner or administrator of the community to remove that user from the community.

If you are not a Cisco WebEx Social administrator or an owner or administrator of the community, you can use this operation to remove yourself from the community.

Availability

Cisco WebEx Social 3.0 and later.

This operation is deprecated beginning with Cisco WebEx Social 3.0 SR2. From that release on, use the operation that the "Remove a User from a Community (Alternate Method)" section describes.

Request

HTTP Method
URI

DELETE

http://server[:port_number]/api/quad/rest/communities/community_id/users
/
user_id


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community from which to remove the user. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user to remove from the community. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

DELETE http://webexsocialserver/api/quad/rest/communities/4710003/users/4510003

Response

HTTP/1.1 204 No Content

Remove a User from a Community (Alternate Method)

Purpose

Removes the designated user from the designated community.

If the designated user is a user other than yourself, you must be a Cisco WebEx Social administrator or an owner or administrator of the community to remove that user from the community.

If you are not a Cisco WebEx Social administrator or an owner or administrator of the community, you can use this operation to remove yourself from the community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

DELETE

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusers/
user_id


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community from which to remove the user. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user to remove from the community. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

DELETE http://webexsocialserver/api/quad/rest/communities/4710003/communityusers/4510003

Response

HTTP/1.1 204 No Content

Assign the Community Owner Role to a User

Purpose

Assigns the Community Owner role to the designated user for the designated community. The user must already be a member of the community.

You must be a Cisco WebEx administrator or an owner or administrator of the designated community to execute this operation successfully.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusers/
user_id/roles/@owner


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community in which the user is to have the Community Owner role. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user to whom the Community Owner role is to be assigned. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

POST http://quadserver/api/quad/rest/communities/9876/communityusers/1234/roles/@owner

Response

HTTP/1.1 204 No Content

Remove the Community Owner Role from a User

Purpose

Removes the Community Owner role from the designated user for the designated community. This operation does not remove the user from the community.

You must be a Cisco WebEx administrator or an owner or administrator of the designated community to execute this operation successfully.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

DELETE

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusers/
user_id/roles/@owner


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community in which the user is to have the Community Owner role removed. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user to whom the Community Owner role is to be removed. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

DELETE http://quadserver/api/quad/rest/communities/9876/communityusers/1234/roles/@owner

Response

HTTP/1.1 204 No Content

Get Information about Users Assigned to a Community

Purpose

Retrieves information about users that are assigned to the designated community.

Availability

Cisco WebEx Social 3.0 and later.

This operation is deprecated beginning with Cisco WebEx Social 3.0 SR2. From that release on, use the operation that the "Get Information about Users Assigned to a Community (Alternate Method)" section describes.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/users
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve information about assigned users. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the User resource to include in a response (Table 3-38 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter is supported for sorting resources in a response by the firstName, lastName, jobTitle, or screenName field in the User resource

The startIndex query parameter is supported for paginating return results

The count query parameter is supported for designating the maximum number of items in the return results

The meta query parameter is supported with the follow value for requesting relationship metadata

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more User resources (the "User Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/9876/users
Accept: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the User resource. For an example, see the "User Resource Response: XML Format, Multiple Resources Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/9876/users
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the User resource. For an example, see the "User Resource Response: JSON Format, Multiple Resources Returned" section.

Get Information about Users Assigned to a Community (Alternate Method)

Purpose

Retrieves information about users that are assigned to the designated community.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusers
[/member_type][?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve information about users. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

member_type—You can limit the users that this operation returns from the designated community by specifying any of these parameters:

@directmembers—Causes the operation to retrieve only users who are not members of any user group that is assigned to the community

@memberrole—Causes the operation to retrieve only users that have the Community Member role in the community

@ownerrole—Causes the operation to retrieve only users that have the Community Owner role in the community

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the CommunityUser resource to include in a response (Table 3-12 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter is supported for sorting resources in a response by the firstName, lastName, jobTitle, or screenName field in the CommunityUser resource

The startIndex query parameter is supported for paginating return results

The count query parameter is supported for designating the maximum number of items in the return results

The meta query parameter is supported with the follow value for requesting relationship metadata

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more CommunityUser resources (the "CommunityUser Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/9876/communityusers
Accept: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the CommunityUser resource. For an example, see the "CommunityUser Resource Response: XML Format, Multiple Resources Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/9876/communityusers
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the CommunityUser resource. For an example, see the "CommunityUser Resource Response: JSON Format, Multiple Resources Returned" section.

Add a User Group to a Community

Purpose

Adds the designated user group to the designated community. Each user in the user group is assigned the Member role in the community automatically.

You must be a Cisco WebEx administrator or an owner or administrator of the designated community to execute this operation successfully.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusergroups/
usergroup_id


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community to which to add the user group. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

usergroup_id—Identifier of the user group to add to the community. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

POST http://webexsocialserver/api/quad/rest/communities/4710003/communityusergroups/1154

Response

HTTP/1.1 204 No Content

Remove a User Group from a Community

Purpose

Removes the designated user group from the designated community.

You must be a Cisco WebEx administrator or an owner or administrator of the designated community to execute this operation successfully.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

DELETE

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusergroups/
usergroup_id


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community from which to remove the user group. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

usergroup_id—Identifier of the user group to remove from the community. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

DELETE http://webexsocialserver/api/quad/rest/communities/4710003/communityusergroups/1154

Response

HTTP/1.1 204 No Content

Assign the Community Owner Role to Users in a User Group

Purpose

Assigns the Community Owner role to the users in the designated user for the designated community. Each user in the user group must already be a member of the community.

You must be a Cisco WebEx administrator or an owner or administrator of the designated community to execute this operation successfully.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusergroups/
usergroup_id/roles/@owner


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community in which users in the user group are to have the Community Owner role. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

usergroup_id—Identifier of the user group that includes the users to which the Community Owner role is to be assigned. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

POST http://quadserver/api/quad/rest/communities/9876/communityusergroups/1154/roles/ 
@owner

Response

HTTP/1.1 204 No Content

Remove the Community Owner Role from Users in a User Group

Purpose

Removes the Community Owner role from the users in the designated user for the designated community. This operation does not remove the users from the community.

You must be a Cisco WebEx administrator or an owner or administrator of the designated community to execute this operation successfully.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

DELETE

http://server[:port_number]/api/quad/rest/communities/community_id/
/communityusergroups/
usergroup_id/roles/@owner


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community in which the user is to have the Community Owner role removed. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user to whom the Community Owner role is to be removed. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

Example

Request

DELETE http://quadserver/api/quad/rest/communities/9876/communityusergroups/1154/roles/ 
@owner

Response

HTTP/1.1 204 No Content

Get Information about User Groups Assigned to a Community

Purpose

Retrieves information about user groups that are assigned to the designated community.

Availability

Cisco WebEx Social 3.0 SR2 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/
communityusergroups[/role][?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve user assigned user groups. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

role—You can limit the user groups that this operation returns from the designated community by specifying either of these values:

@memberrole—Causes the operation to retrieve only user who are in user group and who have the Community Member role in the community

@ownerrole—Causes the operation to retrieve only user who are in the user group and who have the Community Owner role in the community

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the CommunityUserGroup resource to include in a response (Table 3-13 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter is supported for sorting resources in a response by the description or name field in the CommunityUserGroup resource

The startIndex query parameter is supported for paginating return results

The count query parameter is supported for designating the maximum number of items in the return results

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more CommunityUserGroup resources (the "CommunityUserGroup Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://quadserver/api/quad/rest/communities/9876/communityusergroups
Accept: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
  <statusCode>200</statusCode>
  <startIndex>0</startIndex>
  <itemsPerPage>1</itemsPerPage>
  <totalResults>1</totalResults>
  <filtered>false</filtered>
  <sorted>false</sorted>
  <entry>
    <communityusergroup>
      <creator>
        <firstName>Pat</firstName>
        <fullName>Pat Kim</fullName>
        <id>10261</id>
        <jobTitle/>
        <lastName>Kimn</lastName>
        <resource>http://quad.cisco.com/schema/1.0/user</resource>
        <screenName>patkim</screenName>
        <status>ACTIVE</status>
      </creator>
      <description>Community Owners User Group</description>
      <id>1810100</id>
      <name>Community Owners</name>
      <resource>http://quad.cisco.com/schema/1.0/communityusergroup</resource>
      <roles xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="roleModel">
        <id>10219</id>
        <resource>http://quad.cisco.com/schema/1.0/role</resource>
        <name>Owner</name>
        <description>Role that provides the community owner privilege to 
users</description>
        <title/>
      </roles>
    </communityusergroup>
  </entry>
</ns2:response>

JSON Example

Request

GET http://quadserver/api/quad/rest/communities/9876/communityusergroups
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
"statusCode": 200, 
  "startIndex": 0, 
  "itemsPerPage": 1, 
  "totalResults": 1, 
  "filtered": false, 
  "sorted": false, 
  "entry": [
    {
      "data": {
        "creator": {
          "firstName": "Pat", 
          "fullName": "Pat Kim", 
          "id": 10261, 
          "images": null, 
          "jobTitle": "", 
          "lastName": "Kim", 
          "resource": "http://quad.cisco.com/schema/1.0/user", 
          "screenName": "patkim", 
          "status": "ACTIVE"
        }, 
        "description": "Community Owners User Group",
        "id": 1810101, 
        "name": "Community Owners", 
        "resource": "http://quad.cisco.com/schema/1.0/communityusergroup", 
        "roles": [
          {
            "id": 10218, 
            "resource": "http://quad.cisco.com/schema/1.0/role", 
            "name": "Owner", 
            "description": "Role that provides the community owner privilege to 
users</description.", 
            "title": ""
          }
        ]
      }
    }
  ], 
  "serverMessages": null
}

Get Information about a Community Category

Purpose

Retrieves information about the designated community category.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/categories/category_id
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

category_id—Identifier of the community category for which to retrieve information. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the CommunityCategory resource to include in a response (Table 3-10 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter does not apply

The startIndex query parameter does not apply

The count query parameter does not apply

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one CommunityCategory resource (the "CommunityCategory Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/categories/210044
Accept: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   
The response can also include the CommunityCategory resource. For an example, see the 
"CommunityCategory Resource Response: XML Format, One Resource Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/categories/210044
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   
The response can also include the CommunityCategory resource. For an example, see the 
"CommunityCategory Resource Response: JSON Format, One Resource Returned" section.

Get Information about Community Categories

Purpose

Retrieves information about community categories.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/categories
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the CommunityCategory resource to include in a response (Table 3-10 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter is supported for sorting resources in a response by the name field in the CommunityCategory resource

The startIndex query parameter is supported for paginating return results

The count query parameter is supported for designating the maximum number of items in the return results

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more CommunityCategory resources (the "CommunityCategory Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/categories
Accept: application/xml

Response

[HTTP/1.1 200 OK
Content-Type: application/xml
 
   
The response can also include CommunityCategory resources. For an example, see the 
"CommunityCategory Resource Response: XML Format, Multiple Resources Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/categories 
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   
The response can also include CommunityCategory resources. For an example, see the 
"CommunityCategory Resource Response: JSON Format, Multiple Resources Returned" section.

Get Community Types that a Community Category Supports

Purpose

Retrieves the community types (open, restricted, or hidden) that the designated community category supports.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/categories
/
category_id/types[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

category_id—Identifier of the community category for which to retrieve supported community types. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is not supported

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter does not apply

The startIndex query parameter does not apply

The count query parameter does not apply

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more CommunityType resources (the "CommunityType Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/categories/210044/types
Accept: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
  <statusCode>200</statusCode>
  <startIndex>0</startIndex>
  <itemsPerPage>3</itemsPerPage>
  <totalResults>-1</totalResults>
  <filtered>false</filtered>
  <sorted>false</sorted>
  <entry>
    <type>open</type>
  </entry>
  <entry>
    <type>hidden</type>
  </entry>
  <entry>
    <type>restricted</type>
  </entry>
</ns2:response>

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/categories/210044/types
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
    "statusCode": 200, 
    "startIndex": 0, 
    "itemsPerPage": 3, 
    "totalResults": -1, 
    "filtered": false, 
    "sorted": false, 
    "entry": [
        {
            "data": "open"
        }, 
        {
            "data": "hidden"
        }, 
        {
            "data": "restricted"
        }
    ], 
    "serverMessages": null
}

Get Information about Membership Requests for a Community

Purpose

Retrieves information about membership requests that have been made to the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id
/membershiprequests[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve membership requests. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the MembershipRequest resource to include in a response (Table 3-27 describes these fields)

The filterBy query parameter is supported for filtering resources in a response by the status field in the MembeshipRequest resource

The sortOrder query parameter does not apply

The startIndex query parameter does not apply

The count query parameter does not apply

The count query parameter does not apply

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one MembershipRequest resource (the "MembershipRequest Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/membershiprequests
Content-Type: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
<statusCode>200</statusCode>
<startIndex>0</startIndex>
<itemsPerPage>1</itemsPerPage>
<totalResults>0</totalResults>
<filtered>false</filtered>
<sorted>false</sorted>
<entry>
  <membershiprequest>
    <approver xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:nil="true"/>
    <community>
      <description>second</description>
      <id>4710003</id>
      <name>Dos</name>
      <shortName>/dos</shortName>
      <state>live</state>
      <type>restricted</type>
    </community>
    <createDate>1319730564972</createDate>
    <id>110499</id>
    <replyComments></replyComments>
    <replyDate>0</replyDate>
    <requestComments></requestComments>
    <requester>
      <firstName>Pat</firstName>
      <fullName>Pat Kim</fullName>
      <id>1234</id>
      <jobTitle></jobTitle>
      <lastName>Kim</lastName>
      <screenName>patkim</screenName>
    </requester>
    <resource>http://quad.cisco.com/schema/1.0/membershiprequest</resource>
    <status>pending</status>
  </membershiprequest>
</entry>
</ns2:response>

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/membershiprequests
Content-Type: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
    "entry": [
        {
            "data": {
                "approver": null, 
                "community": {
                    "description": "second", 
                    "id": 4710003, 
                    "name": "Dos", 
                    "shortName": "/dos", 
                    "state": "live", 
                    "type": "restricted"
                }, 
                "createDate": 1319730564972, 
                "id": 110499, 
                "replyComments": "", 
                "replyDate": 0, 
                "requestComments": "", 
                "requester": {
                    "firstName": "Pat", 
                    "fullName": "Pat Kim", 
                    "id": 1234, 
                    "images": [ ], 
                    "jobTitle": "", 
                    "lastName": "Kim", 
                    "screenName": "patkim"
                }, 
                "resource": "http://quad.cisco.com/schema/1.0/membershiprequest", 
                "status": "pending"
            }
        }
    ], 
    "filtered": false, 
    "itemsPerPage": 1, 
    "serverMessages": null, 
    "sorted": false, 
    "startIndex": 0, 
    "statusCode": 200, 
    "totalResults": 0
}

Get Code of Conduct

Purpose

Retrieves the Cisco WebEx Social community code of conduct.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/codeofconduct
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the CodeOfConduct resource to include in a response (Table 3-8 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter does not apply

The startIndex query parameter does not apply

The count query parameter does not apply

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include the CodeOfConduct resource (the "CodeOfConduct Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/codeofconduct
Accept:application/xml
Content-Type:application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
	<statusCode>200</statusCode>
	<startIndex>0</startIndex>
	<itemsPerPage>1</itemsPerPage>
	<totalResults>1</totalResults>
	<filtered>false</filtered>
	<sorted>false</sorted>
    <entry>
    <codeofconduct>
      <enabled>false</enabled>
      <link/>
    </codeofconduct>
  </entry>
</ns2:response>

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/codeofconduct
Accept:application/json
Content-Type:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
   "statusCode":200,
   "startIndex":0,
   "itemsPerPage":1,
   "totalResults":0,
   "filtered":false,
   "sorted":false,
   "entry":[
      {
         "data":{
            "enabled":false,
            "link":""
         }
      }
   ],
   "serverMessages":null
}

Get Information about Posts for a Community

Purpose

Retrieves information about all posts that have been shared with the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/posts
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve posts. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the Post resource to include in a response (Table 3-31 describes these fields).

The filterBy query parameter is supported for filtering resources in a response by the creator or state field in the Community resource. If you filter by the creator field, only the resource that represents you is supported as the field value. If you filter by the state field, only DELETED is supported as the field value.

The sortOrder query parameter is supported for sorting resources in a response by the creator, lastModifiedDate, or title field in the Post resource.

The startIndex query parameter is supported for paginating return results.

The count query parameter is supported for designating the maximum number of items in the return results.

The meta query parameter is supported with the like and the favorite values for requesting relationship metadata.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more Post resources (the "Post Resource" section describes this resource). XML, JSON, and Atom formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/posts
Accept: application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the Post resource. For an example, see the "Post Resource Response: XML Format, Multiple Resources Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/posts
Accept: application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the Post resource. For an example, see the "Post Resource Response: JSON Format, Multiple Resources Returned" section.

Atom Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/posts
Accept: application/atom+xml

Response

HTTP/1.1 200 OK
Content-Type: application/atom+xml
 
   

The response can also include the Post resource. For an example, see the "Post Resource Response: Atom Format, Multiple Resources Returned" section.

Get Information about Questions and Answers for a Community

Purpose

Retrieves information about questions and answers that were submitted when the designated community was created.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id
/questionanswers[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve questions and answers. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the QuestionAnswer resource to include in a response (Table 3-35 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter is not supported for sorting resources in a response

The startIndex query parameter is not supported for paginating return results

The count query parameter is not supported for designating the maximum number of items in the return results

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more QuestionAnswer resources (the "QuestionAnswer Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/questionanswers
Accept:application/json
Content-Type:application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:response xmlns:ns2="http://quad.cisco.com/ns/1.0/xml">
<statusCode>200</statusCode>
<startIndex>0</startIndex>
<itemsPerPage>2</itemsPerPage>
<totalResults>0</totalResults>
<filtered>false</filtered>
<sorted>false</sorted>
<entry>
  <questionanswer>
    <answer>free form answer</answer>
    <question>This is the second question</question>
    <questionId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:nil="true"/>
  </questionanswer>
</entry>
<entry>
  <questionanswer>
    <answer>answer1</answer>
    <question>This is the first question</question>
    <questionId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:nil="true"/>
  </questionanswer>
</entry>
</ns2:response>

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/questionanswers
Accept:application/json
Content-Type:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
{
    "entry": [
        {
            "data": {
                "answer": "free form answer", 
                "question": "This is the second question", 
                "questionId": null
            }
        }, 
        {
            "data": {
                "answer": "answer1", 
                "question": "This is the first question", 
                "questionId": null
            }
        }
    ], 
    "filtered": false, 
    "itemsPerPage": 2, 
    "serverMessages": null, 
    "sorted": false, 
    "startIndex": 0, 
    "statusCode": 200, 
    "totalResults": 0
}

Get Information about the Document Library of a Community

Purpose

Retrieves information about the document library of a designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/
documentlibrary
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve document library information. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the DocumentLibrary resource to include in a response (Table 3-19 describes these fields).

The filterBy query parameter is not supported for filtering resources in a response.

The sortOrder query parameter does not apply.

The startIndex query parameter is supported for paginating return results by designating the first DocumentFolder or DocumentFile child resource that is returned. The DocumentFolder child resource takes precedence.

The count query parameter is supported for designating the maximum number of DocumentFolder and DocumentFile child resources that are included in the return results. DocumentFolder child resources take precedence.

The meta query parameter does not apply.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one DocumentLibrary resource that contains representations of top-level document folders (the "DocumentLibrary Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/1234/documentlibrary
Accept:application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the DocumentLibrary resource. For an example, see the "DocumentLibrary Resource Response: XML Format, One Resource Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/1234/documentlibrary
Accept:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the DocumentLibrary resource. For an example, see the "DocumentLibrary Resource Response: JSON Format, One Resource Returned" section.

Get Information about Document Files in the Document Library of a Community

Purpose

Retrieves information about all document files that are in the document library of the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/
documentlibrary/@recent
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community with the document library contains the document files about which information is to be retrieved. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the DocumentLibrary resource to include in a response (Table 3-19 describes these fields).

The filterBy query parameter is not supported for filtering resources in a response.

The sortOrder query parameter does not apply.

The startIndex query parameter is supported for paginating return results by designating the first DocumentFolder or DocumentFile child resource that is returned. The DocumentFolder child resource takes precedence.

The count query parameter is supported for designating the maximum number of DocumentFolder and DocumentFile child resources that are included in the return results. DocumentFolder child resources take precedence.

The meta query parameter does not apply.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one DocumentLibrary resource that contains representations of all document files in the document library of the designated community (the "DocumentLibrary Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/1234/documentlibrary/@recent
Accept:application/xml

Response

HTTP/1.1 200 OK

Content-Type: application/xml
 
   

The response can also include the DocumentLibrary resource. For an example, see the "DocumentLibrary Resource Response: XML Format, One Resource Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/1234/documentlibrary/@recent
Accept:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the DocumentLibrary resource. For an example, see the "DocumentLibrary Resource Response: JSON Format, One Resource Returned" section.

Get Information about Document Files in the Document Library of a Community that are Authored by a Designated User

Purpose

Retrieves information about document files that are in the document library of the designated community and that are authored by the designated user.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/
documentlibrary?filterBy=author&filterValue=
user_id[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community library with the document library that contains the document files about which information is to be retrieved. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

user_id—Identifier of the user who authored the document files about which information is to be retrieved. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the DocumentLibrary resource to include in a response (Table 3-19 describes these fields).

The filterBy query parameter is required as shown in the URI.

The sortOrder query parameter does not apply.

The startIndex query parameter is supported for paginating return results by designating the first DocumentFolder or DocumentFile child resource that is returned. The DocumentFolder child resource takes precedence.

The count query parameter is supported for designating the maximum number of DocumentFolder and DocumentFile child resources that are included in the return results. DocumentFolder child resources take precedence.

The meta query parameter does not apply.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one DocumentLibrary resource that contains representations of document files that are authored by the designated user (the "DocumentLibrary Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/1234/documentlibrary? 
filterBy=author&filterValue=4321
Accept:application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the DocumentLibrary resource. For an example, see the "DocumentLibrary Resource Response: XML Format, One Resource Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/1234/documentlibrary? 
filterBy=author&filterValue=4321
Accept:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the DocumentLibrary resource. For an example, see the "DocumentLibrary Resource Response: XML Format, One Resource Returned" section.

Get Information about Community Profile Images

Purpose

Retrieves information about profile images for the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/communities/community_id/images
/@profile
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve the profile image. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter is supported for selecting fields from the ProfileImage resource to include in a response (Table 3-33 describes these fields)

The filterBy query parameter is not supported for filtering resources in a response

The sortOrder query parameter is not supported for sorting resources in a response

The startIndex query parameter is not supported for paginating return results

The count query parameter is not supported for designating the maximum number of items in the return results

The meta query parameter does not apply

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that can include one or more ProfileImage resources (the "ProfileImage Resource" section describes this resource). XML and JSON formats are supported.

XML Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/images/@profile
Accept:application/json
Content-Type:application/xml

Response

HTTP/1.1 200 OK
Content-Type: application/xml
 
   

The response can also include the ProfileImage resource. For an example, see the "ProfileImage Resource Response: XML Format, Multiple Resources Returned" section.

JSON Example

Request

GET http://webexsocialserver/api/quad/rest/communities/4710003/images/@profile
Accept:application/json
Content-Type:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the ProfileImage resource. For an example, see the "ProfileImage Resource Response: JSON Format, Multiple Resources Returned" section.

Get All Activities that are Visible to You in a Community

Purpose

Retrieves information about all activities that are visible to you in the designated community.

An activity consists of these components: actor, action, object, and target. An activity describes an action that is performed by an actor with or on an object that relates to a target. For example, an actor could be a Cisco WebEx Social user, an action could be "created," an object could be a document, and a target could be a library.

A component may be explicit or implied. For example, an activity could be described as "Nicole updated a document in her library" or "Mike shared a post."

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

GET

http://server[:port_number]/api/quad/rest/users/community_id/activities
[?query_parameters]


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to retrieve information about activities that are visible to you. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

query_parameters—Query parameters. See the "Query Parameters" section for information about using query parameters. For this operation:

The fields query parameter does not apply.

The filterBy query parameter is supported in this format: filterBy={@user|@community|@tag}&filterValue=value.

For filterBy=@user, value is the identifier of a Cisco WebEx Social user. In this case, the operation retrieves only activities that include this user. You can use a value of @me to designate yourself. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

For filterBy=@community, value is the identifier of a Cisco WebEx Social community. In this case, the operation retrieves only activities that include this community. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

For filterBy=@tag, value is the name of a tag to an entity. In this case, the operation retrieves only activities that include this tag.

The sortOrder query parameter is not supported for sorting resources in a response.

The startIndex query parameter is not supported for paginating return results.

The count query parameter is supported for designating the maximum number of items in the return results. The system retrieves activities in reverse chronological order, stopping when it retrieves the designated maximum number of activities. (If you specify the count and the timestamp query parameters in the same request, the system stops retrieving activities when it retrieves the designated maximum number of activities or when it reaches the time_since date and time, whichever occurs first.)

The meta query parameter does not apply.

The special query parameter timestamp=time_since is supported for retrieving activities that occurred between the date and time that you designate and the date and time that you execute this operation. Replace time_since with the date and time, in UTC format, from which no earlier activities are to be retrieved.

Request Payload

A request payload is not required.

Response

Standard response (see the "API Responses" section) with a response payload that includes the following:

Item
Explanation

objectType

Appears as .

timestamp

Date and time that the earliest activity that is returned occurred, in UTC format.

totalItems

Total number of items that are returned.

items

Array of Activity activities resources. The "Activity Activities Resource" section describes this resource.


SON Example

Request

GET http://webexsocialserver/api/quad/rest/users/1234/activities
Accept:application/json

Response

HTTP/1.1 200 OK
Content-Type: application/json
 
   

The response can also include the Collection activities resource. For an example, see the "Collection Activities Resource Response: JSON Format, Multiple Resources Returned" section.

Atom Example

Request

GET http://webexsocialserver/api/quad/rest/users/1234/activities
Accept: application/atom+xml

Response

HTTP/1.1 200 OK
Content-Type: application/atom+xml

The response can also include the Collection activities resource. For an example, see the "Collection Activities Resource Response: Atom Format, Multiple Resources Returned" section.

Update a Community Profile Image

Purpose

Updates the community profile image for the designated community.

Availability

Cisco WebEx Social 3.0 and later.

Request

HTTP Method
URI

POST

http://server[:port_number]/api/quad/rest/communities/community_id/images
/@profile


where:

server—Host name or IP address of the Cisco WebEx Social server.

port_number—Port number on which the Cisco WebEx Social server listens for API requests. The default value is 80.

community_id—Identifier of the community for which to update the profile image. For information about obtaining the identifier that you need, see the "Identifiers of Cisco WebEx Social Entities" section.

Request Payload

Image to be uploaded.

The HTTP Content-Type header must be multipart/form-data for this request. The form-data key must be specified as image=image_to_upload.

Response

Standard response (see the "API Responses" section) with an HTTP header only.

XML Example

Request

POST http://quadserver//api/quad/rest/communities/4710003/images/@profile
Accept:application/xml
content-length: 87899
 
   
expect: 100-continue
content-type: multipart/form-data; boundary=----------------------------02a4bb521c19
------------------------------02a4bb521c19
Content-Disposition: form-data; name="image"; filename="ProfilePhoto.jpg"
<binary_file>
------------------------------02a4bb521c19--

Response

HTTP/1.1 204 No Content

JSON Example

Request

POST http://quadserver//api/quad/rest/communities/4710003/images/@profile
Accept:application/json
content-length: 87899
 
   
expect: 100-continue
content-type: multipart/form-data; boundary=----------------------------02a4bb521c19
------------------------------02a4bb521c19
Content-Disposition: form-data; name="image"; filename="ProfilePhoto.jpg"
<binary_file>
------------------------------02a4bb521c19--

Response

HTTP/1.1 204 No Content