]> git.mxchange.org Git - friendica.git/blobdiff - doc/api.md
Fix TOC links href, no TOC in home
[friendica.git] / doc / api.md
index f36a79a5eb3712629156681ee28aca0a2f09a2af..48b4f6e63c4e1c402d0519f03940faef4a5b8283 100644 (file)
@@ -1,4 +1,6 @@
-The friendica API aims to be compatible to the [StatusNet API](http://status.net/wiki/Twitter-compatible_API) which aims to be compatible to the [Twitter API 1.0](https://dev.twitter.com/docs/api/1). \r
+Friendica API\r
+===\r
+The Friendica API aims to be compatible to the [GNU Social API](http://skilledtests.com/wiki/Twitter-compatible_API) and the [Twitter API](https://dev.twitter.com/rest/public).\r
 \r
 Please refer to the linked documentation for further information.\r
 \r
@@ -6,13 +8,13 @@ Please refer to the linked documentation for further information.
 \r
 ### General\r
 #### Unsupported parameters\r
-* cursor: Not implemented in StatusNet\r
-* trim_user: Not implemented in StatusNet\r
-* contributor_details: Not implemented in StatusNet\r
-* place_id: Not implemented in StatusNet\r
-* display_coordinates: Not implemented in StatusNet\r
+* cursor: Not implemented in GNU Social\r
+* trim_user: Not implemented in GNU Social\r
+* contributor_details: Not implemented in GNU Social\r
+* place_id: Not implemented in GNU Social\r
+* display_coordinates: Not implemented in GNU Social\r
 * include_rts: To-Do\r
-* include_my_retweet: Retweets in friendica are implemented in a different way\r
+* include_my_retweet: Retweets in Friendica are implemented in a different way\r
 \r
 #### Different behaviour\r
 * screen_name: The nick name in friendica is only unique in each network but not for all networks. The users are searched in the following priority: Friendica, StatusNet/GNU Social, Diaspora, pump.io, Twitter. If no contact was found by this way, then the first contact is taken.\r
@@ -22,177 +24,402 @@ Please refer to the linked documentation for further information.
 * cid: Contact id of the user (important for "contact_allow" and "contact_deny")\r
 * network: network of the user\r
 \r
+#### Errors\r
+When an error occour in API call, an HTTP error code is returned, with an error message\r
+Usually:\r
+- 400 Bad Request: if parameter are missing or items can't be found\r
+- 403 Forbidden: if authenticated user is missing\r
+- 405 Method Not Allowed: if API was called with invalid method, eg. GET when API require POST\r
+- 501 Not Implemented: if requested API doesn't exists\r
+- 500 Internal Server Error: on other error contitions\r
+\r
+Error body is\r
+\r
+json:\r
+```\r
+       {\r
+         "error": "Specific error message",\r
+         "request": "API path requested",\r
+         "code": "HTTP error code"\r
+       }\r
+```\r
+\r
+xml:\r
+```\r
+       <status>\r
+               <error>Specific error message</error>\r
+               <request>API path requested</request>\r
+               <code>HTTP error code</code>\r
+       </status>\r
+```\r
+\r
+---\r
+### account/rate_limit_status\r
+\r
+---\r
 ### account/verify_credentials\r
 #### Parameters\r
 * skip_status: Don't show the "status" field. (Default: false)\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
-### statuses/update, statuses/update_with_media\r
+---\r
+### conversation/show\r
+Unofficial Twitter command. It shows all direct answers (excluding the original post) to a given id.\r
+\r
 #### Parameters\r
-* title: Title of the status\r
-* status: Status in text format\r
-* htmlstatus: Status in HTML format\r
-* in_reply_to_status_id\r
-* lat: latitude\r
-* long: longitude\r
-* media: image data\r
-* source: Application name\r
-* group_allow\r
-* contact_allow\r
-* group_deny\r
-* contact_deny\r
-* network\r
+* id: id of the post\r
+* count: Items per page (default: 20)\r
+* page: page number\r
+* since_id: minimal id\r
+* max_id: maximum id\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
+* include_rts\r
 * trim_user\r
-* place_id\r
-* display_coordinates\r
+* contributor_details\r
 \r
-### users/search\r
+---\r
+### direct_messages\r
 #### Parameters\r
-* q: name of the user \r
+* count: Items per page (default: 20)\r
+* page: page number\r
+* since_id: minimal id\r
+* max_id: maximum id\r
+* getText: Defines the format of the status field. Can be "html" or "plain"\r
+* include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* page\r
-* count\r
-* include_entities\r
+* skip_status\r
 \r
-### users/show\r
+---\r
+### direct_messages/all\r
 #### Parameters\r
-* user_id: id of the user \r
-* screen_name: screen name (for technical reasons, this value is not unique!)\r
-* include_entities: "true" shows entities for pictures and links (Default: false)\r
+* count: Items per page (default: 20)\r
+* page: page number\r
+* since_id: minimal id\r
+* max_id: maximum id\r
+* getText: Defines the format of the status field. Can be "html" or "plain"\r
 \r
-### statuses/home_timeline\r
+---\r
+### direct_messages/conversation\r
+Shows all direct messages of a conversation\r
 #### Parameters\r
 * count: Items per page (default: 20)\r
 * page: page number\r
 * since_id: minimal id\r
 * max_id: maximum id\r
-* exclude_replies: don't show replies (default: false)\r
-* conversation_id: Shows all statuses of a given conversation.\r
-* include_entities: "true" shows entities for pictures and links (Default: false)\r
+* getText: Defines the format of the status field. Can be "html" or "plain"\r
+* uri: URI of the conversation\r
 \r
-#### Unsupported parameters\r
-* include_rts \r
-* trim_user \r
-* contributor_details \r
+---\r
+### direct_messages/new\r
+#### Parameters\r
+* user_id: id of the user\r
+* screen_name: screen name (for technical reasons, this value is not unique!)\r
+* text: The message\r
+* replyto: ID of the replied direct message\r
+* title: Title of the direct message\r
 \r
-### statuses/friends_timeline\r
+---\r
+### direct_messages/sent\r
 #### Parameters\r
 * count: Items per page (default: 20)\r
 * page: page number\r
 * since_id: minimal id\r
 * max_id: maximum id\r
-* exclude_replies: don't show replies (default: false)\r
-* conversation_id: Shows all statuses of a given conversation.\r
+* getText: Defines the format of the status field. Can be "html" or "plain"\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
-#### Unsupported parameters\r
-* include_rts \r
-* trim_user \r
-* contributor_details \r
-\r
-### statuses/public_timeline\r
+---\r
+### favorites\r
 #### Parameters\r
 * count: Items per page (default: 20)\r
 * page: page number\r
 * since_id: minimal id\r
 * max_id: maximum id\r
-* exclude_replies: don't show replies (default: false)\r
-* conversation_id: Shows all statuses of a given conversation.\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* trim_user \r
+* user_id\r
+* screen_name\r
 \r
-### statuses/show\r
+Favorites aren't displayed to other users, so "user_id" and "screen_name". So setting this value will result in an empty array.\r
+\r
+---\r
+### favorites/create\r
 #### Parameters\r
-* id: message number\r
-* conversation: if set to "1" show all messages of the conversation with the given id\r
+* id\r
+* include_entities: "true" shows entities for pictures and links (Default: false)\r
+\r
+---\r
+### favorites/destroy\r
+#### Parameters\r
+* id\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
+---\r
+### followers/ids\r
+#### Parameters\r
+* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)\r
+\r
 #### Unsupported parameters\r
-* include_my_retweet \r
-* trim_user \r
+* user_id\r
+* screen_name\r
+* cursor\r
 \r
-### statuses/retweet\r
+Friendica doesn't allow showing followers of other users.\r
+\r
+---\r
+### friendica/activity/<verb>\r
+#### parameters\r
+* id: item id\r
+\r
+Add or remove an activity from an item.\r
+'verb' can be one of:\r
+- like\r
+- dislike\r
+- attendyes\r
+- attendno\r
+- attendmaybe\r
+\r
+To remove an activity, prepend the verb with "un", eg. "unlike" or "undislike"\r
+Attend verbs disable eachother: that means that if "attendyes" was added to an item,\r
+adding "attendno" remove previous "attendyes".\r
+Attend verbs should be used only with event-related items (there is no check at the moment)\r
+\r
+#### Return values\r
+\r
+On success:\r
+json\r
+```"ok"```\r
+\r
+xml\r
+```<ok>true</ok>```\r
+\r
+On error:\r
+HTTP 400 BadRequest\r
+\r
+---\r
+### friendica/photo\r
 #### Parameters\r
-* id: message number\r
-* include_entities: "true" shows entities for pictures and links (Default: false)\r
+* photo_id: Resource id of a photo.\r
+* scale: (optional) scale value of the photo\r
+\r
+Returns data of a picture with the given resource.\r
+If 'scale' isn't provided, returned data include full url to each scale of the photo.\r
+If 'scale' is set, returned data include image data base64 encoded.\r
+\r
+possibile scale value are:\r
+0: original or max size by server settings\r
+1: image with or height at <= 640\r
+2: image with or height at <= 320\r
+3: thumbnail 160x160\r
+\r
+4: Profile image at 175x175\r
+5: Profile image at 80x80\r
+6: Profile image at 48x48\r
+\r
+An image used as profile image has only scale 4-6, other images only 0-3\r
+\r
+#### Return values\r
+\r
+json\r
+```\r
+       {\r
+         "id": "photo id"\r
+         "created": "date(YYYY-MM-GG HH:MM:SS)",\r
+         "edited": "date(YYYY-MM-GG HH:MM:SS)",\r
+         "title": "photo title",\r
+         "desc": "photo description",\r
+         "album": "album name",\r
+         "filename": "original file name",\r
+         "type": "mime type",\r
+         "height": "number",\r
+         "width": "number",\r
+         "profile": "1 if is profile photo",\r
+         "link": {\r
+               "<scale>": "url to image"\r
+               ...\r
+         },\r
+         // if 'scale' is set\r
+         "datasize": "size in byte",\r
+         "data": "base64 encoded image data"\r
+       }\r
+```\r
+\r
+xml\r
+```\r
+       <photo>\r
+               <id>photo id</id>\r
+               <created>date(YYYY-MM-GG HH:MM:SS)</created>\r
+               <edited>date(YYYY-MM-GG HH:MM:SS)</edited>\r
+               <title>photo title</title>\r
+               <desc>photo description</desc>\r
+               <album>album name</album>\r
+               <filename>original file name</filename>\r
+               <type>mime type</type>\r
+               <height>number</height>\r
+               <width>number</width>\r
+               <profile>1 if is profile photo</profile>\r
+               <links type="array">\r
+                       <link type="mime type" scale="scale number" href="image url"/>\r
+                       ...\r
+               </links>\r
+       </photo>\r
+```\r
+\r
+---\r
+### friendica/photos/list\r
+\r
+Returns a list of all photo resources of the logged in user.\r
+\r
+#### Return values\r
+\r
+json\r
+```\r
+       [\r
+               {\r
+                       id: "resource_id",\r
+                       album: "album name",\r
+                       filename: "original file name",\r
+                       type: "image mime type",\r
+                       thumb: "url to thumb sized image"\r
+               },\r
+               ...\r
+       ]\r
+```\r
+\r
+xml\r
+```\r
+       <photos type="array">\r
+               <photo id="resource_id"\r
+                       album="album name"\r
+                       filename="original file name"\r
+                       type="image mime type">\r
+                               "url to thumb sized image"\r
+               </photo>\r
+               ...\r
+       </photos>\r
+```\r
+\r
+---\r
+### friends/ids\r
+#### Parameters\r
+* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)\r
 \r
 #### Unsupported parameters\r
