Guide: Consume and acknowledge

Goal

Poll for messages, process them, and acknowledge completion.

Prerequisites

• Completed Getting Started
• API key with messages:read and messages:ack

Steps

1) Poll for available messages

curl -sS "$IRON_BASE_URL/v1/messages:poll?max=10&visibility_timeout_seconds=60" \
  -H "Authorization: Bearer $IRON_API_KEY"

2) Process each message idempotently

Because delivery is at-least-once, use a dedupe key such as message.id in your processing store.

3) Acknowledge after successful processing

curl -sS -X POST "$IRON_BASE_URL/v1/messages/<MESSAGE_ID>:ack" \
  -H "Authorization: Bearer $IRON_API_KEY"

Validation

• The ack call returns { "status": "acked" }.
• The message no longer appears in subsequent polls.

Next steps

• Learn failure behavior and retries: Troubleshooting

---

Next: Getting Started · Reference · Changelog · Support