Install Jentic One Beta

Connect the IBM MQ REST API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the IBM MQ REST API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fibm.com%2Fibm-mq-rest-api" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fibm.com%2Fibm-mq-rest-api" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with IBM MQ REST API.

Administer queue managers via /v2/admin/qmgr and /v2/admin/qmgr/{qmgrName}

Manage queues on a queue manager via /v2/admin/qmgr/{qmgrName}/queue

Configure channels and subscriptions via /v2/admin/qmgr/{qmgrName}/channel and /subscription

Put or get messages on a named queue via /v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message

GET STARTED

Start building with IBM MQ REST API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use IBM MQ REST API for, with concrete tasks.

★ Cloud-Native MQ Producer

Send messages onto an IBM MQ queue from a service that cannot run the MQ client libraries - a serverless function, a browser, or an AI agent - by POSTing to /v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message. This makes it possible to bridge cloud-native systems into a bank or insurer's existing MQ-based messaging backbone without distributing native binaries.

POST a JSON message body to /v2/messaging/qmgr/QM1/queue/ORDERS.IN/message with content type application/json and the order payload.

Queue Administration

Inspect and configure queues, channels, and subscriptions on a queue manager from an external automation tool. The API exposes admin endpoints under /v2/admin/qmgr/{qmgrName}/* so an operator or agent can list queues, create new ones, and audit channel configuration without using the MQ Explorer UI.

GET /v2/admin/qmgr/QM1/queue and return the list of queues whose name starts with PAYMENTS.

Cross-System Bridging

Use the REST messaging endpoint as a bridge between MQ and HTTP-only systems - for example, drop messages onto MQ when a webhook fires, or read MQ messages and forward them to a Slack channel. Because the API speaks HTTPS, it integrates cleanly into iPaaS tools and Jentic-driven agents.

GET a single message from /v2/messaging/qmgr/QM1/queue/ALERTS/message and post the message body to a configured Slack channel.

AI Agent Messaging Operator

An AI agent uses Jentic to enqueue messages on MQ as part of a larger workflow - for example, submitting a payment instruction onto a banking system's intake queue. The agent searches by intent, loads the messaging schema, and executes the call, never holding the raw MQ credentials. Typical agent integration is under one hour because the messaging surface is small and well-scoped.

Search Jentic for 'put a message on an IBM MQ queue', load the /v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message schema, and submit the payment instruction.

Key Endpoints

14 endpoints — ibm mq is the enterprise message-oriented middleware that backs many bank, insurance, and supply-chain integrations, and the ibm mq rest api exposes administration and messaging operations over https so that systems without a native mq client can still participate.

METHOD

PATH

DESCRIPTION

GET

/v2/admin/qmgr

List queue managers

GET

/v2/admin/qmgr/{qmgrName}/queue

List queues on a queue manager

GET

/v2/admin/qmgr/{qmgrName}/channel

List channels on a queue manager

POST

/v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message

Put a message on a queue

DELETE

/v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message

Get and remove the next message

POST

/v1/login

Establish a REST session

POST

/v1/logout

End a REST session

GET

/v2/admin/qmgr

List queue managers

GET

/v2/admin/qmgr/{qmgrName}/queue

List queues on a queue manager

GET

/v2/admin/qmgr/{qmgrName}/channel

List channels on a queue manager

POST

/v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message

Put a message on a queue

DELETE

/v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message

Get and remove the next message

POST

/v1/login

Establish a REST session

POST

/v1/logout

End a REST session

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the IBM MQ REST API by hand means picking among its apiKey, basic, and token auth options, targeting your queue manager host and port, and mapping its admin and messaging routes yourself. Through Jentic you install once, import the IBM MQ REST API from the API Directory, store the credential once, and your agent calls it.

Permission scoping

MQ REST puts the queue manager and queue names in the URL path (/qmgr/{qmgrName}/queue/{queueName}), so a rule can pin your agent to one queue manager: it can read admin state and post messages there and nowhere else. You choose the operations it may call, so deleting messages from a queue is not included unless you add it.

Credential isolation

Your MQ credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'put a message on an MQ queue' or 'list a queue manager's queues', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using IBM MQ REST API through Jentic.

What authentication does the IBM MQ REST API use?

The MQ REST API supports three schemes: an LtpaToken2 cookie set by /v1/login, HTTP basic authentication, and HTTP bearer authentication. Through Jentic, the chosen credentials are stored in your Jentic One instance and the agent calls MQ via a scoped Jentic credential.

Can I put a message on an IBM MQ queue with this API?

Yes. POST the message payload to /v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message. The endpoint accepts both text and JSON payloads and writes them onto the named queue without requiring a native MQ client.

How do I get the next message off a queue?

DELETE /v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message returns and removes the next available message from the queue. The destructive read pattern matches the MQ get-with-remove semantics used by traditional MQ clients.

How do I send a message to IBM MQ through Jentic?

Search Jentic for 'put a message on an IBM MQ queue', load the /v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message schema, and execute. Install the SDK with pip install jentic and use the async search, load, execute pattern from Python.

Can I administer queue managers and queues over the REST API?

Yes. The /v2/admin/qmgr endpoints cover queue manager listing and inspection, /v2/admin/qmgr/{qmgrName}/queue covers queue administration, and /v2/admin/qmgr/{qmgrName}/channel and /subscription cover channels and topic subscriptions.

What are the rate limits for the IBM MQ REST API?

IBM MQ does not enforce a fixed REST rate limit; throughput depends on the queue manager configuration, channel limits, and the deployment topology. Treat HTTP 429 and 503 as backpressure and retry with exponential backoff.

Can I limit what my agent is allowed to do with the IBM MQ REST API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use. Since the IBM MQ REST API puts the queue manager and queue names in the URL path, such as /v2/messaging/qmgr/{qmgrName}/queue/{queueName}/message, you can pin the agent to a single queue manager and let it read admin state and put messages there and nowhere else. Because you choose the exact operations it may call, a destructive read like DELETE on a queue message is excluded unless you add it.

IBM MQ REST API

Name: IBM MQ REST API
Brand: IBM MQ REST API
Availability: InStock

Browse all Ibm APIs

Official vendor OpenAPI document · agent-readyCommunicationsChat MessagingapiKey, basic, bearer14 EndpointsREST

For Agents

Administer IBM MQ queue managers, queues, channels, and subscriptions, and put or get messages on a queue over HTTPS - without an MQ client.

Use for: I need to put a message on an IBM MQ queue from a web service, Get the next available message off a named MQ queue, List all queues defined on a queue manager, Create a new queue on an MQ queue manager

Not supported: Does not handle queue manager provisioning, MQ client library configuration, or MQTT pub/sub - use for MQ administration and HTTPS-based queue messaging only.

IBM MQ is the enterprise message-oriented middleware that backs many bank, insurance, and supply-chain integrations, and the IBM MQ REST API exposes administration and messaging operations over HTTPS so that systems without a native MQ client can still participate. The spec covers queue manager, queue, channel, and subscription administration, plus a messaging endpoint for putting and getting messages on a named queue. It is suited to teams that need to drive MQ from cloud-native services, browsers, or AI agents that cannot bundle the MQ client libraries.

Jentic One on Github View OpenAPI Document

Connect the IBM MQ REST API to your agent

Capabilities

Start building with IBM MQ REST API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

IBM MQ REST API