-* trim_user \r
+* user_id\r
+* screen_name\r
+* cursor\r
+\r
+Friendica doesn't allow showing friends of other users.\r
+\r
+---\r
+### help/test\r
+\r
+---\r
+### media/upload\r
+#### Parameters\r
+* media: image data\r
 \r
+---\r
+### oauth/request_token\r
+#### Parameters\r
+* oauth_callback\r
+\r
+#### Unsupported parameters\r
+* x_auth_access_type\r
+\r
+---\r
+### oauth/access_token\r
+#### Parameters\r
+* oauth_verifier\r
+\r
+#### Unsupported parameters\r
+* x_auth_password\r
+* x_auth_username\r
+* x_auth_mode\r
+\r
+---\r
 ### statuses/destroy\r
 #### Parameters\r
 * id: message number\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* trim_user \r
+* trim_user\r
 \r
-### statuses/mentions\r
+---\r
+### statuses/followers\r
+* include_entities: "true" shows entities for pictures and links (Default: false)\r
+\r
+---\r
+### statuses/friends\r
+* include_entities: "true" shows entities for pictures and links (Default: false)\r
+\r
+---\r
+### statuses/friends_timeline\r
 #### Parameters\r
 * count: Items per page (default: 20)\r
 * page: page number\r
 * since_id: minimal id\r
 * max_id: maximum id\r
