Update inbox item

PATCH/api/v1/inbox/:id

Updates the state of an inbox item — mark it read, save it, or decline it. All body fields are optional; send only the ones you want to change.

Request

Path parameters

idstringrequired

The inbox item UUID.

Body parameters

is_readboolean

Mark as read or unread.

is_savedboolean

Save or unsave the item.

is_declinedboolean

Decline (hide) the item.

Response

Returns a JSON object with a data field containing the result.

Response fields

data.idstring

The inbox item UUID.

data.is_read / is_saved / is_declinedboolean

The updated state.

data.read_atstring

Timestamp set when the item was first marked read.

curl -X PATCH \
-H "Authorization: Bearer rsp_your_key" \
-H "Content-Type: application/json" \
-d '{"is_read": true, "is_saved": true}' \
"https://redship.io/api/v1/inbox/550e8400-e29b-41d4-a716-446655440000"

Success response200

{
"data": {
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "post_title": "Looking for a tool to automate Reddit outreach",
  "is_read": true,
  "is_saved": true,
  "is_declined": false,
  "read_at": "2024-01-15T12:00:00Z",
  "created_at": "2024-01-15T10:30:00Z"
}
}