HireFire API

Name: HireFire API
Brand: HireFire API
Availability: InStock

✓ Official Vendor SpecDeveloper ToolsMonitoring Observabilitybearer38 EndpointsREST

For Agents

Configure Heroku dyno autoscaling rules, manage organizations and applications, and set up alert recipients for HireFire-managed scaling events.

Install Jentic One Beta

Connect the HireFire API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HireFire 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://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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 HireFire API.

Configure web and worker autoscaling managers for Heroku applications with custom thresholds

Add and remove Heroku accounts, applications, and team memberships under a HireFire organization

Create alert recipients to receive notifications when scaling events trigger or thresholds breach

GET STARTED

Start building with HireFire API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use HireFire API for, with concrete tasks.

★ Heroku Web Dyno Autoscaling

Platform engineers connect Heroku applications to HireFire and create manager rules that scale web dynos up or down based on request queue time. The API lets agents register the application, attach a manager with target metrics, and confirm the manager is active before traffic events. Setup typically takes minutes per app once the Heroku account is linked.

Create a HireFire manager for application id app_123 with web dyno scaling between 1 and 10 dynos and verify the manager is enabled.

Worker Queue Autoscaling

Background-job heavy services use HireFire to scale Sidekiq, Resque, or custom worker dynos based on job queue length. The API exposes worker-type managers separately from web managers so different queues can scale independently. This avoids over-provisioning idle workers and reduces Heroku spend on bursty workloads.

List all worker-type managers attached to application id app_456 and update the maximum dyno count to 20.

Scaling Alerts and Recipients

Operations teams need notification when scaling events occur or when an application hits its dyno ceiling. HireFire recipients let teams attach email destinations to organizations so on-call engineers see scaling activity in real time. The API supports listing, adding, and removing recipients without touching Heroku itself.

Add ops@example.com as a recipient on organization org_789 and confirm the recipient appears in the recipients list.

Agent-Driven Heroku Cost Control

An AI agent connected via Jentic monitors Heroku spend and dyno utilization, then adjusts HireFire manager thresholds when traffic patterns shift. The agent loads HireFire operations on demand, updates min/max dyno settings, and confirms changes through the API. Credentials stay in the Jentic vault so the agent never holds the bearer token directly.

Reduce the maximum dyno count on application id app_999 from 15 to 8 during a low-traffic time range and verify the update succeeded.

Key Endpoints

38 endpoints — hirefire automates dyno scaling for heroku applications based on web request queue time and worker job metrics.

METHOD

PATH

DESCRIPTION

GET

/organizations

List organizations

GET

/organizations/{id}/users

List users in an organization

POST

/memberships

Create a membership

GET

/organizations/{id}/memberships

List memberships in an organization

GET

/organizations

List organizations

GET

/organizations/{id}/users

List users in an organization

POST

/memberships

Create a membership

GET

/organizations/{id}/memberships

List memberships in an organization

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HireFire bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped execution access — the raw Authorization header value never enters the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'configure heroku autoscaling') and Jentic returns matching HireFire operations with their input schemas, so the agent can call the right endpoint without reading the docs.

Time to first call

Direct HireFire integration: 1-2 days for auth handling and manager schema parsing. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using HireFire API through Jentic.

What authentication does the HireFire API use?

The HireFire API uses bearer token authentication. The API key is passed as a Bearer token in the Authorization header on every request. Through Jentic, the bearer token is stored encrypted in the Jentic vault and injected at execution time so agents never see the raw key.

Can I configure worker dyno autoscaling with the HireFire API?

Yes. The HireFire API exposes manager resources that attach to either web or worker dyno types on a Heroku application. POST a manager with the worker dyno name and your min/max dyno bounds to scale background-job processes independently from web dynos.

What are the rate limits for the HireFire API?

HireFire does not publish hard rate limits in its OpenAPI spec, but recommends staying below a few requests per second per organization. If you hit limiting, the API returns 429 responses; back off and retry. For agent workloads through Jentic, batch reads via GET /organizations/{id}/applications rather than polling individual managers.

How do I create a manager for a Heroku app through Jentic?

Search Jentic for 'configure heroku autoscaling manager', load the POST /organizations operation chain, then call the manager creation endpoint with the application id and dyno bounds. Run pip install jentic and use SearchRequest, LoadRequest, ExecutionRequest from the async client to wire this up in under an hour.

Does the HireFire API support time-based scaling rules?

Yes. The API exposes time range resources that gate when managers are allowed to fire. You can create overlapping time ranges (for example, weekday business hours versus weekend) and attach different scaling thresholds to each, all through CRUD operations on the time range endpoints.