trash nothing

Archive all conversations

Archive conversation

Block conversation

Bookmark a post

Change email address

Change 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.

Contact group moderators

Create an email alert

Delete a photo

Delete a post

Users 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.

Delete a post bookmark

Delete an email alert

Delete conversation

Join groups

Request membership to one or more groups. <br /><br /> 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.

Leave a group

Like a story

List all post changes

This 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. <br /><br /> The different types of changes that are returned are listed below. <br /><br /> - deleted<br /> - undeleted<br /> - satisfied<br /> - promised<br /> - unpromised<br /> - withdrawn<br /> - edited<br /> <br /> For edited changes, clients can use the retrieve post API endpoint to get the edits that have been made to the post.

List all posts

This 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). <br /><br /> 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.

List conversation messages

List conversations

List current users' email alerts

List current users' group notices

List current users' groups

List current users' post locations

Only the most recent 3 post locations are returned.

List current users' posts

NOTE: In order to make it easier to see all a users&#39; posts, the current users&#39; 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.

List current users' profile images

List posts

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. 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.

List posts by a user

NOTE: In order to make it easier to see all a users&#39; posts, the current users&#39; 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.

List stories

Mark all conversations as read

Mark conversation as read

Promise an offer post

Mark 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.

Record story viewed

Records every time a user views the full story (and not just a preview or snippet),

Remove feedback on a user

Allows the current user to remove feedback that they left on a user.

Reply to a post

Send a reply to a post from the current user to the post author.

Reply to conversation

Report a post

Reports a post to be reviewed by the moderators.

Report a user

Report conversation

Resend account verification email

Retrieve a group

Retrieve a post

Retrieve a story

Retrieve a user

Retrieve a users' profile image

This is designed to be used as the src attribute of an HTML &lt;img&gt; tag to show the profile image of the given user.

Retrieve current user

Retrieve multiple groups

Retrieve multiple photos

Retrieve multiple posts

Retrieve post display data

Retrieve 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.

Retrieve user display info

Retrieve a user and information related to the user (eg. recent posts) that is useful for displaying a more detailed view of the user.

Rotate a photo

Satisfy a post

Mark an offer or wanted post by the current user as satisfied (eg. an offer has been taken or a wanted has been received).

Save a post location for the current user

Creates or updates a post location for the current user. Updates will happen when the name of the post location matches a previous post location.

Search conversations

Searches all conversations except blocked conversations.

Search current users' posts

Searching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters.

Search groups

Search posts

Searching 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.

Search posts by a user

Searching posts takes the same arguments as listing posts except for the addition of the search and sort_by parameters.

Send feedback

Allows users to send feedback about the trashnothing.com site or apps.

Send password reset email

Set a profile image

Profile 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.

Set users' email address as not bouncing

Resets 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.

Share a post

Forwards a copy of the post to the current user so that they can forward it to friends.

Submit a post

Submits a new post.

Submit a story

Submit feedback on a user

Allows 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.

Submit group answers

Submits answers to a groups' membership questionnaire. <br /><br /> 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.

Unarchive conversation

Unblock conversation

Unlike a story

Unpromise an offer post

Mark an offer by the current user as unpromised.

Update a post

Users 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.

Update current user

Update the current user. All fields are optional so requests can update just one or multiple user properties at a time.

Update location

Update the current users' location. The location is used to determine which posts are shown to the user (both public posts and group posts).

Withdraw a post

Mark an offer or wanted post by the current user as withdrawn.