Send a pickup message
POST
/free-stuff/{id}/messages
Sends a message in the pickup thread, up to 1000 characters. 30 messages an hour per person per thread. The other person gets a bell for the first message they haven't read yet. A person who blocked the sender gets nothing: 403 cannot_message.
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
{
"body": "string",
"requestId": "string"
}
Responses
Sent: the thread.
application/json
JSON
{
"thread": {
"requestId": "string",
"status": "string",
"role": "string",
"with": {
"firstName": "string"
},
"canWrite": true,
"blockedByMe": true
},
"messages": [
{
"id": "string",
"mine": true,
"body": "string",
"sentAt": "string",
"readAt": "string"
}
]
}