Blogs

Blog Groups

GET /api/blogs.ashx/bloggroups/

Returns a list of all blog groups visible to the current user.

Response

Status: 200 OK

<BlogGroupList>
  <BlogGroup>
    ...
  </BlogGroup>
  ...
</BlogGroupList>

GET /api/blogs.ashx/bloggroups/{Id}

This will return the information for the referenced blog group.

Response

Status: 200 OK

<BlogGroup>
  ...
</BlogGroup>

Create Blog Groups

POST /api/blogs.ashx/bloggroups/

Creates a new blog group.

Request

<BlogGroup>
  ...
</BlogGroup>

Response

Status: 201 CREATED

<BlogGroup>
  ...
</BlogGroup>

Update Blog Groups

PUT /api/blogs.ashx/bloggroups/{Id}

Request

<BlogGroup>
  ...
</BlogGroup>

Response

Status: 200 OK

<BlogGroup>
  ...
</BlogGroup>

Delete Blog Groups

DELETE /api/blogs.ashx/bloggroups/{Id}

Response

Status: 200 OK

Blogs

List

GET /api/blogs.ashx/blogs/

Response

Status: 200 OK

<BlogList PageSize="20" PageIndex="0" TotalCount="2">
  <Blog>
    ...
  </Blog>
  ...
</BlogList>

GET /api/blogs.ashx/bloggroups/{Id}/blogs/

Returns a list of Blogs which are members of the specified bloggroup.

Response

Status: 200 OK

<BlogList PageSize="20" PageIndex="0" TotalCount="1">
  <Blog>
    ...
  </Blog>
  ...
</BlogList>

GET /api/blogs.ashx/blogs/{blog query parameters}

Returns a list of Blogs which match the query parameters provided on the querystring.

Response

Status: 200 OK

<BlogList PageSize="20" PageIndex="0" TotalCount="1">
  <Blog>
    ...
  </Blog>
  ...
</BlogList>

GET /api/blogs.ashx/blogs/{Id}

Response

Status: 200 OK

<Blog>
  ...
</Blog>

Create Blog

POST /api/blogs.ashx/blogs/

Response

<Blog>
  ...
</Blog>

Note the BlogGroupInfo object can be omitted if you pass the desired Blog Group Id into the URI Context by posting to /api/blogs.ashx/bloggroups/{GroupId}/blogs

Minimum required fields (Name, Key, and BlogGroupInfo.Id)

Response

Status: 201 CREATED

<Blog>
 ...
</Blog>

Update Blog

PUT /api/blogs.ashx/blogs/{Id}

Request

<Blog>
 ...
</Blog>

Response

Status: 200 OK

<Blog>
  ...
</Blog>

Delete Blog

DELETE /api/blogs.ashx/blogs/{Id}

Response

Status: 200 OK

BlogPosts

List

GET /api/blogs.ashx/blogs/{Id}/posts

Response

Status: 200 OK

<BlogPostList PageSize="20" PageIndex="0" TotalCount="1">
  <BlogPost>
     ...
  </BlogPost>
  ...
</BlogPostList>

GET /api/blogs.ashx/posts/{blog post query parameters}

Returns a list of Blog Posts which match the query parameters provided on the querystring.

Response

Status: 200 OK

<BlogPostList PageSize="20" PageIndex="0" TotalCount="1">
  <BlogPost>
     ...
  </BlogPost>
  ...
</BlogPostList>

GET /api/blogs.ashx/posts/{Id}

Response

Status: 200 OK

<BlogPost>
   ...
</BlogPost>

Create Post

POST /api/blogs.ashx/posts/

Request

<BlogPost>
   ...
</BlogPost>

Note the BlogInfo object can be omitted if you pass the desired Blog Id into the URI Context by posting to /api/blogs.ashx/blogs/{BlogId}/posts

Minimum required fields (Title, Body, and Date)

Response

Status: 201 CREATED

<BlogPost>
   ...
</BlogPost>

Update Post

PUT /api/blogs.ashx/posts/{Id}

Request

<BlogPost>
   ...
</BlogPost>

Response

Status: 200 OK

<BlogPost>
   ...
</BlogPost>

Delete Post

DELETE /api/blogs.ashx/posts/{Id}

Response

Status: 200 OK

Comments

Lists the Blog Post Comments relative to the specified Blog Post.

GET /api/blogs.ashx/posts/{Id}/comments

Response

Status: 200 OK

<CommentList PageSize="20" PageIndex="0" TotalCount="1">
  <Comment>
     ...
  </Comment>
  ...
</CommentList>

GET /api/blogs.ashx/comments/{blog post comment query parameters}

Returns a list of Blog Post Comments which match the query parameters provided on the querystring.

Response

Status: 200 OK

<CommentList PageSize="20" PageIndex="0" TotalCount="1">
  <Comment>
     ...
  </Comment>
  ...
</CommentList>

GET /api/blogs.ashx/comments/{Id}

Response

Status: 200 OK

<Comment>
   ...
</Comment>

Create Comment

POST /api/blogs.ashx/[posts/{PostId}/]comments/

Request

<Comment>
   ...
</Comment>

Note the PostInfo object can be omitted if you pass the desired Post Id into the URI Context by posting to /api/blogs.ashx/posts/{PostId}/comments

Minimum required fields (Title, Body, and Date)

Response

Status: 201 CREATED

<Comment>
   ...
</Comment>

Update Comment

PUT /api/blogs.ashx/comments/{Id}

Request

<Comment>
   ...
</Comment>

Response

Status: 200 OK

<Comment>
   ...
</Comment>

Delete Comment

DELETE /api/blogs.ashx/comments/{Id}

Response

Status: 200 OK

Trackbacks

List

GET /api/blogs.ashx/posts/{Id}/trackbacks

Response

Status: 200 OK

<TrackbackList PageSize="20" PageIndex="0" TotalCount="1">
  <Trackback>
     ...
  </Trackback>
  ...
</TrackbackList>

GET /api/blogs.ashx/trackbacks/{blog post trackback query parameters}

Returns a list of Blog Post Trackbacks which match the query parameters provided on the querystring.

Response

Status: 200 OK

<TrackbackList PageSize="20" PageIndex="0" TotalCount="1">
  <Trackback>
     ...
  </Trackback>
  ...
</TrackbackList>

GET /api/blogs.ashx/trackbacks/{Id}

Response

Status: 200 OK

<Trackback>
   ...
</Trackback>

Delete Trackback

DELETE /api/blogs.ashx/trackbacks/{Id}

Response

Status: 200 OK

Ratings

Returns a list of Blog Post Ratings for the specified Blog Post.

GET /api/blogs.ashx/posts/{Id}/ratings

Response

Status: 200 OK

<RatingList Sum="5" Average="5">
  <Rating />
  ...
</RatingList>

GET /api/blogs.ashx/posts/{PostId}/ratings/{UserId}

Response

Status: 200 OK

<Rating />

Create Rating

Ratings are created or updated by posting an XML serialized integer value between 0 and 5 to the Post Ratings endpoint.

POST /api/blogs.ashx/posts/{PostId}/ratings/

Request

<int>[value 0-5]</int>

Response

Status: 201 CREATED

<Rating />

Update Rating

Ratings are created or updated by posting an XML serialized integer value between 0 and 5 to the Post Ratings endpoint.

PUT /api/blogs.ashx/posts/{PostId}/ratings/{UserId}

Request

<int>[value 0-5]</int>

Response

Status: 200 OK

<Rating />

Attachments

GET /api/blogs.ashx/[blogs/{BlogId}/]posts/{PostId}/attachment

Response

Status: 302 http://localhost/cs/url/to/attachment

Create Attachment

This method is used to create an attachment for an existing post.

POST /api/forums.ashx/[blogs/{BlogId}/]posts/{PostId}/attachment

Request

[raw file]

Response

Status: 201 http://localhost/cs/url/to/attachment

Update Attachment

This updates an existing attachment. The post must already have an existing attachment to use this method.

PUT /api/blogs.ashx/[blogs/{BlogId}/]posts/{PostId}/attachment

Request

[raw file]

Response

Status: 200 OK

DELETE /api/blogs.ashx/[blogs/{BlogId}/]posts/{PostId}/attachment

Response

Status: 200 OK

Referrals

A list of all the HttpReferrals logged to a specific Blog Post. Only Blog Administrators can access this endpoint.

GET /api/blogs.ashx/posts/{Id}/referrals

Response

Status: 200 OK

<ReferralList PageSize="20" PageIndex="0" TotalCount="1">
  <Referral>
     ...
  </Referral>
  ...
</ReferralList>

GET /api/blogs.ashx/referrals/{blog post referral query parameters}

Returns a list of Blog Post Referrals which match the query parameters provided on the querystring.

Response

Status: 200 OK

<ReferralList PageSize="20" PageIndex="0" TotalCount="1">
  <Referral>
     ...
  </Referral>
  ...
</ReferralList>

GET /api/blogs.ashx/referrals/{Id}

Response

Status: 200 OK

<Referral>
   ...
</Referral>

Members (Owners)

The members endpoint is used to provide an owner list for a Blog. This is a list of user accounts with administrative access to this blog. Only member type "owner" is support by Blogs.

GET /api/blogs.ashx/blogs/{blogId}/members

Response

Status: 200 OK

<MembershipList>
  <Member />
  ...
</MembershipList>

GET /api/blogs.ashx/blogs/{blogId}/members/{UserId}

Response

Status: 200 OK

<Member />

Create Member

POST /api/blogs.ashx/blogs/{blogId}/members

Request

<Member />

Response

Status: 201 CREATED

<Member />

Update Member

PUT /api/blogs.ashx/blogs/{blogId}/members/{UserId}

Request

<Member />

Response

Status: 200 OK

<Member />

Delete Member

DELETE /api/blogs.ashx/blogs/{blogId}/members/{UserId}

Response

Status: 200 OK

Attachments

GET /api/forums.ashx/[forum/{ForumId}/]posts/{PostId}/attachment

Response

Status: 302 http://localhost/cs/url/to/attachment

Create Attachment

This method is used to create an attachment for an existing post.

POST /api/forums.ashx/[forum/{ForumId}/]/posts/{PostId}/attachment

Request

[raw file]

Response

Status: 201 http://localhost/cs/url/to/attachment

Update Attachment

This updates an existing attachment. The post must already have an existing attachment to use this method.

PUT /api/forums.ashx/[forum/{ForumId}/]/posts/{PostId}/attachment

Request

[raw file]

Response

Status: 200 OK

DELETE /api/forums.ashx/[forum/{ForumId}/]/posts/{PostId}/attachment

Response

Status: 200 OK

Permissions

Displays the Blog permissions assigned to each role. Permissions may be overriden within each Blog, and are settable by the Blog Administrator.

GET /api/blogs.ashx/permissions (Application Level)

Response

Status: 200 OK

<BlogPermissionList>
  <BlogPermission>
    ...
  </BlogPermission>
  ...
</BlogPermissionList>

GET /api/blogs.ashx/blogs/{Id}/permissions (Blog Level)

Response

Status: 200 OK

<BlogPermissionList>
  <BlogPermission>
    ...
  </BlogPermission>
  ...
</BlogPermissionList>

GET /api/blogs.ashx/[blogs/{Id}/]permissions/{permission name}

Response

Status: 200 OK

<BlogPermission>
  ...
</BlogPermission>

Create Permission

This method is used to explicity define the permissions for a role on a Blog, where the permissions were previously inerhited from the applicaiton default.

POST /api/blogs.ashx/blogs/{Id}/permissions/{permission name}

Request

<BlogPermission>
  ...
</BlogPermission>

Response

Status: 201 CREATED

<BlogPermission> 
  ...
</BlogPermission>

Update Permission

Updates the permissions assigned to a particular role. This request can be made either for a specific Blog, or to set the default values for all Blogs. Roles must already exist to have permissions added or changed, see the membership roles section on adding or deleting roles.

PUT /api/blogs.ashx/[blogs/{Id}/]permissions/{permission name}

Request

<BlogPermission>
  ...
</BlogPermission>

Response

Status: 200 OK

<BlogPermission>
  ...
</BlogPermission>

Delete Permission

Removes the specified explicity defined permission (where Implied="false") from the Blog. This will cause the permissions for that role to again be inherited from the applicaiton level.

DELETE /api/blogs.ashx/blogs/{Id}/permissions/{permission name}

Response

Status: 200 OK

Note you can only delete explicity defined permissions (where Implied="false") not default ones which are inherited from the application level.

Settings

GET /api/blogs.ashx/settings

Response

Status: 200 OK
<BlogSettings>
  ...
</BlogSettings>

Update Settings

POST or PUT /api/blogs.ashx/settings

Request

<BlogSettings>
  ...
</BlogSettings>

Response

Status: 200 OK

<BlogSettings>
  ...
</BlogSettings>

Data Reference

BlogGroup

<BlogGroup Id="1" Xref="http://localhost/cs/api/blogs.ashx/bloggroups/1">
  <Name>Sample Weblogs</Name> 
  <Description/>
</BlogGroup>

Blog

<Blog Id="4" Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4">
  <Name>Sample Weblog</Name>
  <Key>sample_weblog</Key>  
  <Url>http://localhost/cs/blogs/sample_weblog/default.aspx</Url>
  <Rss>http://localhost/cs/blogs/sample_weblog/rss.aspx</Rss>
  <Atom>http://localhost/cs/blogs/sample_weblog/atom.aspx</Atom>
  <BlogGroupInfo Id="4" 
     Endpoint="http://localhost/cs/api/blogs.ashx/bloggroups/4" />
  <DateCreated>2007-12-11T13:01:49.98</DateCreated>
  <Description />
  <Settings>
    <DefaultThreadDateFilter>OneMonth</DefaultThreadDateFilter>
    <NewsgroupName>sample.weblog</NewsgroupName>
    <PostsToModerate>0</PostsToModerate>
    <EnablePostStatistics>true</EnablePostStatistics>
    <EnablePostPoints>true</EnablePostPoints>
    <EnableAnonymousPosting>false</EnableAnonymousPosting>
    <SortOrder>1</SortOrder>
    <IsActive>true</IsActive>
    <IsVisible>false</IsVisible>
    <IsCommunityAggregated>true</IsCommunityAggregated>
    <IsSearchable>true</IsSearchable>
    <IsModerated>false</IsModerated>
    <IsPublic>true</IsPublic>
    <HasIsPublic>true</HasIsPublic>
    <DefaultLanguage>en</DefaultLanguage>
    <EnableAnonymousPostingForUsers>false</EnableAnonymousPostingForUsers>
    <EnableThreadStatus>false</EnableThreadStatus>
    <CategorySortBy>Unspecified</CategorySortBy>
    <CategorySortOrder>0</CategorySortOrder>
    <BlockSpamFeedbackNotifications>false</BlockSpamFeedbackNotifications>
  </Settings>
  <AboutTitle>About Sample Weblog</AboutTitle>
  <AboutDescription />
  <News />
  <Posts Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/" />
  <Statistics Posts="2" Pages="0" Comments="1" Trackbacks="0" 
    CommentsToModerate="0" DiskUsage="0" />
  <BlogPostOverrides>
    <EnableTrackbacksOverride>true</EnableTrackbacksOverride>
    <EnableCommentsOverride>true</EnableCommentsOverride>
    <EnableCommentApiOverride>false</EnableCommentApiOverride>
    <EnableRssCommentFeedsOverride>true</EnableRssCommentFeedsOverride>
    <EnableRatingsOverride>true</EnableRatingsOverride>
  </BlogPostOverrides>
  <BlogPostDefaults>
    <EnableCommentsDefault>true</EnableCommentsDefault>
    <EnableRatingsDefault>true</EnableRatingsDefault>
    <EnableTrackbacksDefault>true</EnableTrackbacksDefault>
    <EnableCommunityParticipationDefault>
     true
    </EnableCommunityParticipationDefault>
    <EnablePostAggregationDefault>true</EnablePostAggregationDefault>
    <SyndicateExcerptDefault>false</SyndicateExcerptDefault>
    <EnableCrossPostingDefault>false</EnableCrossPostingDefault>
    <DefaultPostConfig>3</DefaultPostConfig>
  </BlogPostDefaults>
  <Theme>default</Theme>
  <Email />
  <RssLanguage />
  <EnableAggBugs>true</EnableAggBugs>
  <AutoNamePosts>true</AutoNamePosts>
  <EnableRss>true</EnableRss>
  <EnableAtom>true</EnableAtom>
  <EnableTagsRss>true</EnableTagsRss>
  <EnableAbout>false</EnableAbout>
  <SyndicateExternalLinks>false</SyndicateExternalLinks>
  <FeedbackNotificationType>0</FeedbackNotificationType>
  <EnableAllOwnerNotification>false</EnableAllOwnerNotification>
  <EnableContact>true</EnableContact>
  <EnablePings>true</EnablePings>
  <CommentExpirationDays>999999</CommentExpirationDays>
  <RawAdditionalHeader />
  <ExternalFeedUrl />
  <FeedBurnerUsername />
  <EnableFeedBurnerStatistics>false</EnableFeedBurnerStatistics>
  <ExcludeOwnerFromFeedBurnerStatistics>
    false
  </ExcludeOwnerFromFeedBurnerStatistics>
  <ModeratedFeedbackNotificationThreshold>
    0
  </ModeratedFeedbackNotificationThreshold>
  <ModeratedFeedbackNotificationSent>false</ModeratedFeedbackNotificationSent>
</Blog>

BlogPost

<BlogPost Id="2" Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2">
  <Name>My First Post</Name>
  <Title>Welcome to Community Server Blogs!</Title>
  <Body>
   Blogging is more fun through REST
  </Body>
  <Date>2007-12-11T13:01:50.01</Date>
  <Url>http://localhost/cs/blogs/sample_weblog/[...].aspx</Url>
  <Keywords>
    <Keyword>Blogging</Keyword>
  </Keywords>
  <Summary />
  <Comments 
   Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2/comments/"/>
  <Ratings 
    Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2/ratings/"/>
  <Referrals 
    Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2/referrals/"/>
  <Trackbacks 
    Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2/trackbacks/"/>
  <ViewCount>0</ViewCount>
  <IsPublished>true</IsPublished>
  <BlogInfo Id="4" Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4" />
  <Settings>
    <EnableComments>false</EnableComments>
    <PublishOnBlogHomePage>true</PublishOnBlogHomePage>
    <PublishOnSiteHomePage>true</PublishOnSiteHomePage>
    <SyndicateSummary>false</SyndicateSummary>
    <EnableRatings>true</EnableRatings>
    <EnableTrackbacks>true</EnableTrackbacks>
    <FeedbackNotification>DoNotEmailFeedback</FeedbackNotification>
    <CommentApproval>DoNotRequireApprovalForAnyComments</CommentApproval>
  </Settings>
  <UserInfo Id="2100" 
    Endpoint="http://localhost/cs/api/membership.ashx/users/2100" />
</BlogPost>

Comment

<Comment Id="7"
  Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2/comments/7">
  <Title>re: Welcome to Community Server Blogs!</Title>
  <Body>
    The unit test framework requires the sample post to have a comment,
    there wasnt one, so this was created.
  </Body>
  <Date>2008-01-15T06:04:18.567</Date>
  <IsPublished>true</IsPublished>
  <BlogInfo Id="4" Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4"/>
  <PostInfo Id="2" Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2"/>
  <AuthorInfo Id="2100"
    Endpoint="http://localhost/cs/api/membership.ashx/users/2100" IsOwner="false">
    <Time>2008-01-15T06:04:18.567</Time>
    <HostAddress>000.000.000.000</HostAddress>
    <Name>admin</Name>
  </AuthorInfo>
</Comment>

Trackback

<Trackback Id="27" 
  Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2/trackbacks/27">
  <Title>http://localhost/cs</Title>
  <Body/>
  <Date>2008-01-15T07:35:29.44</Date>
  <Url>http://localhost/cs/blogs/sample_weblog/archive/2008/01/15/27.aspx</Url>
  <Summary/>
  <IsPublished>true</IsPublished>
  <BlogInfo Id="4" 
    Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4"/>
  <UserInfo Id="2100" 
    Endpoint="http://localhost/cs/api/membership.ashx/users/2100"/>
  <PostInfo Id="2" 
    Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2"/>
</Trackback>

Referral

<Referral Id="1000" 
  Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2/referrals/1000">
  <Title>Welcome to Community Server Blogs!</Title>
  <Url>http://localhost/</Url>
  <Hits>1</Hits>
  <LastDate>2008-01-15T07:39:19.803</LastDate>
  <PostInfo Id="2" 
    Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/posts/2"/>
</Referral>

Rating

<Rating ItemId="2" UserId="2100" 
  UserUrl="http://localhost/cs/api/membership.ashx/users/2100" 
  Value="5" OldValue="0"/>

Member

<Member Id="2100" 
  Endpoint="http://localhost/cs/api/blogs.ashx/blogs/4/members/2100" 
  Type="Owner" DateAdded="2008-01-15T08:14:42.477"/>

Permission

<BlogPermission Id="3108c739-2bf5-4e15-b12a-09dc1a321694" Name="Everyone" 
  Implied="true" 
  Endpoint="http://localhost/cs/api/blogs.ashx/blogs/permissions/everyone">
  <Read>false</Read>
  <Write>false</Write>
  <Comment>false</Comment>
  <Video>false</Video>
  <LocalAttachment>false</LocalAttachment>
  <RemoteAttachment>false</RemoteAttachment>
</BlogPermission>

Settings

<BlogSettings Endpoint="http://localhost/cs/api/blogs.ashx/settings">
  <Enabled>true</Enabled>
  <IsAggregatePublicOnly>true</IsAggregatePublicOnly>
  <IsLocked>false</IsLocked>
  <IsCached>true</IsCached>
  <FileOnly>false</FileOnly>
  <AllowNew>true</AllowNew>
  <Disabled>false</Disabled>
  <EnableThemes>true</EnableThemes>
  <NoFollow>true</NoFollow>
  <ThemeLocation>~/Themes/Blogs/</ThemeLocation>
  <EnableSkinCache>true</EnableSkinCache>
  <DefaultTheme>default</DefaultTheme>
  <BaseTheme>default</BaseTheme>
  <ScorePosts>false</ScorePosts>
  <PostsToScore>250</PostsToScore>
  <DateScoreFactor>2.5</DateScoreFactor>
  <RatingScoreFactor>0.75</RatingScoreFactor>
  <ViewScoreFactor>0.5</ViewScoreFactor>
  <CommentScoreFactor>0.75</CommentScoreFactor>
  <DefaultGroupId>-1</DefaultGroupId>
  <EnableAutoCreate>false</EnableAutoCreate>
  <AuthenticateOnSectionNotFound>false</AuthenticateOnSectionNotFound>
  <AttachmentTypes>
    zip,xml,txt,gif,jpg,jpeg,png,doc,xls,mp3,mmv
  </AttachmentTypes>
  <AggregatePostSize>250</AggregatePostSize>
  <CreateBlogDirectories>true</CreateBlogDirectories>
  <ServicePostCountLimit>25</ServicePostCountLimit>
  <AggregatePostCount>25</AggregatePostCount>
  <IndividualPostCount>15</IndividualPostCount>
  <EnableRss>true</EnableRss>
  <EnableAtom>true</EnableAtom>
  <DefaultPingServices>
    <string>http://rpc.weblogs.com/RPC2</string>
    <string>http://rpc.technorati.com/rpc/ping</string>
    <string>http://rpc.pingomatic.com</string>
  </DefaultPingServices>
  <EnableCrossPosting>false</EnableCrossPosting>
  <RssCacheWindowInSeconds>90</RssCacheWindowInSeconds>
  <DefaultAggregateTags/>
  <EnableRawHeadEditing>false</EnableRawHeadEditing>
  <DisableSecurityFilter>false</DisableSecurityFilter>
  <EnableBlogFileStorage>true</EnableBlogFileStorage>
  <BlogFilesQuota>0</BlogFilesQuota>
  <BlogFilesMaxSize>4096</BlogFilesMaxSize>
  <BlogFileStorageHiddenFiles>default.aspx</BlogFileStorageHiddenFiles>
  <BlogFileStorageExtensions>
    zip,gif,jpg,jpeg,png,bmp,txt,xml
  </BlogFileStorageExtensions>
  <EnableBlogEmailSubscriptions>true</EnableBlogEmailSubscriptions>
  <BlogEmailSubscriptionTimeFrequency>
    1440
  </BlogEmailSubscriptionTimeFrequency>
  <RollerEnabled>true</RollerEnabled>
