Skip to content

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
string
Required
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"
}
]
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress