Skip to content

Edit an item​

PATCH
/free-stuff/{id}

The giver edits a held, available, promised or expired item. Changing the title, description, category or photos runs the checks again: a block refuses the edit, a borderline match holds a live post, a clean edit of a post held by the checks puts it back up (unless it is still the person's first post). While someone is picking it up (promised) only the pickup details, methods, date and condition change (409 promised). Switching to "first to ask" with asks waiting chooses the earliest.

Authorizations​

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)

Parameters​

Path Parameters

id*

The item.

Type
string
Required
Format
"uuid"

Request Body​

application/json
JSON
{
"title": "string",
"description": "string",
"categoryId": "string",
"condition": "string",
"pickup": {
"address": "string",
"point": {
},
"note": "string"
},
"pickupMethods": [
"string"
],
"availableUntil": "string",
"selectionMode": "string",
"photos": [
]
}

Responses​

The giver's view.

application/json
JSON
"string"

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress