trash nothing
This is the REST API for .
To learn more about the API or to register your app for use with the API visit the .
NOTE: All date-time values are and are in (eg. 2019-02-03T01:23:53).
- Homepage
- https://api.apis.guru/v2/specs/trashnothing.com/1.3.json
- Provider
- trashnothing.com
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/trashnothing.com/1.3/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/trashnothing.com/1.3/openapi.yaml
Tools (78)
Extracted live via the executor SDK.
-
groups.contactModeratorsContact group moderators
-
groups.getGroupRetrieve a group
-
groups.getGroupsByIdsRetrieve multiple groups
-
groups.joinGroupsRequest membership to one or more groups.
NOTE: Any group with a has_questions field set to true will also require answers to the groups' new member questionnaire to be submitted. Groups waiting for answers will have their membership field set to 'pending-questions'. And the questionnaire that needs to be answered can be found in the membership.questionnaire field of the group after a subscribe request is made to that group. -
groups.leaveGroupLeave a group
-
groups.searchGroupsSearch groups
-
groups.submitAnswersSubmits answers to a groups' membership questionnaire.
The request body should be a JSON object mapping each question from the group membership.questionnaire.questions field to an answer (eg. {"Where do you live?": "New York City"} ). All questions are required so no null or empty string answers are allowed. -
messages.archiveAllConversationsArchive all conversations
-
messages.archiveConversationArchive conversation
-
messages.blockConversationBlock conversation
-
messages.deleteConversationDelete conversation
-
messages.getConversationMessagesList conversation messages
-
messages.getConversationsList conversations
-
messages.markAllConversationsReadMark all conversations as read
-
messages.markConversationReadMark conversation as read
-
messages.replyToConversationReply to conversation
-
messages.reportConversationReport conversation
-
messages.searchConversationsSearches all conversations except blocked conversations.
-
messages.unarchiveConversationUnarchive conversation
-
messages.unblockConversationUnblock conversation
-
misc.sendFeedbackAllows users to send feedback about the trashnothing.com site or apps.
-
photos.deletePhotoDelete a photo
-
photos.getPhotosByIdsRetrieve multiple photos
-
photos.rotatePhotoRotate a photo
-
photos.uploadPhotoCreate a photo
-
posts.bookmarkPostBookmark a post
-
posts.deleteBookmarkDelete a post bookmark
-
posts.deletePostUsers can delete posts they have made that have been satisfied or withdrawn or that have expired. Deleting posts isn't intended to be a normal part of the posting process since it makes reposting and viewing old posts harder.
-
posts.getAllPostsThis endpoint provides an easy way to get a feed of all the publicly published posts on trash nothing. It provides access to all publicly published offer and wanted posts from the last 30 days. The posts are sorted by date (newest first).
There are fewer options for filtering, sorting and searching posts with this endpoint but there is no 1,000 post limit and posts that are crossposted to multiple groups are not merged together in the response. In most cases, crossposted posts are easy to detect because they have the same user_id, title and content. -
posts.getAllPostsChangesThis endpoint provides an easy way to get a feed of all the changes that have been made to publicly published posts on trash nothing. Similar to the /posts/all endpoint, only data from the last 30 days is available and the changes are sorted by date (newest first). Every change includes the date of the change, the post_id of the post that was changed and the type of change.
The different types of changes that are returned are listed below.
- deleted
- undeleted
- satisfied
- promised
- unpromised
- withdrawn
- edited
For edited changes, clients can use the retrieve post API endpoint to get the edits that have been made to the post. -
posts.getPostRetrieve a post
-
posts.getPostAndRelatedDataRetrieve a post and other data related to the post that is useful for displaying the post such as data about the user who posted the post and the groups the post was posted on.
-
posts.getPostsNOTE: When paging through the posts returned by this endpoint, there will be at most 1,000 posts that can be returned (eg. 50 pages worth of posts with the default per_page value of 20). In areas where there are more than 1,000 posts, clients can use more specific query parameters to adjust which posts are returned. NOTE: Passing the latitude, longitude and radius parameters filters all posts by their location and so these parameters will temporarily override the current users' location preferences. When latitude, longitude and radius are not specified, public posts will be filtered by the current users' location preferences.
-
posts.getPostsByIdsRetrieve multiple posts
-
posts.promisePostMark an offer by the current user as promised to someone. This helps people viewing the post know that the items being offered may soon be given away as long as the person who was promised the items picks them up.
-
posts.replyToPostSend a reply to a post from the current user to the post author.
-
posts.reportPostReports a post to be reviewed by the moderators.
-
posts.satisfyPostMark an offer or wanted post by the current user as satisfied (eg. an offer has been taken or a wanted has been received).
-
posts.searchPostsSearching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters. NOTE: When paging through the posts returned by this endpoint, there will be at most 1,000 posts that can be returned (eg. 50 pages worth of posts with the default per_page value of 20). In areas where there are more than 1,000 posts, clients can use more specific query parameters to adjust which posts are returned.
-
posts.sharePostForwards a copy of the post to the current user so that they can forward it to friends.
-
posts.submitPostSubmits a new post.
-
posts.unpromisePostMark an offer by the current user as unpromised.
-
posts.updatePostUsers can update posts to fix mistakes with their post, add photos, or add more details about the items. Updates should not be used to say that items in a post have been taken or received since the post satisfy endpoint is designed to do that.
-
posts.withdrawPostMark an offer or wanted post by the current user as withdrawn.
-
stories.getStoriesList stories
-
stories.getStoryRetrieve a story
-
stories.likeStoryLike a story
-
stories.submitStorySubmit a story
-
stories.unlikeStoryUnlike a story
-
stories.viewedStoryRecords every time a user views the full story (and not just a preview or snippet),
-
users.changeEmailChange the users' current email address. A verification link will be emailed to the new email address to verify that the email account belongs to the user. The email change will not take effect until the user clicks the link in the verification email.
-
users.createAlertCreate an email alert
-
users.deleteAlertDelete an email alert
-
users.getAlertsList current users' email alerts
-
users.getCurrentUserRetrieve current user
-
users.getCurrentUserGroupsList current users' groups
-
users.getCurrentUserPostsNOTE: In order to make it easier to see all a users' posts, the current users' location preferences are not applied when listing or searching posts from a single user. If location based filtering of the posts is needed, the latitude, longitude and radius parameters may be used.
-
users.getPostLocationsOnly the most recent 3 post locations are returned.
-
users.getProfileImageFileThis is designed to be used as the src attribute of an HTML <img> tag to show the profile image of the given user.
-
users.getProfileImagesList current users' profile images
-
users.getUserRetrieve a user
-
users.getUserAndRelatedDataRetrieve a user and information related to the user (eg. recent posts) that is useful for displaying a more detailed view of the user.
-
users.getUserGroupNoticesList current users' group notices
-
users.getUserPostsNOTE: In order to make it easier to see all a users' posts, the current users' location preferences are not applied when listing or searching posts from a single user. If location based filtering of the posts is needed, the latitude, longitude and radius parameters may be used.
-
users.removeUserFeedbackAllows the current user to remove feedback that they left on a user.
-
users.reportUserReport a user
-
users.resendAccountVerificationEmailResend account verification email
-
users.savePostLocationCreates or updates a post location for the current user. Updates will happen when the name of the post location matches a previous post location.
-
users.searchCurrentUserPostsSearching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters.
-
users.searchUserPostsSearching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters.
-
users.sendPasswordResetEmailSend password reset email
-
users.setEmailNotBouncingResets an email address bouncing state to false. The users' email address may be automatically marked as bouncing again if further emails sent to it are bounced.
-
users.setProfileImageProfile images must be at least 90 pixels wide and tall. And if the image used is not square it will be automatically cropped to be square.
-
users.submitUserFeedbackAllows the current user to submit feedback on a user. The current user can only leave feedback on a user if the feedback allowed property on that user is set to true (see User definition for more details). And the system will only store the most recent feedback submission that the current user has submitted on a user. If the current user submits feedback multiple times, the newest feedback will overwrite the older feedback. This allows users to update their feedback as long as the feedback allowed property allows it.
-
users.updateCurrentUserUpdate the current user. All fields are optional so requests can update just one or multiple user properties at a time.
-
users.updateLocationUpdate the current users' location. The location is used to determine which posts are shown to the user (both public posts and group posts).
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools