Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

This branch is 5 commits behind iron-io:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

IronMQ Go Client

Getting Started

Install the package:

go get

The API is documented here.

The Basics

Initialize a client and get a queue object:

client := ironmq.NewClient("my project", "my token", ironmq.IronAWSUSEast)
queue := client.Queue("my_queue")

Push a message on the queue:

id, err := queue.Push("Hello, world!")

Pop a message off the queue:

msg, err := queue.Get()

When you pop/get a message from the queue, it will not be deleted. It will eventually go back onto the queue after a timeout if you don't delete it. (The default timeout is 10 minutes.)

Delete a message from the queue:

err := msg.Delete()

Switching Clouds

You can switch to Rackspace by changing the Cloud/Region when creating the client.

client := ironmq.NewClient("my project", "my token", ironmq.IronRackspaceDFW)

See cloud.go for full list.

Something went wrong with that request. Please try again.