3 <!-- markdownlint-disable MD010 MD013 MD024 -->
7 The Friendica API aims to be compatible with the [GNU Social API](http://wiki.gnusocial.de/gnusocial:api) and the [Twitter API](https://dev.twitter.com/rest/public).
9 Please refer to the linked documentation for further information.
11 ## Implemented API calls
17 API endpoints can restrict the method used to request them.
18 Using an invalid method results in HTTP error 405 "Method Not Allowed".
20 In this document, the required method is listed after the endpoint name. "*" means every method can be used.
24 Friendica supports basic http auth and OAuth 1 to authenticate the user to the api.
26 OAuth settings can be added by the user in web UI under /settings/oauth/
28 In this document, endpoints which requires auth are marked with "AUTH" after endpoint name
30 #### Unsupported parameters
32 * cursor: Not implemented in GNU Social
33 * trim_user: Not implemented in GNU Social
34 * contributor_details: Not implemented in GNU Social
35 * place_id: Not implemented in GNU Social
36 * display_coordinates: Not implemented in GNU Social
38 * include_my_retweet: Retweets in Friendica are implemented in a different way
40 #### Different behaviour
42 * 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.
43 * include_entities: Default is "false". If set to "true" then the plain text is formatted so that links are having descriptions.
47 * cid: Contact id of the user (important for "contact_allow" and "contact_deny")
48 * network: network of the user
52 When an error occurs in API call, an HTTP error code is returned, with an error message
55 * 400 Bad Request: if parameters are missing or items can't be found
56 * 403 Forbidden: if the authenticated user is missing
57 * 405 Method Not Allowed: if API was called with an invalid method, eg. GET when API require POST
58 * 501 Not Implemented: if the requested API doesn't exist
59 * 500 Internal Server Error: on other error conditions
67 "error": "Specific error message",
68 "request": "API path requested",
69 "code": "HTTP error code"
77 <error>Specific error message</error>
78 <request>API path requested</request>
79 <code>HTTP error code</code>
85 ### account/rate_limit_status (*; AUTH)
89 ### account/verify_credentials (*; AUTH)
93 * skip_status: Don't show the "status" field. (Default: false)
94 * include_entities: "true" shows entities for pictures and links (Default: false)
98 ### conversation/show (*; AUTH)
100 Unofficial Twitter command. It shows all direct answers (excluding the original post) to a given id.
105 * count: Items per page (default: 20)
107 * since_id: minimum id
109 * include_entities: "true" shows entities for pictures and links (Default: false)
111 #### Unsupported parameters
115 * contributor_details
119 ### direct_messages (*; AUTH)
123 * count: Items per page (default: 20)
125 * since_id: minimum id
127 * getText: Defines the format of the status field. Can be "html" or "plain"
128 * include_entities: "true" shows entities for pictures and links (Default: false)
129 * friendica_verbose: "true" enables different error returns (default: "false")
131 #### Unsupported parameters
137 ### direct_messages/all (*; AUTH)
141 * count: Items per page (default: 20)
143 * since_id: minimum id
145 * getText: Defines the format of the status field. Can be "html" or "plain"
146 * friendica_verbose: "true" enables different error returns (default: "false")
150 ### direct_messages/conversation (*; AUTH)
152 Shows all direct messages of a conversation
156 * count: Items per page (default: 20)
158 * since_id: minimum id
160 * getText: Defines the format of the status field. Can be "html" or "plain"
161 * uri: URI of the conversation
162 * friendica_verbose: "true" enables different error returns (default: "false")
166 ### direct_messages/sent (*; AUTH)
170 * count: Items per page (default: 20)
172 * since_id: minimum id
174 * getText: Defines the format of the status field. Can be "html" or "plain"
175 * include_entities: "true" shows entities for pictures and links (Default: false)
176 * friendica_verbose: "true" enables different error returns (default: "false")
180 ### direct_messages/new (POST,PUT; AUTH)
184 * user_id: id of the user
185 * screen_name: screen name (for technical reasons, this value is not unique!)
187 * replyto: ID of the replied direct message
188 * title: Title of the direct message
192 ### direct_messages/destroy (POST,DELETE; AUTH)
196 * id: id of the message to be deleted
197 * include_entities: optional, currently not yet implemented
198 * friendica_parenturi: optional, can be used for increased safety to delete only intended messages
199 * friendica_verbose: "true" enables different error returns (default: "false")
205 * JSON return as defined for Twitter API not yet implemented
206 * on friendica_verbose=true: JSON return {"result":"ok","message":"message deleted"}
211 * on friendica_verbose=true: different JSON returns {"result":"error","message":"xyz"}
215 ### externalprofile/show (*)
219 * profileurl: profile url
223 ### favorites (*; AUTH)
227 * count: Items per page (default: 20)
229 * since_id: minimum id
231 * include_entities: "true" shows entities for pictures and links (Default: false)
233 #### Unsupported parameters
238 Favorites aren't displayed to other users, so "user_id" and "screen_name" are unsupported.
239 Set this values will result in an empty array.
243 ### favorites/create (POST,PUT; AUTH)
248 * include_entities: "true" shows entities for pictures and links (Default: false)
252 ### favorites/destroy (POST,DELETE; AUTH)
257 * include_entities: "true" shows entities for pictures and links (Default: false)
261 ### followers/ids (*; AUTH)
265 * stringify_ids: Send id numbers as text (true) or integers (false)? (default: false)
267 #### Unsupported parameters
273 Friendica doesn't allow showing the followers of other users.
277 ### friends/ids (*; AUTH)
281 * stringify_ids: Send the id numbers as text (true) or integers (false)? (default: false)
283 #### Unsupported parameters
289 Friendica doesn't allow showing the friends of other users.
297 ### lists/ownerships (*; AUTH)
301 * list_id: ID of the list
302 * count: Items per page
304 * since_id: Minimum ID
307 #### Unsupported parameters
317 ### lists/destroy (POST; AUTH)
321 * list_id: ID of the list
323 #### Unsupported parameters
331 ### lists/create (POST; AUTH)
335 * name: name of the list
337 #### Unsupported parameters
344 ### lists/update (POST; AUTH)
348 * list_id: ID of the list
349 * name: name of the list
351 #### Unsupported parameters
362 ### lists/statuses (*; AUTH)
366 * user_id: ID of the user for whom to return results.
368 #### Unsupported parameters
376 ### media/upload (POST,PUT; AUTH)
386 * media_id: a media identifier (integer)
387 * media_id_string: a media identifier (string)
389 * image.w: image width
390 * image.h: image height
391 * image.image_type: image mime type
392 * image.friendica_preview_url: image preview url
396 ### media/metadata/create (POST,PUT; AUTH)
400 Parameters are sent as JSON object:
406 "text":"Here comes the description"
417 ### oauth/request_token (*)
423 #### Unsupported parameters
429 ### oauth/access_token (*)
435 #### Unsupported parameters
443 ### statuses/destroy (POST,DELETE; AUTH)
448 * include_entities: "true" shows entities for pictures and links (Default: false)
450 #### Unsupported parameters
456 ### statuses/followers (*; AUTH)
460 * include_entities: "true" shows entities for pictures and links (Default: false)
464 ### statuses/friends (*; AUTH)
468 * include_entities: "true" shows entities for pictures and links (Default: false)
469 * count: how many items should be shown (Default: 20)
473 ### blocks/list (*; AUTH)
477 * include_entities: "true" shows entities for pictures and links (Default: false)
478 * count: Items per page (default: 20).
481 #### Unsupported parameters
488 ### statuses/friends_timeline (*; AUTH)
492 * count: Items per page (default: 20)
494 * since_id: minimum id
496 * exclude_replies: don't show replies (default: false)
497 * conversation_id: Shows all statuses of a given conversation.
498 * include_entities: "true" shows entities for pictures and links (Default: false)
500 #### Unsupported parameters
504 * contributor_details
508 ### statuses/home_timeline (*; AUTH)
512 * count: Items per page (default: 20)
514 * since_id: minimum id
516 * exclude_replies: don't show replies (default: false)
517 * conversation_id: Shows all statuses of a given conversation.
518 * include_entities: "true" shows entities for pictures and links (Default: false)
520 #### Unsupported parameters
524 * contributor_details
528 ### statuses/mentions (*; AUTH)
532 * count: Items per page (default: 20)
534 * since_id: minimum id
536 * include_entities: "true" shows entities for pictures and links (Default: false)
538 #### Unsupported parameters
542 * contributor_details
546 ### statuses/public_timeline (*; AUTH)
550 * count: Items per page (default: 20)
552 * since_id: minimum id
554 * exclude_replies: don't show replies (default: false)
555 * conversation_id: Shows all statuses of a given conversation.
556 * include_entities: "true" shows entities for pictures and links (Default: false)
558 #### Unsupported parameters
564 ### statuses/networkpublic_timeline (*; AUTH)
568 * count: Items per page (default: 20)
570 * since_id: minimum id
572 * include_entities: "true" shows entities for pictures and links (Default: false)
576 ### statuses/replies (*; AUTH)
580 * count: Items per page (default: 20)
582 * since_id: minimum id
584 * include_entities: "true" shows entities for pictures and links (Default: false)
586 #### Unsupported parameters
590 * contributor_details
594 ### statuses/retweet (POST,PUT; AUTH)
599 * include_entities: "true" shows entities for pictures and links (Default: false)
601 #### Unsupported parameters
607 ### statuses/show (*; AUTH)
612 * conversation: if set to "1" show all messages of the conversation with the given id
613 * include_entities: "true" shows entities for pictures and links (Default: false)
615 #### Unsupported parameters
622 ### statuses/update, statuses/update_with_media
626 * title: Title of the status
627 * status: Status in text format
628 * htmlstatus: Status in HTML format
629 * in_reply_to_status_id
633 * source: Application name
639 * include_entities: "true" shows entities for pictures and links (Default: false)
640 * media_ids: (By now only a single value, no array)
642 #### Unsupported parameters
646 * display_coordinates
650 ### statuses/user_timeline (*; AUTH)
654 * user_id: id of the user
655 * screen_name: screen name (for technical reasons, this value is not unique!)
656 * count: Items per page (default: 20)
658 * since_id: minimum id
660 * exclude_replies: don't show replies (default: false)
661 * conversation_id: Shows all statuses of a given conversation.
662 * include_entities: "true" shows entities for pictures and links (Default: false)
664 #### Unsupported parameters
668 * contributor_details
672 ### Return values for statuses/* api calls
674 Returned status object is conform to GNU Social/Twitter api.
676 Friendica adds some addictional fields:
678 - author: a user object, it's the author of the item. In case of a reshare for legacy reasons the "user" field doesn't show the real author. This field always contains the real author of a post.
679 - owner: a user object, it's the owner of the item.
680 - private: boolean, true if the item is marked as private
681 - activities: map with activities related to the item. Every activity is a list of user objects.
682 - comments: comment numbers
684 This properties are prefixed with "friendica_" in JSON responses and namespaced under "http://friendi.ca/schema/api/1/" in XML responses
692 'friendica_author' : {
695 'friendica_owner' : {
698 'friendica_private' : true,
699 'friendica_activities': {
711 'friendica_comments': 12
720 <statuses xmlns="http://api.twitter.com" xmlns:statusnet="http://status.net/schema/api/1/" xmlns:friendica="http://friendi.ca/schema/api/1/" xmlns:georss="http://www.georss.org/georss">
723 <friendica:owner><!-- user object --></friendica:owner>
724 <friendica:private>true</friendica:private>
725 <friendica:activities>
733 <friendica:attendyes/>
734 <friendica:attendno/>
735 <friendica:attendmaybe/>
736 </friendica:activities>
737 <friendica:comments>21</friendica:comments>
746 ### statusnet/config (*)
750 ### statusnet/conversation (*; AUTH)
752 It shows all direct answers (excluding the original post) to a given id.
757 * count: Items per page (default: 20)
759 * since_id: minimum id
761 * include_entities: "true" shows entities for pictures and links (Default: false)
765 ### statusnet/version (*)
767 #### Unsupported parameters
773 Friendica doesn't allow showing followers of other users.
782 * page: the page number (starting at 1) to return
783 * rpp: the number of statuses to return per page
784 * count: alias for the rpp parameter
785 * since_id: returns statuses with ids greater than the given id
786 * max_id: returns statuses with ids lower or equal to the given id
787 * exclude_replies: don't show replies (default: false)
789 #### Unsupported parameters
800 ### search/tweets (*; AUTH)
802 This is an alias for `search`.
806 ### saved_searches/list (*; AUTH)
808 This call does not have any parameter.
816 * q: name of the user
818 #### Unsupported parameters
830 * user_id: id of the user
831 * screen_name: screen name (for technical reasons, this value is not unique!)
832 * include_entities: "true" shows entities for pictures and links (Default: false)
834 #### Unsupported parameters
840 Friendica doesn't allow showing friends of other users.
844 ### users/lookup (*; AUTH)
848 * user_id: list of ids to lookup
850 #### Unsupported parameters
857 ### account/update_profile_image (POST; AUTH)
861 * image: image data as base64 (Twitter has a limit of 700kb, Friendica allows more)
862 * profile_id (optional): id of the profile for which the image should be used, default is changing the default profile
864 uploads a new profile image (scales 4-6) to database, changes default or specified profile to the new photo
870 * JSON return: returns the updated user details (see account/verify_credentials)
874 * 403 FORBIDDEN: if not authenticated
875 * 400 BADREQUEST: "no media data submitted", "profile_id not available"
876 * 500 INTERNALSERVERERROR: "image size exceeds PHP config settings, file was rejected by server",
877 "image size exceeds Friendica Config setting (uploaded size: x)",
878 "unable to process image data",
879 "image upload failed"
883 ### account/update_profile (POST; AUTH)
887 * name (optional): full name of the user
888 * description (optional): a description of the user
890 #### Unsupported parameters
900 ### friendships/incoming (*; AUTH)
902 #### Unsupported parameters
907 ## Implemented API calls (not compatible with other APIs)
911 ### friendica/activity/[verb]
917 Add or remove an activity from an item.
918 'verb' can be one of:
926 To remove an activity, prepend the verb with "un", eg. "unlike" or "undislike"
927 Attend verbs disable eachother: that means that if "attendyes" was added to an item, adding "attendno" remove previous "attendyes".
928 Attend verbs should be used only with event-related items (there is no check at the moment)
946 ### friendica/group_show (*; AUTH)
948 Return all or a specified group of the user with the containing contacts as array.
952 * gid: optional, if not given, API returns all groups of the user
958 * name: name of the group
959 * gid: id of the group
960 * user: array of group members (return from api_get_user() function for each member)
964 ### friendica/group_delete (POST,DELETE; AUTH)
966 delete the specified group of contacts; API call need to include the correct gid AND name of the group to be deleted.
970 * gid: id of the group to be deleted
971 * name: name of the group to be deleted
977 * success: true if successfully deleted
978 * gid: gid of the deleted group
979 * name: name of the deleted group
980 * status: „deleted“ if successfully deleted
981 * wrong users: empty array
985 ### friendica/group_create (POST,PUT; AUTH)
987 Create the group with the posted array of contacts as members.
991 * name: name of the group to be created
995 JSON data as Array like the result of "users/group_show":
1005 * success: true if successfully created or reactivated
1006 * gid: gid of the created group
1007 * name: name of the created group
1008 * status: „missing user“ | „reactivated“ | „ok“
1009 * wrong users: array of users, which were not available in the contact table
1013 ### friendica/group_update (POST)
1015 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).
1019 * gid: id of the group to be changed
1020 * name: name of the group to be changed
1024 JSON data as array like the result of „users/group_show“:
1034 * success: true if successfully updated
1035 * gid: gid of the changed group
1036 * name: name of the changed group
1037 * status: „missing user“ | „ok“
1038 * wrong users: array of users, which were not available in the contact table
1042 ### friendica/notifications (GET)
1044 Return last 50 notification for current user, ordered by date with unseen item on top
1054 * id: id of the note
1055 * type: type of notification as int (see NOTIFY_* constants in boot.php)
1056 * name: full name of the contact subject of the note
1057 * url: contact's profile url
1058 * photo: contact's profile photo
1059 * date: datetime string of the note
1060 * timestamp: timestamp of the node
1061 * date_rel: relative date of the note (eg. "1 hour ago")
1062 * msg: note message in bbcode
1063 * msg_html: note message in html
1064 * msg_plain: note message in plain text
1065 * link: link to note
1066 * seen: seen state: 0 or 1
1070 ### friendica/notifications/seen (POST)
1072 Set note as seen, returns item object if possible
1076 id: id of the note to set seen
1080 If the note is linked to an item, the item is returned, just like one of the "statuses/*_timeline" api.
1082 If the note is not linked to an item, a success status is returned:
1084 * `success` (json) | `<status>success</status>` (xml)
1088 ### friendica/photo (*; AUTH)
1092 * photo_id: Resource id of a photo.
1093 * scale: (optional) scale value of the photo
1095 Returns data of a picture with the given resource.
1096 If 'scale' isn't provided, returned data include full url to each scale of the photo.
1097 If 'scale' is set, returned data include image data base64 encoded.
1099 possibile scale value are:
1101 * 0: original or max size by server settings
1102 * 1: image with or height at <= 640
1103 * 2: image with or height at <= 320
1104 * 3: thumbnail 160x160
1105 * 4: Profile image at 300x300
1106 * 5: Profile image at 80x80
1107 * 6: Profile image at 48x48
1109 An image used as profile image has only scale 4-6, other images only 0-3
1118 "created": "date(YYYY-MM-DD HH:MM:SS)",
1119 "edited": "date(YYYY-MM-DD HH:MM:SS)",
1120 "title": "photo title",
1121 "desc": "photo description",
1122 "album": "album name",
1123 "filename": "original file name",
1124 "type": "mime type",
1127 "profile": "1 if is profile photo",
1129 "<scale>": "url to image"
1132 // if 'scale' is set
1133 "datasize": "size in byte",
1134 "data": "base64 encoded image data"
1143 <created>date(YYYY-MM-DD HH:MM:SS)</created>
1144 <edited>date(YYYY-MM-DD HH:MM:SS)</edited>
1145 <title>photo title</title>
1146 <desc>photo description</desc>
1147 <album>album name</album>
1148 <filename>original file name</filename>
1149 <type>mime type</type>
1150 <height>number</height>
1151 <width>number</width>
1152 <profile>1 if is profile photo</profile>
1153 <links type="array">
1154 <link type="mime type" scale="scale number" href="image url"/>
1162 ### friendica/photos/list (*; AUTH)
1164 Returns a list of all photo resources of the logged in user.
1174 album: "album name",
1175 filename: "original file name",
1176 type: "image mime type",
1177 thumb: "url to thumb sized image"
1186 <photos type="array">
1187 <photo id="resource_id"
1189 filename="original file name"
1190 type="image mime type">
1191 "url to thumb sized image"
1199 ### friendica/photoalbum/delete (POST,DELETE; AUTH)
1203 * album: name of the album to be deleted
1205 deletes all images with the specified album name, is not reversible -> ensure that client is asking user for being sure to do this
1211 * JSON return {"result":"deleted","message":"album 'xyz' with all containing photos has been deleted."}
1215 * 403 FORBIDDEN: if not authenticated
1216 * 400 BADREQUEST: "no albumname specified", "album not available"
1217 * 500 INTERNALSERVERERROR: "problem with deleting item occured", "unknown error - deleting from database failed"
1221 ### friendica/photoalbum/update (POST,PUT; AUTH)
1225 * album: name of the album to be updated
1226 * album_new: new name of the album
1228 changes the album name to album_new for all photos in album
1234 * JSON return {"result":"updated","message":"album 'abc' with all containing photos has been renamed to 'xyz'."}
1238 * 403 FORBIDDEN: if not authenticated
1239 * 400 BADREQUEST: "no albumname specified", "no new albumname specified", "album not available"
1240 * 500 INTERNALSERVERERROR: "unknown error - updating in database failed"
1244 ### friendica/photo/create (POST; AUTH)
1246 ### friendica/photo/update (POST; AUTH)
1250 * photo_id (optional): if specified the photo with this id will be updated
1251 * media (optional): image data as base64, only optional if photo_id is specified (new upload must have media)
1252 * desc (optional): description for the photo, updated when photo_id is specified
1253 * album: name of the album to be deleted (always necessary)
1254 * album_new (optional): can be used to change the album of a single photo if photo_id is specified
1255 * allow_cid/allow_gid/deny_cid/deny_gid (optional): on create: empty string or omitting = public photo, specify in format '```<x><y><z>```' for private photo;
1256 on update: keys need to be present with empty values for changing a private photo to public
1258 both calls point to one function for creating AND updating photos.
1259 Saves data for the scales 0-2 to database (see above for scale description).
1260 Call adds non-visible entries to items table to enable authenticated contacts to comment/like the photo.
1261 Client should pay attention to the fact that updated access rights are not transferred to the contacts. i.e. public photos remain publicly visible if they have been commented/liked before setting visibility back to a limited group.
1262 Currently it is best to inform user that updating rights is not the right way to do this, and offer a solution to add photo as a new photo with the new rights instead.
1268 * new photo uploaded: JSON return with photo data (see friendica/photo)
1269 * photo updated - changed photo data: JSON return with photo data (see friendica/photo)
1270 * photo updated - changed info: JSON return {"result":"updated","message":"Image id 'xyz' has been updated."}
1271 * photo updated - nothing changed: JSON return {"result":"cancelled","message":"Nothing to update for image id 'xyz'."}
1275 * 403 FORBIDDEN: if not authenticated
1276 * 400 BADREQUEST: "no albumname specified", "no media data submitted", "photo not available", "acl data invalid"
1277 * 500 INTERNALSERVERERROR: "image size exceeds PHP config settings, file was rejected by server",
1278 "image size exceeds Friendica Config setting (uploaded size: x)",
1279 "unable to process image data",
1280 "image upload failed",
1281 "unknown error - uploading photo failed, see Friendica log for more information",
1282 "unknown error - update photo entry in database failed",
1283 "unknown error - this error on uploading or updating a photo should never happen"
1287 ### friendica/photo/delete (DELETE; AUTH)
1291 * photo_id: id of the photo to be deleted
1293 deletes a single image with the specified id, is not reversible -> ensure that client is asking user for being sure to do this
1294 Sets item table entries for this photo to deleted = 1
1300 * JSON return {"result":"deleted","message":"photo with id 'xyz' has been deleted from server."}
1304 * 403 FORBIDDEN: if not authenticated
1305 * 400 BADREQUEST: "no photo_id specified", "photo not available"
1306 * 500 INTERNALSERVERERROR: "unknown error on deleting photo", "problem with deleting items occurred"
1310 ### friendica/direct_messages_setseen (GET; AUTH)
1314 * id: id of the message to be updated as seen
1320 * JSON return {"result":"ok","message":"message set to seen"}
1324 * different JSON returns {"result":"error","message":"xyz"}
1328 ### friendica/direct_messages_search (GET; AUTH)
1332 * searchstring: string for which the API call should search as '%searchstring%' in field 'body' of all messages of the authenticated user (caption ignored)
1336 Returns only tested with JSON, XML might work as well.
1340 * JSON return {"success":"true","search_results": array of found messages}
1341 * JSOn return {"success":"false","search_results":"nothing found"}
1345 * different JSON returns {"result":"error","message":"searchstring not specified"}
1349 ### friendica/profile/show (GET; AUTH)
1351 show data of all profiles or a single profile of the authenticated user
1355 * profile_id: id of the profile to be returned (optional, if omitted all profiles are returned by default)
1359 On success: Array of:
1361 * multi_profiles: true if user has activated multi_profiles
1362 * global_dir: URL of the global directory set in server settings
1363 * friendica_owner: user data of the authenticated user
1364 * profiles: array of the profile data
1367 HTTP 403 Forbidden: when no authentication was provided
1368 HTTP 400 Bad Request: if given profile_id is not in the database or is not assigned to the authenticated user
1370 General description of profile data in API returns:
1374 * is_default: true if this is the public profile
1375 * hide_friends: true if friends are hidden
1378 * publish: true if published on the server's local directory
1379 * net_publish: true if published to global_dir
1380 * description ... homepage: different data fields from 'profile' table in database
1381 * users: array with the users allowed to view this profile (empty if is_default=true)
1385 ## Not Implemented API calls
1387 The following API calls are implemented in GNU Social but not in Friendica: (incomplete)
1389 * statuses/retweets_of_me
1390 * friendships/create
1391 * friendships/destroy
1392 * friendships/exists
1394 * account/update_profile_background_image
1398 The following API calls from the Twitter API are not implemented in either Friendica or GNU Social:
1400 * statuses/mentions_timeline
1401 * statuses/retweets/:id
1403 * statuses/retweeters/ids
1405 * direct_messages/show
1406 * friendships/no_retweets/ids
1407 * friendships/outgoing
1408 * friendships/update
1410 * friendships/lookup
1412 * account/update_delivery_device
1416 * account/remove_profile_banner
1417 * account/update_profile_banner
1418 * users/profile_banner
1419 * mutes/users/create
1420 * mutes/users/destroy
1423 * users/suggestions/:slug
1425 * users/suggestions/:slug/members
1428 * lists/members/destroy
1431 * lists/subscribers/create
1432 * lists/subscribers/show
1433 * lists/subscribers/destroy
1434 * lists/members/create_all
1435 * lists/members/show
1437 * lists/members/create
1439 * lists/subscriptions
1440 * lists/members/destroy_all
1441 * saved_searches/show/:id
1442 * saved_searches/create
1443 * saved_searches/destroy/:id
1445 * geo/reverse_geocode
1450 * help/configuration
1466 /usr/bin/curl -u USER:PASS https://YOUR.FRIENDICA.TLD/api/statuses/update.xml -d source="some source id" -d status="the status you want to post"
1471 The [RSStoFriendika](https://github.com/pafcu/RSStoFriendika) code can be used as an example of how to use the API with python.
1472 The lines for posting are located at [line 21](https://github.com/pafcu/RSStoFriendika/blob/master/RSStoFriendika.py#L21) and following.
1474 def tweet(server, message, group_allow=None):
1475 url = server + '/api/statuses/update'
1476 urllib2.urlopen(url, urllib.urlencode({'status': message,'group_allow[]':group_allow}, doseq=True))
1478 There is also a [module for python 3](https://bitbucket.org/tobiasd/python-friendica) for using the API.