> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osis.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Mark conversation read

> POST /api/v1/comms/conversations/:id/read — mark an iMessage or SMS conversation read.

Mark an owned conversation as read and request a read receipt from its iMessage/SMS provider thread.

**Scope:** `comms_send`

```bash theme={null}
curl -X POST "https://osis.co/api/v1/comms/conversations/$CONVERSATION_ID/read"   -H "Authorization: Bearer $COMMS_API_KEY"   -H "Content-Type: application/json"   -d '{ "force": true }'
```

`force` defaults to `true`, which sends the explicit read action even when the line's automatic read receipts are disabled. Set `force` to `false` only when you want the line's presence setting to decide.

```json theme={null}
{ "ok": true, "read": true, "skipped": false, "reason": null }
```

The API returns `404` for a conversation outside your organization and `409 provider_conversation_unavailable` when the conversation is not backed by an iMessage/SMS thread.