+* exclude_replies: don't show replies (default: false)\r
+* conversation_id: Shows all statuses of a given conversation.\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* include_rts \r
-* trim_user \r
-* contributor_details \r
+* include_rts\r
+* trim_user\r
+* contributor_details\r
 \r
-### statuses/replies\r
+---\r
+### statuses/home_timeline\r
 #### Parameters\r
 * count: Items per page (default: 20)\r
 * page: page number\r
 * since_id: minimal id\r
 * max_id: maximum id\r
+* exclude_replies: don't show replies (default: false)\r
+* conversation_id: Shows all statuses of a given conversation.\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* include_rts \r
-* trim_user \r
-* contributor_details \r
+* include_rts\r
+* trim_user\r
+* contributor_details\r
 \r
-### statuses/user_timeline\r
+---\r
+### statuses/mentions\r
 #### Parameters\r
-* user_id: id of the user \r
-* screen_name: screen name (for technical reasons, this value is not unique!)\r
 * count: Items per page (default: 20)\r
 * page: page number\r
 * since_id: minimal id\r
 * max_id: maximum id\r
-* exclude_replies: don't show replies (default: false)\r
-* conversation_id: Shows all statuses of a given conversation.\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* include_rts \r
-* trim_user \r
-* contributor_details \r
-\r
-### conversation/show\r
-Unofficial Twitter command. It shows all direct answers (excluding the original post) to a given id.\r
+* include_rts\r
+* trim_user\r
+* contributor_details\r
 \r
+---\r
+### statuses/public_timeline\r
 #### Parameters\r
-* id: id of the post\r
 * count: Items per page (default: 20)\r
 * page: page number\r
 * since_id: minimal id\r
 * max_id: maximum id\r
+* exclude_replies: don't show replies (default: false)\r
+* conversation_id: Shows all statuses of a given conversation.\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* include_rts \r
-* trim_user \r
-* contributor_details \r
+* trim_user\r
 \r
-### favorites\r
+---\r
+### statuses/replies\r
 #### Parameters\r
 * count: Items per page (default: 20)\r
 * page: page number\r
@@ -201,150 +428,276 @@ Unofficial Twitter command. It shows all direct answers (excluding the original
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* user_id\r
-* screen_name\r
-\r
-Favorites aren't displayed to other users, so "user_id" and "screen_name". So setting this value will result in an empty array.\r
+* include_rts\r
+* trim_user\r
+* contributor_details\r
 \r
-### account/rate_limit_status\r
+---\r
+### statuses/retweet\r
+#### Parameters\r
+* id: message number\r
+* include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
-### help/test\r
+#### Unsupported parameters\r
+* trim_user\r
 \r
-### statuses/friends\r
+---\r
+### statuses/show\r
+#### Parameters\r
+* id: message number\r
+* conversation: if set to "1" show all messages of the conversation with the given id\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
-* user_id\r
-* screen_name\r
-* cursor \r
+* include_my_retweet\r
+* trim_user\r
 \r
-Friendica doesn't allow showing friends of other users.\r
+---\r
+### statuses/update, statuses/update_with_media\r
+#### Parameters\r
+* title: Title of the status\r
+* status: Status in text format\r
+* htmlstatus: Status in HTML format\r
+* in_reply_to_status_id\r
+* lat: latitude\r
+* long: longitude\r
+* media: image data\r
+* source: Application name\r
+* group_allow\r
+* contact_allow\r
+* group_deny\r
+* contact_deny\r
+* network\r
+* include_entities: "true" shows entities for pictures and links (Default: false)\r
+* media_ids: (By now only a single value, no array)\r
 \r
-### statuses/followers\r
+#### Unsupported parameters\r
+* trim_user\r
+* place_id\r
+* display_coordinates\r
+\r
+---\r
+### statuses/user_timeline\r
+#### Parameters\r
+* user_id: id of the user\r
+* screen_name: screen name (for technical reasons, this value is not unique!)\r
+* count: Items per page (default: 20)\r
+* page: page number\r
+* since_id: minimal id\r
+* max_id: maximum id\r
+* exclude_replies: don't show replies (default: false)\r
+* conversation_id: Shows all statuses of a given conversation.\r
 * include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
+#### Unsupported parameters\r
+* include_rts\r
+* trim_user\r
+* contributor_details\r
+\r
+---\r
+### statusnet/config\r
+\r
+---\r
+### statusnet/version\r
+\r
 #### Unsupported parameters\r
 * user_id\r
 * screen_name\r
-* cursor \r
+* cursor\r
 \r
 Friendica doesn't allow showing followers of other users.\r
 \r
-### statusnet/config\r
+---\r
+### users/search\r
+#### Parameters\r
+* q: name of the user\r
 \r
-### statusnet/version\r
+#### Unsupported parameters\r
+* page\r
+* count\r
+* include_entities\r
 \r
-### friends/ids\r
+---\r
+### users/show\r
 #### Parameters\r
-* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)\r
+* user_id: id of the user\r
+* screen_name: screen name (for technical reasons, this value is not unique!)\r
+* include_entities: "true" shows entities for pictures and links (Default: false)\r
 \r
 #### Unsupported parameters\r
 * user_id\r
 * screen_name\r
-* cursor \r
+* cursor\r
 \r
 Friendica doesn't allow showing friends of other users.\r
 \r
-### followers/ids\r
-#### Parameters\r
-* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)\r
 \r
-#### Unsupported parameters\r
-* user_id\r
-* screen_name\r
-* cursor \r
+## Implemented API calls (not compatible with other APIs)\r
 \r
-Friendica doesn't allow showing followers of other users.\r
+---\r
+### friendica/group_show\r
+Return all or a specified group of the user with the containing contacts as array.\r
 \r
-### direct_messages/new\r
 #### Parameters\r
-* user_id: id of the user \r
-* screen_name: screen name (for technical reasons, this value is not unique!)\r
-* text: The message\r
-* replyto: ID of the replied direct message\r
-* title: Title of the direct message\r
+* gid: optional, if not given, API returns all groups of the user\r
 \r
-### direct_messages/conversation\r
-Shows all direct messages of a conversation\r
-#### Parameters\r
-* count: Items per page (default: 20)\r
-* page: page number\r
-* since_id: minimal id\r
-* max_id: maximum id\r
-* getText: Defines the format of the status field. Can be "html" or "plain"\r
-* uri: URI of the conversation\r
+#### Return values\r
+Array of:\r
+* name: name of the group\r
+* gid: id of the group\r
+* user: array of group members (return from api_get_user() function for each member)\r
 \r
-### direct_messages/all\r
-#### Parameters\r
-* count: Items per page (default: 20)\r
-* page: page number\r
-* since_id: minimal id\r
-* max_id: maximum id\r
-* getText: Defines the format of the status field. Can be "html" or "plain"\r
 \r
-### direct_messages/sent\r
-#### Parameters\r
-* count: Items per page (default: 20)\r
-* page: page number\r
-* since_id: minimal id\r
-* max_id: maximum id\r
-* getText: Defines the format of the status field. Can be "html" or "plain"\r
-* include_entities: "true" shows entities for pictures and links (Default: false)\r
+---\r
+### friendica/group_delete\r
+delete the specified group of contacts; API call need to include the correct gid AND name of the group to be deleted.\r
 \r
-### direct_messages\r
-#### Parameters\r
-* count: Items per page (default: 20)\r
-* page: page number\r
-* since_id: minimal id\r
-* max_id: maximum id\r
-* getText: Defines the format of the status field. Can be "html" or "plain"\r
-* include_entities: "true" shows entities for pictures and links (Default: false)\r
+---\r
+### Parameters\r
+* gid: id of the group to be deleted\r
+* name: name of the group to be deleted\r
 \r
-#### Unsupported parameters\r
-* skip_status \r
+#### Return values\r
+Array of:\r
+* success: true if successfully deleted\r
+* gid: gid of the deleted group\r
+* name: name of the deleted group\r
+* status: „deleted“ if successfully deleted\r
+* wrong users: empty array\r
 \r
-### oauth/request_token\r
+\r
+---\r
+### friendica/group_create\r
+Create the group with the posted array of contacts as members.\r
 #### Parameters\r
-* oauth_callback \r
+* name: name of the group to be created\r
 \r
-#### Unsupported parameters\r
-* x_auth_access_type \r
+#### POST data\r
+JSON data as Array like the result of „users/group_show“:\r
+* gid\r
+* name\r
+* array of users\r
 \r
-### oauth/access_token\r
+#### Return values\r
+Array of:\r
+* success: true if successfully created or reactivated\r
+* gid: gid of the created group\r
+* name: name of the created group\r
+* status: „missing user“ | „reactivated“ | „ok“\r
+* wrong users: array of users, which were not available in the contact table\r
+\r
+\r
+---\r
+### friendica/group_update\r
+Update the group with the posted array of contacts as members (post all members of the group to the call; function will remove members not posted).\r
 #### Parameters\r
-* oauth_verifier \r
+* gid: id of the group to be changed\r
+* name: name of the group to be changed\r
 \r
-#### Unsupported parameters\r
-* x_auth_password \r
-* x_auth_username \r
-* x_auth_mode \r
+#### POST data\r
+JSON data as array like the result of „users/group_show“:\r
+* gid\r
+* name\r
+* array of users\r
 \r
+#### Return values\r
+Array of:\r
+* success: true if successfully updated\r
+* gid: gid of the changed group\r
+* name: name of the changed group\r
+* status: „missing user“ | „ok“\r
+* wrong users: array of users, which were not available in the contact table\r
+\r
+---\r
 ## Not Implemented API calls\r
-The following list is extracted from the [API source file](https://github.com/friendica/friendica/blob/master/include/api.php) (at the very bottom):\r
-* favorites/create\r
-* favorites/destroy\r
+The following API calls are implemented in GNU Social but not in Friendica: (incomplete)\r
+\r
 * statuses/retweets_of_me\r
 * friendships/create\r
 * friendships/destroy\r
 * friendships/exists\r
 * friendships/show\r
-* account/update_location\r
 * account/update_profile_background_image\r
 * account/update_profile_image\r
 * blocks/create\r
 * blocks/destroy\r
 \r
-The following are things from the Twitter API also not implemented in StatusNet:\r
-* statuses/retweeted_to_me\r
-* statuses/retweeted_by_me\r
+The following API calls from the Twitter API aren't implemented neither in Friendica nor in GNU Social:\r
+\r
+* statuses/mentions_timeline\r
+* statuses/retweets/:id\r
+* statuses/oembed\r
+* statuses/retweeters/ids\r
+* statuses/lookup\r
+* direct_messages/show\r
+* search/tweets\r
 * direct_messages/destroy\r
-* account/end_session\r
+* friendships/no_retweets/ids\r
+* friendships/incoming\r
+* friendships/outgoing\r
+* friendships/update\r
+* friends/list\r
+* friendships/lookup\r
+* account/settings\r
 * account/update_delivery_device\r
-* notifications/follow\r
-* notifications/leave\r
-* blocks/exists\r
-* blocks/blocking\r
-* lists\r
+* account/update_profile\r
+* account/update_profile_background_image\r
+* account/update_profile_image\r
+* blocks/list\r
+* blocks/ids\r
+* users/lookup\r
+* users/show\r
+* users/search\r
+* account/remove_profile_banner\r
+* account/update_profile_banner\r
+* users/profile_banner\r
+* mutes/users/create\r
+* mutes/users/destroy\r
+* mutes/users/ids\r
+* mutes/users/list\r
+* users/suggestions/:slug\r
+* users/suggestions\r
+* users/suggestions/:slug/members\r
+* favorites/list\r
+* lists/list\r
+* lists/statuses\r
+* lists/members/destroy\r
+* lists/memberships\r
+* lists/subscribers\r
+* lists/subscribers/create\r
+* lists/subscribers/show\r
+* lists/subscribers/destroy\r
+* lists/members/create_all\r
+* lists/members/show\r
+* lists/members\r
+* lists/members/create\r
+* lists/destroy\r
+* lists/update\r
+* lists/create\r
+* lists/show\r
+* lists/subscriptions\r
+* lists/members/destroy_all\r
+* lists/ownerships\r
+* saved_searches/list\r
+* saved_searches/show/:id\r
+* saved_searches/create\r
+* saved_searches/destroy/:id\r
+* geo/id/:place_id\r
+* geo/reverse_geocode\r
+* geo/search\r
+* geo/place\r
+* trends/place\r
+* trends/available\r
+* help/configuration\r
+* help/languages\r
+* help/privacy\r
+* help/tos\r
+* trends/closest\r
+* users/report_spam\r
+\r
+---\r
+\r
+---\r
 \r
 ## Usage Examples\r
 ### BASH / cURL\r
@@ -359,4 +712,4 @@ The [RSStoFriedika](https://github.com/pafcu/RSStoFriendika) code can be used as
         url = server + '/api/statuses/update'\r
         urllib2.urlopen(url, urllib.urlencode({'status': message,'group_allow[]':group_allow}, doseq=True))\r
 \r
-There is also a [module for python 3](https://bitbucket.org/tobiasd/python-friendica) for using the API.
\ No newline at end of file
+There is also a [module for python 3](https://bitbucket.org/tobiasd/python-friendica) for using the API.\r