Install Jentic One Beta

Connect the Qakka to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Qakka, 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%2Fapache.org%2Fqakka" | 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%2Fapache.org%2Fqakka" | 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 Qakka API.

Create a named Qakka queue and update its configuration parameters

List queues currently registered on the Qakka deployment

Send a message into a queue and assign it a queueMessageId

Receive one or more messages from a queue for processing

Acknowledge a processed message so it is not redelivered

GET STARTED

Start building with Qakka API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Qakka API for, with concrete tasks.

★ Lightweight job queue for service-to-service work

Use Qakka as a small, self-hosted queue for background jobs that do not justify a Kafka or RabbitMQ deployment. The producer POSTs jobs to /queues/{queueName}/messages, workers pull messages from the same path, process them, and acknowledge via /queues/{queueName}/messages/{queueMessageId}. Suitable for in-process workflows that just need at-least-once delivery.

POST a job payload to /queues/email-jobs/messages, then on a worker poll GET /queues/email-jobs/messages and POST acknowledgement once the email is sent

Queue health monitoring

Run a periodic check that the Qakka deployment is reachable and that critical queues exist. The agent calls /status to confirm the service is up and GET /queues to verify the expected queues are registered, alerting on absence. Useful in operations dashboards for self-hosted Apache Usergrid clusters.

GET /status every 60 seconds and alert if the response is not healthy, plus GET /queues and alert if a required queue name is missing

Provision a queue from automation

Create and configure a Qakka queue from an infrastructure agent rather than a manual call. The agent POSTs to /queues with the queue name, then PATCHes /queues/{queueName}/config with retention and visibility settings, and verifies via GET /queues/{queueName} that the queue is registered correctly.

POST {name: 'invoices'} to /queues, then PATCH /queues/invoices/config with retention and visibility values and confirm via GET /queues/invoices

AI agent integration via Jentic

An agent that needs to enqueue work into a self-hosted Qakka deployment can search Jentic for 'send a message to a queue' and Jentic returns the schema for /queues/{queueName}/messages. The deployment URL is held by Jentic, so the agent only supplies the queue name and the message body.

Search Jentic for 'send a message to a Qakka queue', load the /queues/{queueName}/messages schema, and POST the message body for the user-named queue

Key Endpoints

10 endpoints — qakka is the queue system originally developed inside the apache usergrid project.

METHOD

PATH

DESCRIPTION

GET

/queues

List queues on the deployment

POST

/queues

Create a new queue

GET

/queues/{queueName}

Fetch a single queue

POST

/queues/{queueName}/messages

Enqueue a message into a queue

GET

/queues/{queueName}/messages

Receive messages from a queue

GET

/queues/{queueName}/messages/{queueMessageId}

Fetch a specific queued message by id

GET

/status

Health probe for the Qakka service

GET

/queues

List queues on the deployment

POST

/queues

Create a new queue

GET

/queues/{queueName}

Fetch a single queue

POST

/queues/{queueName}/messages

Enqueue a message into a queue

GET

/queues/{queueName}/messages

Receive messages from a queue

GET

/queues/{queueName}/messages/{queueMessageId}

Fetch a specific queued message by id

GET

/status

Health probe for the Qakka service

Why Jentic?

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

Setup

Wiring Qakka by hand means pointing at your own deployment, since the spec declares no security scheme, and mapping the queue lifecycle, enqueue, dequeue, and acknowledge routes yourself. Through Jentic you install once, import Qakka from the API Directory, store any deployment credential once, and your agent calls it.

Permission scoping

Qakka puts the queue name in the URL path (/queues/{queueName}/messages), so a rule can pin your agent to one queue: it can enqueue and dequeue for that queue and nothing else. You choose the operations it may call, so queue creation is only included if you add it.

Credential isolation

Any deployment-level token or proxy credential for Qakka 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 'send a message to a queue' or 'list queues', and Jentic returns the matching Qakka operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Qakka API through Jentic.

What authentication does the Qakka API use?

The OpenAPI spec does not declare any security schemes, so authentication is whatever the Qakka deployment puts in front of the service (typically a network-level control or a reverse proxy enforcing a bearer token). Through Jentic any deployment-level credential can be stored in the encrypted Jentic One instance.

Can I send and receive messages with the Qakka API?

Yes. POST to /queues/{queueName}/messages enqueues a message and GET on the same path receives messages for a worker to process. After processing, acknowledge the specific message id via /queues/{queueName}/messages/{queueMessageId}.

How do I enqueue a message through Jentic?

Search Jentic for 'send a message to a Qakka queue', load the schema for POST /queues/{queueName}/messages, and execute it with the queue name and message body. Jentic resolves the deployment URL and any auth attached to the integration.

What are the rate limits for the Qakka API?

Qakka itself does not declare rate limits; throughput is bounded by the deployment's hosts and the underlying storage. Limits in practice come from any reverse proxy or load balancer in front of the service.

Is the Qakka API free to use?

Qakka is part of the Apache Usergrid project and is open source under the Apache 2.0 license, so the API is free. Costs are the infrastructure to run it.

Does Qakka guarantee message ordering or exactly-once delivery?

The spec defines enqueue, receive, and acknowledgement primitives but does not promise strict ordering or exactly-once semantics; Qakka is at-least-once, like most lightweight queues. Consumers need to be idempotent on the queueMessageId.

Can I limit what my agent is allowed to do with the Qakka API?

Yes. Because Jentic One is self-hosted, your own rules decide which Qakka operations and credentials the agent may use. Since Qakka puts the queue name in the URL path (/queues/{queueName}/messages), a rule can pin the agent to a single queue so it can only enqueue and dequeue messages there. You also choose which operations are exposed, so queue creation and configuration are available to the agent only if you explicitly include them.

Apache Qakka

Name: Qakka API
Brand: Qakka
Availability: InStock

Browse all Apache APIs

Official vendor OpenAPI document · agent-readyDeveloper ToolsMonitoring Observabilitynone10 Endpoints

For Agents

Create and configure queues, send and receive messages, and acknowledge processed messages on a self-hosted Qakka deployment.

Use for: I need to create a new Qakka queue, Send a message to a Qakka queue, Receive messages from a Qakka queue for processing, Acknowledge that a Qakka message has been processed

Not supported: Does not handle pub-sub topics, stream processing, or persistent log replay - use for queue lifecycle, message enqueue and dequeue, and acknowledgement only.

Qakka is the queue system originally developed inside the Apache Usergrid project. The HTTP API exposes queue lifecycle (create, configure, delete), message enqueue and dequeue, single-message lookup, acknowledgement, and a status endpoint. The surface is small (ten operations) and is intended for service-to-service messaging where a lightweight queue is enough and a full broker like Kafka or RabbitMQ would be overkill. The spec does not declare authentication or a base server URL; both are set by the deployment.

Jentic One on Github View OpenAPI Document

Connect the Qakka to your agent

Capabilities

Start building with Qakka API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Apache Qakka