Cyfe Push API

Name: Cyfe Push API 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.

Quickstart

Get started with Cyfe Push API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"push data to a Cyfe dashboard widget"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Cyfe Push API 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

Pipe agent-generated KPIs into an existing Cyfe dashboard without writing a Cyfe connector

GET STARTED

Start building with Cyfe Push API API

Explore with Jentic

View OpenAPI Document

Use for: I need to push a daily revenue total into a Cyfe widget, Send weekly active user counts to a Cyfe dashboard, Update a Cyfe custom widget with the latest agent task completion rate, Backfill the last 30 days of conversion data into Cyfe

Not supported: Does not handle dashboard creation, widget configuration, or read-back of stored data — use for pushing custom metric values into existing Cyfe widgets only.

Use Cases

Patterns agents use Cyfe Push API 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 though 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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Geckoboard API

Dashboard service with a similar push-based custom widget model and richer visualisation options.

Choose Geckoboard when the dashboard needs richer chart types or alerting; choose Cyfe when an existing Cyfe deployment is already in use.

Complementary

Mixpanel API

Product analytics events that can be aggregated and pushed into a Cyfe dashboard summary.

Use Mixpanel to capture raw user events; aggregate them daily and push the summary to a Cyfe widget for an exec dashboard.

Complementary

HubSpot Marketing Events API

CRM and marketing event data to roll up into a Cyfe revenue or pipeline widget.

Pull pipeline numbers from HubSpot, summarise them, and push the totals into a Cyfe sales dashboard widget.

FAQs

Specific to using Cyfe Push API 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.