Cyfe Push API

Name: Cyfe Push API
Brand: Cyfe Push API
Availability: InStock

✓ Official Vendor SpecAnalyticsBusiness Intelligencenone1 EndpointsREST

For Agents

Push custom metric data points into a Cyfe dashboard widget so an agent's own measurements show up in a shared business dashboard.

Install Jentic One Beta

Connect the Cyfe Push API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Cyfe Push 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 Cyfe Push API.

Push a single time-series data point into a Cyfe custom widget by widget ID

Stream batch metric updates as JSON payloads to keep a dashboard widget current

Backfill historical data into a Cyfe widget by including explicit date fields in the payload

GET STARTED

Start building with Cyfe Push API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Cyfe Push API for, with concrete tasks.

★ Custom KPI Dashboard Feed

A team running a Cyfe dashboard for executives wants to add a metric that is not covered by Cyfe's prebuilt connectors, such as agent-completed support tickets or model-cost-per-task. They configure a custom widget, take its push URL, and have a scheduled agent POST the latest value once an hour. The widget renders alongside the platform's native integrations without any custom dashboard code.

POST {"data":[{"Date":"2026-06-10","Tickets":42}]} to /api/push/{widget_id} once per hour.

Historical Backfill Into a New Widget

When a team adds a new Cyfe widget mid-quarter, they need the chart to start with historical context rather than a single fresh data point. The Push API accepts an array of dated entries, so an agent can iterate through the past 30 or 90 days of stored values and POST them in one or two requests, populating the widget's history.

Build a JSON array of 30 daily values from the data warehouse and POST it to /api/push/{widget_id} as a single request.

Agent-Driven Operational Metrics

An AI agent supervising a fleet of automation jobs publishes its own observability metrics to a Cyfe widget so non-technical stakeholders can see throughput and success rate without opening logs. The agent reads its own state, computes the metric, and pushes the value, turning agent activity into a first-class dashboard tile.

Read the agent's task log for the last hour, compute success rate, and POST {"data":[{"Date":"NOW","SuccessRate":97.2}]} to /api/push/{widget_id}.

Key Endpoints

1 endpoints — cyfe is a business dashboard platform that aggregates kpis from marketing, sales, finance, and product systems into a single view.

METHOD

PATH

DESCRIPTION

POST

/api/push/{widget_id}

Push data to a Cyfe custom dashboard widget

POST

/api/push/{widget_id}

Push data to a Cyfe custom dashboard widget

Why Jentic?

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

Credential isolation

The per-widget Cyfe push URL is treated as a secret. Jentic stores it encrypted in the vault and the agent only ever receives a scoped runtime credential when executing /api/push/{widget_id}, keeping the widget URL out of prompt history and logs.

Intent-based discovery

Agents search Jentic for 'push data to a Cyfe dashboard' and Jentic returns the single POST /api/push/{widget_id} operation with its input schema, so the agent can construct the payload without reading the Cyfe Push API docs.

Time to first call

Direct Cyfe Push integration: about an hour to read docs, build the payload, and test. Through Jentic: under 10 minutes — search, load schema, execute.

FAQs

Specific to using Cyfe Push API through Jentic.

What authentication does the Cyfe Push API use?

Cyfe's Push API uses a per-widget URL token rather than a global API key. Each custom widget has its own widget_id which is treated as a shared secret in the URL path. Through Jentic the widget URL is stored in the encrypted vault and surfaced to the agent as a scoped runtime credential, so the raw URL never lands in chat history.

Can I push multiple data points in one Cyfe API call?

Yes. The /api/push/{widget_id} endpoint accepts an array under the data key, so you can send a batch of dated entries in a single POST. This is how historical backfill works when you add a new widget mid-quarter.

What are the rate limits for the Cyfe Push API?

Cyfe does not document explicit rate limits for the Push API in the spec. The platform's published guidance is to push no more frequently than once per minute per widget; for higher-frequency telemetry, batch values into a single payload rather than firing many small requests.

How do I publish an agent's KPI to Cyfe through Jentic?

Install pip install jentic and run an agent with the search query 'push data to a Cyfe dashboard widget'. Jentic returns the POST /api/push/{widget_id} operation with its input schema; the agent constructs the JSON payload (Date, plus one or more numeric fields) and calls execute.

Can I read data back from a Cyfe widget through this API?

No. The Push API is write-only. There is no endpoint for retrieving widget contents, dashboards, or account metadata; the only operation exposed is POST /api/push/{widget_id}.

Is the Cyfe Push API free?

Push API access is included with all paid Cyfe plans, including the entry-level Starter tier. Cyfe has historically offered a free tier with a small number of widgets which also includes Push API support, so single-widget integrations can run at no cost.