POST api/v2.0/Contacts/GetContactContributions

Returns a list of published items a given Contact has authored. The list includes Announcements, Blogs, Discussion Messages, Library Entries, Questions, and Answers.

Request Information

URI Parameters

None.

Body Parameters

Properties to apply to return a paginated/scrollable list of items

ContactContributionRequest

Name	Description	Type	Additional information
ContactKey	The key of the Contact whose contributions to return	globally unique identifier	None.
SortOrder	Sort Order possible values: asc or desc. Default: desc	string	None.
NumberToReturn	Number of items to return in the feed. Valid number to return is between 0 and 25. Default is 10.	integer	None.
Direction	Direction to fetch from the specified marker up (Larger Value) down (Smaller Value)	string	None.
Marker	Origin marker that can be used to grab the next set of feed items based on a marker from a previous request.	string	None.

Request Formats

application/json, text/json

Sample:

{
  "ContactKey": "b3db43ab-deb7-4b09-b9ce-b73aafec33ee",
  "SortOrder": "sample string 2",
  "NumberToReturn": 3,
  "Direction": "sample string 4",
  "Marker": "sample string 5"
}

application/xml, text/xml

Sample:

<ContactContributionRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.DataFeed">
  <Direction>sample string 4</Direction>
  <Marker>sample string 5</Marker>
  <NumberToReturn>3</NumberToReturn>
  <ContactKey>b3db43ab-deb7-4b09-b9ce-b73aafec33ee</ContactKey>
  <SortOrder>sample string 2</SortOrder>
</ContactContributionRequest>

Response Information

Resource Description

A list of items and pagination/scrolling properties

Collection of DataFeedItem

Name	Description	Type	Additional information
ItemKey	The primary key associated with the item based on its content type	globally unique identifier	None.
Title	Title	string	None.
Body	Description	string	None.
Contributor	Author or Contributor of the data feed item	DataFeedContributor	None.
ParentContainer	Parent in which the data feed item is contained. Ex: Community	DataFeedParentContainer	None.
ActionText	Action Taken Text	string	None.
CreateDate	UTC timestamp for when the item was created. Use only if PublishedDate is not available.	date	None.
PublishedDate	UTC timestamp for when the item was published to users on the site	date	None.
PublicationStatus	Item status determined by PublishedOn date - the possible statuses include "scheduled", "draft", and "published"	string	None.
Date01	Custom date field used for certain content types such as the start date for events. As well as best response date for questions and answers.	date	None.
Date02	Custom date field used for certain content types such as the end date for events	date	None.
HasRecommended	Whether or not the current user has liked/recommended the feed item	boolean	None.
HasReplied	Whether or not the current user has replied/commented on the feed item	boolean	None.
Bool01	Generic boolean value specific to the type, ex: Whether or not the current user has registered for the item/event.	boolean	None.
Bool02	Generic boolean value specific to the type, ex: Whether or not the item/event is open for registration.	boolean	None.
ItemType	The type of content, such as blog, announcement, ...	string	None.
LinkToViewItem	Provides a url to view the item on the website	string	None.
Tags	All of the tags indexed for the item. This includes user tags and admin based tags	Collection of ItemTagResponse	None.
RecommendationCount	The number of times the item has been "recommended" or "liked"	integer	None.
AttachmentsContainer	The attachment container info, the attachments within the container, and their necessary metadata related to the specified item	DataFeedAttachmentsContainer	None.
ResponseCount	The number of responses for the thread that the item is contained in. If it is not contained within a thread it should not return.	integer	None.
Text01	Custom text field used for certain content types such as the location for events	string	None.
Text02	Custom text field used for certain content types such as the start/end date string for events	string	None.
Text03	Custom text field used for certain content types such as the event type name for events	string	None.
Text04	Custom text field used for certain content types such as the registration type for events	string	None.
ThreadKey	The ID of the thread containing the item	globally unique identifier	None.
Marker	Item origin marker	string	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "ItemKey": "b8ba20b9-68c4-43c0-a2d9-1acadf34f5aa",
    "Title": "sample string 2",
    "Body": "sample string 3",
    "Contributor": {
      "ContactKey": "a166fe19-9dbe-45a7-a162-3aeada8aa26f",
      "PictureUrl": "sample string 2",
      "FirstName": "sample string 3",
      "LastName": "sample string 4",
      "DisplayName": "sample string 5",
      "ViewUrl": "sample string 6"
    },
    "ParentContainer": {
      "ContainerKey": "dfbca51b-75e0-441a-8767-cba998ac1f51",
      "ContainerName": "sample string 2",
      "ContainerType": "sample string 3"
    },
    "ActionText": "sample string 4",
    "CreateDate": "2024-04-24T07:29:59.0933711Z",
    "PublishedDate": "2024-04-24T07:29:59.0933711Z",
    "PublicationStatus": "published",
    "Date01": "2024-04-24T07:29:59.0933711Z",
    "Date02": "2024-04-24T07:29:59.0933711Z",
    "HasRecommended": true,
    "HasReplied": true,
    "Bool01": true,
    "Bool02": true,
    "ItemType": "sample string 13",
    "LinkToViewItem": "sample string 14",
    "Tags": [
      {
        "Tag": "sample string 1",
        "TagType": "sample string 2"
      },
      {
        "Tag": "sample string 1",
        "TagType": "sample string 2"
      }
    ],
    "RecommendationCount": 15,
    "AttachmentsContainer": {
      "DocumentKey": "2b293be0-a906-4b98-ac90-afc8d7c80a5a",
      "Attachments": [
        {
          "AttachmentKey": "7baa8e9e-c390-4373-8705-586826896230",
          "AttachmentName": "sample string 2",
          "AttachmentUrl": "sample string 3",
          "MimeType": "sample string 4"
        },
        {
          "AttachmentKey": "7baa8e9e-c390-4373-8705-586826896230",
          "AttachmentName": "sample string 2",
          "AttachmentUrl": "sample string 3",
          "MimeType": "sample string 4"
        }
      ]
    },
    "ResponseCount": 16,
    "Text01": "sample string 17",
    "Text02": "sample string 18",
    "Text03": "sample string 19",
    "Text04": "sample string 20",
    "ThreadKey": "6c284b39-e11e-49d2-89be-299619de73fb",
    "Marker": "sample string 22"
  },
  {
    "ItemKey": "b8ba20b9-68c4-43c0-a2d9-1acadf34f5aa",
    "Title": "sample string 2",
    "Body": "sample string 3",
    "Contributor": {
      "ContactKey": "a166fe19-9dbe-45a7-a162-3aeada8aa26f",
      "PictureUrl": "sample string 2",
      "FirstName": "sample string 3",
      "LastName": "sample string 4",
      "DisplayName": "sample string 5",
      "ViewUrl": "sample string 6"
    },
    "ParentContainer": {
      "ContainerKey": "dfbca51b-75e0-441a-8767-cba998ac1f51",
      "ContainerName": "sample string 2",
      "ContainerType": "sample string 3"
    },
    "ActionText": "sample string 4",
    "CreateDate": "2024-04-24T07:29:59.0933711Z",
    "PublishedDate": "2024-04-24T07:29:59.0933711Z",
    "PublicationStatus": "published",
    "Date01": "2024-04-24T07:29:59.0933711Z",
    "Date02": "2024-04-24T07:29:59.0933711Z",
    "HasRecommended": true,
    "HasReplied": true,
    "Bool01": true,
    "Bool02": true,
    "ItemType": "sample string 13",
    "LinkToViewItem": "sample string 14",
    "Tags": [
      {
        "Tag": "sample string 1",
        "TagType": "sample string 2"
      },
      {
        "Tag": "sample string 1",
        "TagType": "sample string 2"
      }
    ],
    "RecommendationCount": 15,
    "AttachmentsContainer": {
      "DocumentKey": "2b293be0-a906-4b98-ac90-afc8d7c80a5a",
      "Attachments": [
        {
          "AttachmentKey": "7baa8e9e-c390-4373-8705-586826896230",
          "AttachmentName": "sample string 2",
          "AttachmentUrl": "sample string 3",
          "MimeType": "sample string 4"
        },
        {
          "AttachmentKey": "7baa8e9e-c390-4373-8705-586826896230",
          "AttachmentName": "sample string 2",
          "AttachmentUrl": "sample string 3",
          "MimeType": "sample string 4"
        }
      ]
    },
    "ResponseCount": 16,
    "Text01": "sample string 17",
    "Text02": "sample string 18",
    "Text03": "sample string 19",
    "Text04": "sample string 20",
    "ThreadKey": "6c284b39-e11e-49d2-89be-299619de73fb",
    "Marker": "sample string 22"
  }
]

application/xml, text/xml

Sample:

<ArrayOfDataFeedItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.DataFeed">
  <DataFeedItem>
    <ActionText>sample string 4</ActionText>
    <AttachmentsContainer>
      <Attachments>
        <DataFeedAttachment>
          <AttachmentKey>7baa8e9e-c390-4373-8705-586826896230</AttachmentKey>
          <AttachmentName>sample string 2</AttachmentName>
          <AttachmentUrl>sample string 3</AttachmentUrl>
          <MimeType>sample string 4</MimeType>
        </DataFeedAttachment>
        <DataFeedAttachment>
          <AttachmentKey>7baa8e9e-c390-4373-8705-586826896230</AttachmentKey>
          <AttachmentName>sample string 2</AttachmentName>
          <AttachmentUrl>sample string 3</AttachmentUrl>
          <MimeType>sample string 4</MimeType>
        </DataFeedAttachment>
      </Attachments>
      <DocumentKey>2b293be0-a906-4b98-ac90-afc8d7c80a5a</DocumentKey>
    </AttachmentsContainer>
    <Body>sample string 3</Body>
    <Bool01>true</Bool01>
    <Bool02>true</Bool02>
    <Contributor>
      <ContactKey>a166fe19-9dbe-45a7-a162-3aeada8aa26f</ContactKey>
      <DisplayName>sample string 5</DisplayName>
      <FirstName>sample string 3</FirstName>
      <LastName>sample string 4</LastName>
      <PictureUrl>sample string 2</PictureUrl>
      <ViewUrl>sample string 6</ViewUrl>
    </Contributor>
    <CreateDate>2024-04-24T03:29:59.0933711-04:00</CreateDate>
    <Date01>2024-04-24T03:29:59.0933711-04:00</Date01>
    <Date02>2024-04-24T03:29:59.0933711-04:00</Date02>
    <HasRecommended>true</HasRecommended>
    <HasReplied>true</HasReplied>
    <ItemKey>b8ba20b9-68c4-43c0-a2d9-1acadf34f5aa</ItemKey>
    <ItemType>sample string 13</ItemType>
    <LinkToViewItem>sample string 14</LinkToViewItem>
    <Marker>sample string 22</Marker>
    <ParentContainer>
      <ContainerKey>dfbca51b-75e0-441a-8767-cba998ac1f51</ContainerKey>
      <ContainerName>sample string 2</ContainerName>
      <ContainerType>sample string 3</ContainerType>
    </ParentContainer>
    <PublishedDate>2024-04-24T03:29:59.0933711-04:00</PublishedDate>
    <RecommendationCount>15</RecommendationCount>
    <ResponseCount>16</ResponseCount>
    <Tags xmlns:d3p1="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Tagging">
      <d3p1:ItemTagResponse>
        <d3p1:Tag>sample string 1</d3p1:Tag>
        <d3p1:TagType>sample string 2</d3p1:TagType>
      </d3p1:ItemTagResponse>
      <d3p1:ItemTagResponse>
        <d3p1:Tag>sample string 1</d3p1:Tag>
        <d3p1:TagType>sample string 2</d3p1:TagType>
      </d3p1:ItemTagResponse>
    </Tags>
    <Text01>sample string 17</Text01>
    <Text02>sample string 18</Text02>
    <Text03>sample string 19</Text03>
    <Text04>sample string 20</Text04>
    <ThreadKey>6c284b39-e11e-49d2-89be-299619de73fb</ThreadKey>
    <Title>sample string 2</Title>
  </DataFeedItem>
  <DataFeedItem>
    <ActionText>sample string 4</ActionText>
    <AttachmentsContainer>
      <Attachments>
        <DataFeedAttachment>
          <AttachmentKey>7baa8e9e-c390-4373-8705-586826896230</AttachmentKey>
          <AttachmentName>sample string 2</AttachmentName>
          <AttachmentUrl>sample string 3</AttachmentUrl>
          <MimeType>sample string 4</MimeType>
        </DataFeedAttachment>
        <DataFeedAttachment>
          <AttachmentKey>7baa8e9e-c390-4373-8705-586826896230</AttachmentKey>
          <AttachmentName>sample string 2</AttachmentName>
          <AttachmentUrl>sample string 3</AttachmentUrl>
          <MimeType>sample string 4</MimeType>
        </DataFeedAttachment>
      </Attachments>
      <DocumentKey>2b293be0-a906-4b98-ac90-afc8d7c80a5a</DocumentKey>
    </AttachmentsContainer>
    <Body>sample string 3</Body>
    <Bool01>true</Bool01>
    <Bool02>true</Bool02>
    <Contributor>
      <ContactKey>a166fe19-9dbe-45a7-a162-3aeada8aa26f</ContactKey>
      <DisplayName>sample string 5</DisplayName>
      <FirstName>sample string 3</FirstName>
      <LastName>sample string 4</LastName>
      <PictureUrl>sample string 2</PictureUrl>
      <ViewUrl>sample string 6</ViewUrl>
    </Contributor>
    <CreateDate>2024-04-24T03:29:59.0933711-04:00</CreateDate>
    <Date01>2024-04-24T03:29:59.0933711-04:00</Date01>
    <Date02>2024-04-24T03:29:59.0933711-04:00</Date02>
    <HasRecommended>true</HasRecommended>
    <HasReplied>true</HasReplied>
    <ItemKey>b8ba20b9-68c4-43c0-a2d9-1acadf34f5aa</ItemKey>
    <ItemType>sample string 13</ItemType>
    <LinkToViewItem>sample string 14</LinkToViewItem>
    <Marker>sample string 22</Marker>
    <ParentContainer>
      <ContainerKey>dfbca51b-75e0-441a-8767-cba998ac1f51</ContainerKey>
      <ContainerName>sample string 2</ContainerName>
      <ContainerType>sample string 3</ContainerType>
    </ParentContainer>
    <PublishedDate>2024-04-24T03:29:59.0933711-04:00</PublishedDate>
    <RecommendationCount>15</RecommendationCount>
    <ResponseCount>16</ResponseCount>
    <Tags xmlns:d3p1="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Tagging">
      <d3p1:ItemTagResponse>
        <d3p1:Tag>sample string 1</d3p1:Tag>
        <d3p1:TagType>sample string 2</d3p1:TagType>
      </d3p1:ItemTagResponse>
      <d3p1:ItemTagResponse>
        <d3p1:Tag>sample string 1</d3p1:Tag>
        <d3p1:TagType>sample string 2</d3p1:TagType>
      </d3p1:ItemTagResponse>
    </Tags>
    <Text01>sample string 17</Text01>
    <Text02>sample string 18</Text02>
    <Text03>sample string 19</Text03>
    <Text04>sample string 20</Text04>
    <ThreadKey>6c284b39-e11e-49d2-89be-299619de73fb</ThreadKey>
    <Title>sample string 2</Title>
  </DataFeedItem>
</ArrayOfDataFeedItem>