Skip to content

Choose who gets it​

POST
/free-stuff/{id}/requests/{requestId}/choose

The giver chooses one ask: the item is promised to that person, who alone is shown the pickup place and note, and told "It's yours". The other asks stay open as backups until it is given. pickupNote updates the note shared with them.

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"
requestId*

The ask.

Type
string
Required
Format
"uuid"

Request Body​

application/json
JSON
{
"pickupNote": "string"
}

Responses​

The giver's view.

application/json
JSON
"string"

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress