Skip to content

Give something away​

POST
/free-stuff

Posts an item. The automatic checks run on the title, description and category: a currency amount or a not-allowed item refuses it (422 not_allowed, with details.reasons[]: rule, field, term, match, and topic: pets for live animals); a borderline match holds it for review. A person's first post is held too ("Held for review, usually within a day"); anything else is available at once. Photos come from POST /storage/upload (bucket free-stuff-photos), 1 to 6. Posting as a provider needs to be able to manage it; after 3 posts as the same provider in 30 days the answer carries nudge. 10 posts a person a day.

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)

Request Body​

application/json
JSON
"string"

Responses​

Posted: the giver's view of it, status held or available.

application/json
JSON
"string"

Playground​

Server
Authorization
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress