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

# GET Message Status

> Update the delivery status of a message.

## Update Message Status

`PUT /api/messages/:messageId/status`

Update the status of a message (e.g., mark as read, delivered, or failed).

### Headers

**Cookie** `string` *required*

Session cookie (login via POST /api/auth/login)

```bash cURL theme={null}
curl -X PUT https://zeplo.ai/api/messages/42/status \
  -H "Cookie: connect.sid=s%3A7HImZ-T2BxWSbUsf9dtWdOlBW4rVuORO.5J0Do0NyvBu%2BkTvu1aHvtNs00BKhkpUKTwiokLS0cpw" \
  -H "Content-Type: application/json" \
  -d '{ "status": "read" }'
```

### Path parameters

**messageId** `integer` *required*

The message ID.

### Request body

**status** `string` *required*

The new status value.

### Status values

| Status | Description |
| - | - |
| `queued` | Queued for sending |
| `sent` | Sent to WhatsApp |
| `delivered` | Delivered to device |
| `read` | Read by recipient |
| `failed` | Delivery failed |

```json Response theme={null}
{
  "success": true,
  "message": "Message status updated",
  "data": {
    "id": 42,
    "status": "read",
    "updatedAt": "2026-01-15T11:00:00Z"
  }
}
```

***

## Get message logs

`GET /api/messages/logs`

Retrieve message delivery logs with filtering.

```bash cURL theme={null}
curl "https://zeplo.ai/api/messages/logs?status=failed&page=1&limit=20" \
  -H "Cookie: connect.sid=s%3A7HImZ-T2BxWSbUsf9dtWdOlBW4rVuORO.5J0Do0NyvBu%2BkTvu1aHvtNs00BKhkpUKTwiokLS0cpw"
```

### Query parameters

**channelId** `integer`

Filter by channel.

**status** `string`

Filter by status.

**startDate** `string`

Start date (ISO 8601).

**endDate** `string`

End date (ISO 8601).

**page** `integer`

Page number.

**limit** `integer`

Items per page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.