</BlogSettings>

Query Reference

Query properties are key value pairs separated by a semicolon. Arrays should be formatted as comma separated strings.

Blog Query

Property	Type	Description
Ids	int[]	The Blog Ids you wish to include in your search
Keys	string[]	The Blog Keys you wish to include in your search
GroupIds	int[]	The BlogGroup Ids you wish to include in your search
IsActive	bool	Include only Active Blogs (only blog administrators can see inactive blogs)
PageSize	int	(defaults to 20)
PageIndex	int	(defaults to 0)
AccessLevel	string	(Defaults to "View") type of Permission Post, Edit, Reply, View, Video, LocalAttachment, RemoteAttachment
Name	string	The name of the blog
Owner	string	The username of a blog owner to filter by
SortBy	string	Criteria to sort the blogs by Name, Thread, Post, LastPost
SortOrder	string	Ascending / Descending

Blog Post Query

Property	Type	Description
Ids	int[]	The Post Ids you wish to include in your search
GroupIds	int[]	The BlogGroup Ids you wish to include in your search
IsActive	bool	Include only Published or Unpublished Posts
PageSize	int	(defaults to 20)
PageIndex	int	(defaults to 0)
Keywords	string[]	The keywords you want to find related posts for
BlogIds	int[]	The Ids of the Blogs you want to include in your search
Date	string	A date to filter based on
ThreadType	int	If Date is present, specifies the criteria to filter posts by Recent, Year, Month, Day, Category, Tags, Scored (defaults to Recent)
SortBy	string	Criteria to sort the posts by MostRecent, MostViewed, MostComments (defaults to MostRecent)
SortOrder	string	Ascending / Descending

Blog Comment Query

Property	Type	Description
Ids	int[]	The Comment Ids you wish to include in your search
GroupIds	int[]	The BlogGroup Ids you wish to include in your search
BlogIds	int[]	The Ids of the Blogs you want to include in your search
PostId	int	The Parent Blog Post Id to find related Comments for
IsActive	bool	Include only Published or Unpublished Comments
PageSize	int	(defaults to 20)
PageIndex	int	(defaults to 0)
Date	string	A date to filter based on
ThreadType	int	If Date is present, specifies the criteria to filter posts by Recent, Year, Month, Day, Category, Tags, Scored (defaults to Recent)
SortBy	string	Criteria to sort the posts by MostRecent, MostViewed, MostComments (defaults to MostRecent)
SortOrder	string	Ascending / Descending

Blog Trackback Query

Property	Type	Description
Ids	Int[]	The Trackback Ids you wish to include in your search
GroupIds	Int[]	The BlogGroup Ids you wish to include in your search
BlogIds	int[]	The Ids of the Blogs you want to include in your search
PostId	Int	The Parent Blog Post Id to find related Trackbacks for
IsActive	bool	Include only Pubished or Unpubished Trackbacks
PageSize	int	(defaults to 20)
PageIndex	int	(defaults to 0)
Date	string	A date to filter based on
ThreadType	int	If Date is present, specifies the criteria to filter posts by Recent, Year, Month, Day, Category, Tags, Scored (defaults to Recent)
SortBy	string	Criteria to sort the posts by MostRecent, MostViewed, MostComments (defaults to MostRecent)
SortOrder	string	Ascending / Descending

Community Server API

Topics

Blogs

Blog Groups

Response

Response

Create Blog Groups

Request

Response

Update Blog Groups

Request

Response

Delete Blog Groups

Response

Blogs

Response

Response

Response

Response

Create Blog

Response

Response

Update Blog

Request

Response

Delete Blog

Response

BlogPosts

Response

Response

Response

Create Post

Request

Response

Update Post

Request

Response

Delete Post

Response

Comments

Response

Response

Response

Create Comment

Request

Response

Update Comment

Request

Response

Delete Comment

Response

Trackbacks

Response

Response

Response

Delete Trackback

Response

Ratings

Response

Response

Create Rating

Request

Response

Update Rating

Request

Response

Attachments

Response

Create Attachment

Request

Response

Update Attachment

Request

Response

Response

Referrals

Response

Response

Response

Members (Owners)