Skip to content

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
string
Required
Format
"uuid"

Request Body​

application/json
JSON
{
"note": "string",
"pickupPref": "string"
}

Responses​

Asked.

application/json
JSON
{
"requestId": "string",
"autoChosen": true,
"item": "string"
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress