---
title: "Acknowledge a message by id."
method: POST
path: "/messages/{id}/ack"
tags: ["messages"]
---

# Acknowledge a message by id.

`POST /messages/{id}/ack`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/messages/{id}/ack`
- Auth: HTTP bearer

msgchannel increment 3. Sets the message read so it stops surfacing as unacked (in list_messages and infrastructure_status's messages[]). Idempotent: acking an already-acked id returns success with no second effect, never an error.

## Path parameters

- `id` string, required

## Response `200`

Acknowledged (or already was — idempotent).

- AckMessageResult
  - `acked` true, required
  - `alreadyAcked` boolean, required

## Other responses

- `401`: Missing, invalid, or inactive bearer token.
- `404`: Resource not found, or not owned by the authenticated account.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)