Skip to content

The pickup thread​

GET
/free-stuff/{id}/messages

The thread between the giver and the person chosen, text only; nobody else can read it, and neither side's phone or email is part of it. Marks the other person's messages read. The giver reads the current chosen ask's thread, or another with requestId. Messages are deleted 90 days after the item closes.

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"

Query Parameters

requestId
Type
string
Format
"uuid"

Responses​

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

Samples​

Powered by VitePress OpenAPI

Built with VitePress