Ask for it
POST
/free-stuff/{id}/requests
Asks for an item. The note is optional ("You don't need to explain why"). One ask per person per item, at most 5 open, never your own, not while asking is paused, and not from someone the giver blocked. With "first to ask" the first valid ask is chosen at once (autoChosen: true, and the pickup is in item); a later ask answers 409 went_to_first.
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
Requiredstring
Format
"uuid"Request Body
application/json
JSON
{
"note": "string",
"pickupPref": "string"
}
Responses
Asked.
application/json
JSON
{
"requestId": "string",
"autoChosen": true,
"item": "string"
}