Blellow Developer's Wiki
Individual Statuses

You can access an individual status message or it’s replies using these functions. You can get the a messages url or message id out of one of the Message Feeds and access it to show or delete.

Currently the API does not support adding or removing favorites by API call, nor marking messages as spam.

show

Shows a single message.

URL: http://api.blellow.com/messages/{message id}.{format}

Formats: xml, json, rss

Method(s): GET

API limit: Not applicable

Returns: Status Element

Auth Required? : False

replies to a message

To see the replies to a message you do not need and must remove the username from the message url above

URL: http://api.blellow.com/messages/{message id}/view_descendants.{format}

Formats: xml, json, rss

Method(s): GET

API limit: Not applicable

Returns: list of Status Element

Auth Required? : False

delete

Delete the specific status id. Notice that you must have or insert the username into the message for delete. That may become optional in the future but is required at present.

URL: http://api.blellow.com/{username}/messages/{message id}.{format}

Formats: xml, json, rss

Method(s): DELETE

API limit: Not applicable

Returns: notice on success, error on failure.

Auth Required? : True

new

Set a new status message. @{username} and %{group name} may be included without restriction

URL: http://api.blellow.com/{posting username}/messages.{format}

Parameters: message[body] - (the status message text)

• (optional) message[selected_for_kudoable] - set to true to allow kudos

• (optional) message[parent_node_id] - the message id of the message that this is a reply to. ”We will be revising this in the near future”

• (optional) message[new_media_file_attributes][][uploaded_data] - upload one or more files. ”This should get a shorter name in a future revision, the old name will continue to work.”

• ”Optionally you may use “status” in place of message[body], if both are provided message[body] has priority.”

Formats: xml, json, rss

Method(s): POST

API limit: Not applicable

Returns: Status Element

Auth Required? : True