action trashnothing_satisfy_post {
label: "Satisfy a post"
description: "Mark an offer or wanted post by the current user as satisfied (eg. an offer has been taken or a wanted has been received)."
provider: trashnothing
method: PUT
path: "/posts/{post_id}/satisfy"
encoding: json
input: {
type: "object"
properties: {
post_id: {
type: "string"
}
}
required: ["post_id"]
additionalProperties: false
}
output: {
type: "object"
description: "An offer, wanted, admin, taken or received post."
properties: {
content: {
type: "string"
}
date: {
type: "string"
format: "date-time"
description: "The UTC date and time when the post was published."
}
expiration: {
type: "string"
format: "date-time"
description: "The UTC date and time when the post will expire. Currently only offer and wanted posts expire. For all other posts, expiration is always null.\n"
}
footer: {
type: "string"
description: "Some groups add footers to posts that are separate and sometimes unrelated to the post itself - such as reminders about group rules or features (may be null)."
}
group_id: {
type: "string"
description: "The group ID of the post. For public posts, this is always null.\n"
}
latitude: {
type: "number"
description: "May be null if a post hasn't been mapped."
}
longitude: {
type: "number"
description: "May be null if a post hasn't been mapped."
}
outcome: {
type: "string"
description: "For offer and wanted posts, this indicates the outcome of the post which is null if no outcome has been set yet.
Offer post outcomes will be one of: satisfied, withdrawn, promised, expired
Wanted post outcomes will be one of: satisfied, withdrawn, expired
For all other posts, outcome is always null.\n"
}
photos: {
type: "array"
description: "Details about the photos associated with this post (may be null if there are no photos)."
items: {
type: "object"
properties: {
blurhash: {
type: "string"
description: "A blurhash of the photo that can be used as a placeholder while the photo is loading (see: https://github.com/woltapp/blurhash). May be null if no blurhash is available and the length of the blurhash can vary based on the photo.\n"
}
images: {
type: "array"
description: "All the versions of this photo ordered from smallest to largest. This list is guaranteed to include the photos specified by the above thumbnail and url properties."
items: {
type: "object"
properties: {
height: {
type: "integer"
}
url: {
type: "string"
}
width: {
type: "integer"
}
}
}
}
photo_id: {
type: "string"
}
thumbnail: {
type: "string"
description: "A URL to a thumbnail of this photo. The size of the thumbnail depends on the device_pixel_ratio parameter and it is not guaranteed to be square."
}
url: {
type: "string"
description: "A URL to a large version of this photo (but not necessarily the largest size available)."
}
}
}
}
post_id: {
type: "string"
}
repost_count: {
type: "integer"
description: "The count of how many times this post has been reposted in the last 90 days. A value of zero is used to indicate that the post is not a repost. The count is specific to the source of the post (eg. the specific group the post is on). If a post is crossposted to multiple groups, the repost_count of the post on each group may be different for each group depending on how many times the post has been posted on that group in the last 90 days.\n"
}
reselling: {
type: "boolean"
description: "For wanted posts, whether the item is being requested in order to resell it or not. Will be null for all posts that are not wanted posts and for wanted posts where the poster hasn't indicated whether or not they intend to resell the item they are requesting.\n"
}
source: {
type: "string"
description: "The source of the post. One of: groups, trashnothing, open_archive_groups. A value of groups or open_archive_groups indicates the post is from a group and the group_id field will contain the ID of the group. A value of trashnothing indicates the post is a public post not associated with any group.\n"
}
title: {
type: "string"
}
type: {
type: "string"
description: "The type of post. One of: offer, taken, wanted, received, admin\n"
}
url: {
type: "string"
description: "The link to use to view the post on the trash nothing site."
}
user_id: {
type: "string"
}
}
}
}