GET /me

Get current user profile information. Requires authentication.

GET /me/stream

Get current user's home stream. Requires authentication.

Parameters:
since_id optional

returns entries with an ID greater than (that is, more recent than) the specified ID.

max_id optional

returns entries with an ID less than (that is, older than) or equal to the specified ID.

limit optional default: 10

ends limit.

POST /me/update

Update current user profile. Requires authentication.

Parameters:
full_name optional

new user full name

sex optional

user sex/gender, accepted: (male,female)

birth_date optional

your birth date, in dd/MM/yyyy format

location optional

your location

locale optional default: en-US

user locale

self_description optional

describe yourself in maximum 5 words

photo optional

picture of user photo profile, accepted: image file

banner optional

banner of user , accepted: image file.

GET /me/connect

Get list of user's connected apps. Requires authentication.

GET /me/channels

Getting current user channels where current user owned or joined. Requires authentication.

Parameters:
state optional default: all

filter by state, supported state:

  • owner -- return only owned channel list

  • staff -- return only channels where current user is staff at

  • joined -- return only joined channels

  • all -- return all channels includes owned, staff, and joined

simple optional default: false

returns simple mode for autocomplete purpose

with_private optional default: false

Include private channels in return

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/may_know

Get user recommendation. Requires authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/dialogues

Getting current user dialogue list. Requires authentication.

Parameters:
state required

state of the notification, accepted value: read, unread, all

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/supporters

For getting list of current user supporters. Requires authentication.

Parameters:
simple optional default: false

Returns simple mode for autocomplete purpose

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/supporting

For getting list of current user supporting. Requires authentication.

Parameters:
simple optional default: false

Returns simple mode for autocomplete purpose

filter optional

search query on name or fullname

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /me/supporting

For supporting another user. Requires authentication.

Parameters:
name optional

user name target to support, required when no id parameter is set, OR

id optional

user id target to support, required when no name parameter is set

POST /me/deactivate

Deactivate user account. Requires authentication.

Parameters:
password required

password for your account

reason required

reason to deactivate

POST /me/joins/create

For joining to channel. Requires authentication.

Parameters:
ids optional

channel's ID, separated by comma, required if no names parameter was set

names optional

channel's name, separated by comma, required if no ids parameter was set

GET /me/blocked_users

Get list blocked user of current user. Requires authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/notifications

Getting current user notification list. Requires authentication.

Parameters:
state required

state of the notification, accepted value: read, unread, all

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/mutual_support

For getting list of current user mutual support. User who support current user and supported by current user. Requires authentication.

Parameters:
simple optional default: false

Returns simple mode for autocomplete purpose

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /me/connect/create

Register a user to an app. Requires authentication.

Parameters:
provider required

can be google, blackberry, apple, or microsoft

app_token required

token from provider

POST /me/connect/remove

Disconnect/revoke an app from user. Requires authentication.

Parameters:
provider required

can be google, blackberry, apple, or microsoft

app_token required

token from provider F

POST /me/dialogues/update

Mark as read dialogues list. Requires authentication.

Parameters:
ids optional

IDs of the dialogue to mark as read. separated by comma, or 'all' for mark all as read

POST /me/subsribe/{POST-ID}

Re-subscribe and get a notification for a post. User who can use this, only user who have receive notification before (creator and responder) and has unsubsribe first. Requires authentication.

Symbols:
POST-IDID of post

POST /me/resend_verification

Resend verification code. Requires authentication.

GET /me/bookmarked_channels

Get list of current user bookmarked channels. Requires authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /me/blocked_users/create

Add user to blocked list (block user). Requires authentication.

Parameters:
id required

ID of user to block (required when no name parameter specified)

name required

name of user to block (required when no id parameter specified)

POST /me/unsubsribe/{POST-ID}

Unsubscribe and leave notification for a post. User who can use this, only user who have receive notification before (creator and responder) and has unsubsribe first. Requires authentication.

Symbols:
POST-IDID of post

GET /me/recommended_channels

Get list of recommended channels to be joined by current user. Requires authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /me/notifications/update

Mark as read notification list. Requires authentication.

Parameters:
ids optional

IDs of the notification to mark as read. separated by comma..

GET /me/pending_notifications

Getting current user pending notification list. Requires authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/whisper_notifications

Getting current user list of whisper notification. Requires authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /me/unread_notification_count

Get unread notification count. Requires authentication.

POST /me/pending_notifications/update

Do accept or reject an attention notification. Requires authentication.

Parameters:
id required

ID of the notification to accept/reject (single value, doesn't accept multiple id)

approval required

accept/reject the notification, valid value: accept, reject

POST /me/whisper_notifications/update

Mark as read whisper_notification list. Requires authentication.

Parameters:
ids optional

IDs of the notification to mark as read, separated by comma

POST /me/joins/{CHANNEL-ID-OR-NAME}/remove

For leaving from a channel's membership. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
id optional

channel's ID, required if no name parameter was set.

name optional

channel's name, required if no id parameter was set.

POST /me/may_know/{USER-ID-OR-NAME}/remove

Ignore user recommendation. Requires authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name

POST /me/supporting/{USER-ID-OR-NAME}/remove

Unsupport user. Requires authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name

POST /me/blocked_users/{USER-ID-OR-NAME}/remove

Remove user from current user blocked list (unblock user). Requires authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name

POST /me/bookmarked_channels/{CHANNEL-ID-OR-NAME}/create

Bookmark a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name

POST /me/bookmarked_channels/{CHANNEL-ID-OR-NAME}/remove

Remove channel from bookmarked list. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name

GET /shorten/get

Get long url. With or without authentication.

Parameters:
short_url required

short url to be lengthened

POST /shorten/create

Shorten a url. With or without authentication.

Parameters:
long_url required

long url to be shortened

short_url required

for custom short url

POST /channel/update

Edit channel info. Requires authentication.

Parameters:
desc required

channel's description

tags required

channel's tags, separated by commas. eg: "motor, sport"

category required

channel's category, received from GET misc/interests endpoint

announcement_text required

channel's announcement. eg: "Here's some announcement!"

announcement_active required

channel's announcement active boolean. valid value: true or false

logo optional

picture of logo, accepted: image file

banner optional

picture of banner, accepted: image file with size

POST /channel/create

Create new channel. Requires authentication.

Parameters:
name required

channel's name

desc required

channel's description

tags required

channel's tags, separated by commas. eg: "motor, sport"

category required

channel's category name, received from GET misc/interests endpoint

logo optional

picture of logo, accepted: image file (jpg, png, jpeg)

private_state optional default: off

set channel to public or private, valid value: off for public, on for private channel

who_can_post optional default: staff, member

who can post on the channel, valid value: staff, member, registered

visibility optional

where the channel will appear on, valid value:

search (channel will appear on search result), list (channel will appear on channel list)

who_can_invite optional default: staff, member

who can invite other member to the channel, valid value: staff, member, registered

GET /channels/newest

Get latest/newest created channel. With or without authentication.

Parameters:
since_id optional

returns channels with an ID greater than the specified ID

max_id optional

returns channels with an ID less than or equal to the specified ID

limit optional default: 10

ends limit

GET /channels/similar

Get similar channel based on other channel. With or without authentication.

Parameters:
channel_ref_id required

id of referenced channel

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channels/popular

Get list of popular channels. With or without authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channels/promoted

Get list of promoted channels. With or without authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channels/endorsement

Get list of channel endorsement label.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channels/move-to-list

Get list of channel whom user can do a move to. Requires authentication.

Parameters:
post_id optional

post id of the post that will be moved

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channels/retalk-to-list

Get list of channel whom user can do a retalk to. Requires authentication.

Parameters:
post_id optional

post id of the post that will be retalked

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channels/group/{GROUP-NAME}

Get list of channels in {GROUP-NAME}. With or without authentication.

Symbols:
GROUP-NAMEName of group
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}

Getting channel information. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name

GET /channels/popular/endorsement

Get list of popular channel endorsement (tag).

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channels/tag/{ENDORSEMENT-LABEL}

Get list of channels on an endorsement label.

Symbols:
ENDORSEMENT-LABELLabel of endorsement
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/staff

Getting channel staff. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /channel/{CHANNEL-ID-OR-NAME}/remove

Remove a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
reason required

why remove the channel

GET /channel/{CHANNEL-ID-OR-NAME}/stream

For getting stream from channel. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
sticky optional default: all

posible value: all, sticky & unsticky

since_id optional

returns entries with an ID greater than (that is, more recent than) the specified ID

max_id optional

returns entries with an ID less than (that is, older than) or equal to the specified ID

limit optional default: 10

ends limit

POST /channel/{CHANNEL-ID-OR-NAME}/invite

Invite other user (supporter) to join this channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
ids optional

user's ID, separated by comma, required if no names parameter set

names optional

username, separated by comma, required if no ids parameter set

GET /channel/{CHANNEL-ID-OR-NAME}/invite

Get list of invited user. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/albums

Get list of album in channel. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/members

Get channel members. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/pictures

For getting photo/picture stream from channel. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
sticky optional default: all

posible value: all, sticky & unsticky

since_id optional

returns entries with an ID greater than (that is, more recent than) the specified ID

max_id optional

returns entries with an ID less than (that is, older than) or equal to the specified ID

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/articles

For getting articles stream from channel. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
sticky optional default: all

posible value: all, sticky & unsticky

since_id optional

returns entries with an ID greater than (that is, more recent than) the specified ID

max_id optional

returns entries with an ID less than (that is, older than) or equal to the specified ID

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/settings

Get settings information of a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name

GET /channel/{CHANNEL-ID-OR-NAME}/post_marks

Get channel's post marks list. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/simple_posts

For getting simple post stream from channel. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
sticky optional default: all

posible value: all, sticky & unsticky

since_id optional

returns entries with an ID greater than (that is, more recent than) the specified ID

max_id optional

returns entries with an ID less than (that is, older than) or equal to the specified ID

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/active_users

Get active users from specific channels.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name

POST /channel/{CHANNEL-ID-OR-NAME}/staff/create

Add staff to a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
staff_id required

user id of the user that will be added as staff

title required

title of the staff

ability required

ability of the staff, separated by comma, currently support general-setting-channel, edit-post, delete-post

POST /channel/{CHANNEL-ID-OR-NAME}/staff/remove

Remove staff from a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
staff_id required

user id of the user that will be added as staff

POST /channel/{CHANNEL-ID-OR-NAME}/album/create

Create an album in a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
name required

album name

desc required

album description

tags required

album tags

GET /channel/{CHANNEL-ID-OR-NAME}/active_photos

Get active photos from specific channels.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name

POST /channel/{CHANNEL-ID-OR-NAME}/settings/update

Update settings of a channel. Some setting (such as System setting) are not implemented here. Reqiures authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
Parameters:
private_state optional

string on or off

hashtagable_state optional

string on or off

retalkable_state optional

string on or off

who_can_post optional default: staff, member

who can post on the channel, valid value: staff, member, registered, owner_only

who_can_response optional default: staff, member

who can response on the channel, valid value: staff, member, registered, owner_only

visibility optional

where the channel will appear on, valid value:

search (channel will appear on search result), list (channel will appear on channel list)

who_can_invite optional default: staff, member

who can invite other member to the channel, valid value: staff, member, registered

GET /channel/{CHANNEL-ID-OR-NAME}/album/{ALBUM-ID}

Get list of photo in album . With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
ALBUM-IDID of album
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /channel/{CHANNEL-ID-OR-NAME}/albums/{ALBUM-ID}

Deprecated endpoint, please use /channel/{CHANNEL-ID-OR-NAME}/album/{ALBUM-ID} Get list of photo in album. With or without authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
ALBUM-IDID of album
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /channel/{CHANNEL-ID-OR-NAME}/album/{ALBUM-ID}/update

Update album information in a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
ALBUM-IDID of album
Parameters:
name required

album name

desc required

album description

POST /channel/{CHANNEL-ID-OR-NAME}/album/{ALBUM-ID}/remove

Delete an album in a channel. Requires authentication.

Symbols:
CHANNEL-ID-OR-NAMECan be channel ID or channel name
ALBUM-IDID of album

POST /xauth

Login user with xauth. Can only be used by verified app with xauth permission. See: http://developer.mindtalk.com/auth/xauth/

Parameters:
client_id required

application id

client_secret required

application secret

user_name required

user name for login

user_password required

password for login

POST /auth_twitter

Login with Twitter account.

Parameters:
client_id required

application id

client_secret required

application secret

twitter_oauth_token required

Twitter oauth token

twitter_oauth_token_secret required

Twitter oauth token secret

POST /auth_mobile_reg

Login with mobile reg id.

Parameters:
client_id required

application id

client_secret required

application secret

mobile_reg_id optional

registration id for connecting account to other social media

example value: ABnyAK7gAuRyXdF2yxaEEfy8IDezkfx4347435019A54dsPtLZqwCx1ljO.RmxEv2Mdgcj434743502usV.cw3RO.uRuFYpQAm4.gbqdm9Idsq434743503

GET /search/user

Search user by query q. With or without authentication.

Parameters:
q required

search query.

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /search/channel

Search channel. With or without authentication.

Parameters:
q required

search term query

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /search/articles

Search article by query q. With or without authentication.

Parameters:
q required

search query.

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /misc/tips

Get tips in using Mindtalk. Requires authentication.

GET /misc/interests

Get list of interests.

Parameters:
since_id optional

returns entries with an ID greater than (that is, more recent than) the specified ID

max_id optional

returns entries with an ID less than (that is, older than) or equal to the specified ID

limit optional default: 30

ends limit.

GET /user/tips/{TIPS-ID}

Get specific tips with id {TIPS-ID}. Requires authentication.

Symbols:
TIPS-IDID of tips

GET /misc/emoticon/get_list

Get list of available emoticon.

GET /misc/support_suggestions

Get list of user who have same interest with you.

Parameters:
interest_ids required

list of interest ids, separated by comma

offset optional default: 0

offset

limit optional default: 10

ends limit

GET /misc/channel_suggestions

Get list of channel that have same interest with you.

Parameters:
interest_ids required

list of interest ids, separated by comma

limit optional default: 10

ends limit

POST /video

You can share a video content with this endpoint. Requires authentication.

Parameters:
video_url required

link of the video you want to share.

content required

description or short explanation of the video.

origin_id required

id of the channel target.

shares optional

share to Twitter and/or Facebook, separated by comma. example: twitter, facebook

POST /picture

Share picture. Picture can only be shared on a channel, if album_id is provided, than picture will be posted under that album, if not provided, picture will be posted under default album on that channel, the default album is "General". Requires authentication.

Parameters:
title required

title of the picture post.

origin_id required

channel id where this picture will be posted

content required

picture to share, accepted: image file (content-type: image) or url of picture to share, started with http://

album_id optional

id of the album where this picture will be posted

shares optional

share to Twitter and/or Facebook, separated by comma. example: twitter, facebook

POST /article

Share an article. Requires authentication.

Parameters:
content required

text to share, can be plain text

title required

title of the article

origin_id required

id of the channel target

tags optional

tags of the article

post_marks optional

marks of the article

shares optional

share to Twitter and/or Facebook, separated by comma. example: twitter, facebook

POST /pictures

Share group picture. Picture can only be shared on a channel, if album_id is provided, than picture will be posted under that album, if not provided, picture will be posted under default album on that channel. The returned json value will be only in dummy format, NOT the real image you uploaded, images are proceed in parallel. You will need to use your local image and display it to user. Requires authentication.

Parameters:
title required

title of the picture post.

origin_id required

channel id where this picture will be posted

pic1 required

picture to share, accepted: image file (content-type: image) or link of an image (started with http://).

pic2 required

picture to share, accepted: image file (content-type: image) or link of an image (started with http://).

album_id optional

id of the album where this picture will be posted.

pic3 optional

picture to share, accepted: image file (content-type: image) or link of an image (started with http://).

pic4 optional

picture to share, accepted: image file (content-type: image) or link of an image (started with http://).

pic5 optional

picture to share, accepted: image file (content-type: image) or link of an image (started with http://).

shares optional

share to Twitter and/or Facebook, separated by comma. example: twitter, facebook

POST /simple_post

Share a simple post. You can share a simple content with this endpoint with a maximum length of 160. Requires authentication.

Parameters:
content required

text to share, can be plain text

origin_id required

id of the channel target

shares optional

share to Twitter and/or Facebook, separated by comma. example: twitter, facebook

POST /move/{POST-ID}

Move content (simple post, article, picture, picture group, and video) to other channel. Requires authentication.

Symbols:
POST-IDID of post
Parameters:
to_channel required

channel where the post will be published (target channel)

type required

hard/soft

role required

channelstaff/systemstaff

GET /post/{POST-ID}

Get single post data. With or without authentication.

Symbols:
POST-IDID of post

POST /sticky/{POST-ID}

Set a post to be sticky. Requires authentication.

Symbols:
POST-IDID of post

GET /post/popular/texts

Get list of popular text. With or without authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /post/popular/video

Get list of popular video, With or without authentication.

POST /post/general_upload

Upload picture for general usage such as: using pic in an article. Requires authentication.

Parameters:
pic required

picture to upload

GET /post/popular/photos

Get list of popular photo. With or without authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /post/{POST-ID}/open

Get post open-close state. With or without authentication.

Symbols:
POST-IDID of post

POST /post/{POST-ID}/open

Update post open-close state. Requires authentication.

Symbols:
POST-IDID of post
Parameters:
state required

open or close state, can be string "true" or "false".

reason optional

reason for closing this post, necessary if state set to "false"

POST /post/{POST-ID}/hide

Hide post from all stream. Requires authentication.

Symbols:
POST-IDID of post

POST /post/{POST-ID}/cools

Add cool to post. Requires authentication.

Symbols:
POST-IDID of post

GET /post/{POST-ID}/cools

Get cool list from post. With or without authentication.

Symbols:
POST-IDID of post
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /post/{POST-ID}/update

Update existing article data. Only post with type article can be edited. Simple post cannot be edited. Requires authentication.

Symbols:
POST-IDID of post
Parameters:
title required

new article title

content required

new article content

tags optional

new article tags, separated by commas

edit_reason optional

the reason why edit this article

POST /post/{POST-ID}/remove

Delete a post or an article and all its responses. Creator of the article and channel owner can delete this article. Requires authentication.

Symbols:
POST-IDID of post
Parameters:
delete_type optional

delete type, can be hard or soft.

reason optional

reason of deleting, required if not owner post.

GET /article/recommendation

Get list of article recommendation. Support both anonymous or authorized mode. In authorized mode return will more relevance to the user.

Parameters:
article_ref_id optional

article id as reference, if set then return

articles related to that article

tags optional

tags words separated by comma, if set then return

article related to the tags

POST /retalk/{POST-ID}/create

Retalk content (simple post, article, picture, picture group, and video) to other channel. Requires authentication.

Symbols:
POST-IDID of post
Parameters:
to_channel required

channel where the retalk will be published (target channel)

POST /sticky/{POST-ID}/remove

Remove a post from sticky. Requires authentication.

Symbols:
POST-IDID of post

GET /post/{POST-ID}/responses

Get post responses. With or without authentication.

Symbols:
POST-IDID of post
Parameters:
sort optional default: asc

possible value: asc & desc. Set to desc to reverse the output from newest to oldest

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /picture/{POST-ID}/update

Add a description on a shared picture. Requires authentication.

Symbols:
POST-IDID of post
Parameters:
description required

description of the picture post

GET /post/response/{RESPONSE-ID}

Get post detail by it's response id. Requires authentication.

Symbols:
RESPONSE-IDID of response

POST /post/{POST-ID}/cools/remove

Remove cool from post. Requires authentication.

Symbols:
POST-IDID of post

POST /post/{POST-ID}/responses/create

Create new response for a post. Requires authentication.

Symbols:
POST-IDID of post
Parameters:
content required

message to be sent

POST /post/{POST-ID}/responses/{RESPONSE-ID}/cools

Make cool to response. Requires authentication.

Symbols:
POST-IDID of post
RESPONSE-IDID of response

GET /post/{POST-ID}/responses/{RESPONSE-ID}/cools

Get cool list in response. With or without authentication.

Symbols:
POST-IDID of post
RESPONSE-IDID of response
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /post/{POST-ID}/responses/{RESPONSE-ID}/update

Update existing responses. Requires authentication.

Symbols:
POST-IDID of post
RESPONSE-IDID of response
Parameters:
content required

response to be edited

edit_reason required

the reason why edit this response

POST /post/{POST-ID}/responses/{RESPONSE-ID}/remove

Delete existing responses. Requires authentication.

Symbols:
POST-IDID of post
RESPONSE-IDID of response
Parameters:
role required

possible value: creator, channelstaff, systemstaff

type required

hard/soft - if role parameter is creator, use soft, if you're in dount use soft

reason required

empty if role is creator, mandatory if role is either channelstaff or systemstaff

POST /post/{POST-ID}/responses/{RESPONSE-ID}/report

Report a response. Requires authentication.

Symbols:
POST-IDID of post
RESPONSE-IDID of response
Parameters:
reason required

reason why report this response

POST /post/{POST-ID}/responses/{RESPONSE-ID}/cools/remove

Make uncool to response. Requires authentication.

Symbols:
POST-IDID of post
RESPONSE-IDID of response

GET /oauth/get_user_info

Get account information of user connected to third party account with mobileregid. With or without authentication.

Parameters:
mobile_reg_id required

registration id for connecting account to other social media

example value: ABnyAK7gAuRyXdF2yxaEEfy8IDezkfx4347435019A54dsPtLZqwCx1ljO.RmxEv2Mdgcj434743502usV.cw3RO.uRuFYpQAm4.gbqdm9Idsq434743503

GET /user/{USER-ID-OR-NAME}

Get user profile information. With or without authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name

POST /user/connect/mobile_reg_id

Connect user to third party account with mobileregid. Requires authentication.

Parameters:
mobile_reg_id required

registration id for connecting account to other social media

example value: ABnyAK7gAuRyXdF2yxaEEfy8IDezkfx4347435019A54dsPtLZqwCx1ljO.RmxEv2Mdgcj434743502usV.cw3RO.uRuFYpQAm4.gbqdm9Idsq434743503

GET /user/{USER-ID-OR-NAME}/stream

Get user's profile stream. With or without authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name
Parameters:
since_id optional

returns entries with an ID greater than (that is, more recent than) the specified ID

max_id optional

returns entries with an ID less than (that is, older than) or equal to the specified ID

limit optional default: 10

ends limit

GET /user/{USER-ID-OR-NAME}/channels

Get user joined channels. With or without authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /user/{USER-ID-OR-NAME}/supporters

Get user's supporters. You will get list of people who supporting this user. With or without authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /user/{USER-ID-OR-NAME}/supporting

Get user's supporting. You will get list of people who supported by this user. With or without authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /user/{USER-ID-OR-NAME}/photo_profile

Get user's photo profiles. Requires authentication.

Symbols:
USER-ID-OR-NAMECan be user ID or user name
Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

GET /whisper

Get current user inbox message list. Requires authentication.

Parameters:
offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /whisper/create

Send whisper to other users. Requires authentication.

Parameters:
subject required

whisper's subject.

message required

whisper's message.

to required

target user names separated by commas

GET /whisper/{WHISPER-ID}

Get single whisper data. Requires authentication.

Symbols:
WHISPER-IDID of whisper

POST /whisper/{WHISPER-ID}/leave

Leave a whisper conversation. Requires authentication.

Symbols:
WHISPER-IDID of whisper
Parameters:
reason required

reason why you leave the conversation, min 3 chars and max 100 chars.

POST /whisper/{WHISPER-ID}/remove

Delete whisper message. This will also delete all replies inside/connected to the message, and also message will disappear from other participants. Only creator/initiator can delete whisper message. Requires authentication.

Symbols:
WHISPER-IDID of whisper

GET /whisper/{WHISPER-ID}/replies

Get whisper replies. Requires authentication.

Symbols:
WHISPER-IDID of whisper
Parameters:
sort optional default: asc

possible value: asc & desc. Set to desc to reverse the output from newest to oldest

offset optional default: 0

starting offset.

limit optional default: 10

ends limit

POST /whisper/{WHISPER-ID}/replies/create

Post a whisper reply. Requires authentication.

Symbols:
WHISPER-IDID of whisper
Parameters:
content required

replies to be sent

GET /whisper/{WHISPER-ID}/replies/{REPLY-ID}

Get single data for whisper reply. Requires authentication.

Symbols:
WHISPER-IDID of whisper
REPLY-IDID of whisper's reply

POST /whisper/{WHISPER-ID}/replies/{REPLY-ID}/remove

Delete whisper response/reply. Only response/reply creator can delete. Requires authentication.

Symbols:
WHISPER-IDID of whisper
REPLY-IDID of whisper's reply