Give something away
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
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.
Request Body
Responses
Posted: the giver's view of it, status held or available.