Blackfire API

Name: Blackfire API API
Brand: Blackfire API
Availability: InStock

✓ Official Vendor SpecDeveloper ToolsMonitoring Observabilitybasic11 EndpointsREST

For Agents

Read Blackfire profiles, manage performance test builds, and inspect the environments and organizations being profiled. Useful for agents that gate deploys on performance assertions.

Quickstart

Get started with Blackfire 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:
"create a Blackfire build for a performance test"

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

Capabilities

What an agent can do with Blackfire API API.

Fetch a captured Blackfire profile by UUID for inspection or archiving

Create and retrieve Blackfire builds to gate CI on performance assertions

Pull the build report to see whether performance tests passed or regressed

List and update the environments that Blackfire is watching

GET STARTED

Start building with Blackfire API API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Blackfire API API for, with concrete tasks.

★ CI Gate on Performance Regressions

Wire a Blackfire build into a CI job to fail the pipeline when performance assertions regress. The integration calls POST /builds to create a build, runs the test scenario against the profiled application, then polls GET /builds/{uuid}/report for the assertion results. If the report flags regressions the CI step exits non-zero, blocking the merge until the underlying performance issue is fixed.

POST /builds with the target environment, wait for the build to complete, GET /builds/{uuid}/report and exit non-zero if any assertion failed.

Profile Triage Workflow

When a production performance issue is reported, an engineer or agent fetches the relevant Blackfire profile by UUID, inspects the captured trace, and posts a summary to the incident channel. GET /profiles/{uuid} returns the profile data and DELETE /profiles/{uuid} cleans it up after the issue is resolved. This shortcuts the manual click-through in the Blackfire UI.

Call GET /profiles/{uuid} for the supplied profile id, summarise the top three hotspots, and post the summary to a Slack channel.

Environment Configuration Audit

Use GET /environments and GET /environments/{uuid} to enumerate the Blackfire environments a team is monitoring, and PUT /environments/{uuid} to bring drifted settings back to a known baseline. This is useful when onboarding a new service or running a quarterly observability hygiene check across an organization's environments.

Call GET /environments, compare each environment's settings against the team baseline, and PUT updates to environments that have drifted.

Organization Access Review

Pull GET /organizations/{uuid}/members to review who has access to the Blackfire organization and cross-reference against the source-of-truth identity directory. Off-boarding workflows use the same endpoint to confirm that ex-employees no longer appear in the member list. This keeps performance-data access in line with broader access-management policy.

Call GET /organizations/{uuid}/members, diff the result against the HR active-employee list, and report any orphaned accounts.

Agent-Driven Performance Check via Jentic

An AI agent investigating a slow endpoint searches Jentic for a Blackfire build operation, kicks off a performance test, and reports the assertion outcome back to the engineer who triggered the request. Jentic stores the Blackfire Server ID and Token in its vault, so the agent never sees the raw HTTP basic credentials. This lets engineering chat-ops trigger profiling without copy-pasting secrets.

Use Jentic search for 'create a Blackfire build for a performance test', load the schema, then execute POST /builds and report the build report status when complete.

Key Endpoints

11 endpoints — the blackfire api is the programmatic surface for blackfire, a continuous observability and performance testing platform for php, python, go, and node.

METHOD

PATH

DESCRIPTION

GET

/profiles/{uuid}

Fetch a profile by UUID

POST

/builds

Create a performance test build

GET

/builds/{uuid}/report

Get the build assertion report

GET

/environments

List configured environments

PUT

/environments/{uuid}

Update an environment

GET

/organizations/{uuid}/members

List organization members

GET

/profiles/{uuid}

Fetch a profile by UUID

POST

/builds

Create a performance test build

GET

/builds/{uuid}/report

Get the build assertion report

GET

/environments

List configured environments

PUT

/environments/{uuid}

Update an environment

Why though Jentic?

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

Credential isolation

Blackfire uses HTTP basic auth with a Server ID and Server Token. Jentic stores both in the encrypted vault and exposes a scoped token to the agent — the raw credentials never enter the agent's prompt or logs, which matters because the same token grants access to all profiles in the workspace.

Intent-based discovery

Agents search Jentic with intents like 'fetch a Blackfire profile' or 'create a Blackfire build' and Jentic returns the matching operation from the 11-endpoint spec with its input schema and required path parameters.

Time to first call

Direct integration with Blackfire: roughly a day to handle basic auth, build polling, and report parsing. Through Jentic: under an hour — search the operation, load schema, execute against /builds and /profiles.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

BlazeMeter

BlazeMeter focuses on load testing while Blackfire focuses on code-level profiling.

Choose BlazeMeter for traffic generation and load benchmarks; choose Blackfire for code-level performance profiling and assertions.

Complementary

Black Kite

Black Kite scores third-party security risk while Blackfire monitors application performance — both feed risk dashboards.

Use them together when an SRE dashboard needs both performance health and third-party security posture.

Complementary

Bland AI

Bland AI handles voice automation that could trigger an on-call profile review when Blackfire reports regression.

Useful for automating phone-based on-call escalation when Blackfire build assertions fail.

FAQs

Specific to using Blackfire API API through Jentic.

What authentication does the Blackfire API use?

HTTP basic authentication. The Server ID is the username and the Server Token is the password (security scheme name BasicAuth in the spec). Through Jentic both values are stored in the encrypted vault and the agent receives a scoped token instead of the raw Server ID and Token.

Can I create a Blackfire build for a CI job with this API?

Yes. POST /builds creates a build, and GET /builds/{uuid}/report returns the assertion outcome. CI jobs use this pair to gate merges on performance regressions, polling the report endpoint until the build is complete.

How do I fetch a Blackfire profile?

Call GET /profiles/{uuid} with the profile id from the Blackfire UI or from a build report. The response contains the profile data; DELETE /profiles/{uuid} removes it when no longer needed.

What are the rate limits for the Blackfire API?

The OpenAPI spec does not declare a published rate limit. Treat the API as paced for CI and dashboard usage rather than high-volume polling, and back off on HTTP 429 responses if your CI fan-out grows.

How do I run a Blackfire performance check through Jentic?

Install with pip install jentic, then use Jentic search with 'create a Blackfire build for a performance test'. Load the POST /builds schema, execute it, then call GET /builds/{uuid}/report to retrieve the assertion outcome. Jentic resolves both calls without exposing the Server ID and Token.

Which languages does the Blackfire API cover?

Blackfire profiles PHP, Python, Go, and Node.js applications. The API itself is language-agnostic — the same endpoints (profiles, builds, environments) work for all four runtimes; the language-specific work happens in the Blackfire agent on the host.