Skip to main content
Bluejay provides APIs for testing, monitoring, and improving conversational AI agents across voice and chat workflows.

Base URL

https://api.getbluejay.ai/v1

Authentication

Sign up for a Bluejay Account and generate an API key from the API Keys page. If you do not have a Bluejay account, book a demo here to receive one. Use that key to authenticate requests to the Bluejay API.

Start here

Run simulations

Queue realistic simulation runs to evaluate agents before they reach production.

Evaluate production calls

Measure quality, latency, and behavior in live conversations with observability workflows.

Manage agents

Create, update, and organize the agents that power your evaluation workflows.

Subscribe to webhooks

Push results and event data into downstream systems when runs complete.

Running a Simulation via API

1

Add Agent

Add your agent to Bluejay if you haven’t already.
2

Create Simulation

Create a simulation to group your Digital Humans so you can run them in parallel.
3

Generate or Create Digital Humans

Generate or create Digital Humans. Make sure to attach the Simulation ID so the Digital Humans are associated with the Simulation you created in Step 2.
4

Queue Simulation Run

Queue a simulation run to trigger the simulation — think of this as the Run button.

Integrating Observability

1

Add Agent

Add your agent to Bluejay if you haven’t already.
2

Define Custom Metrics

Create custom metrics that capture the quality signals you care about — resolution rate, tone, compliance, or anything specific to your use case.
3

Send Calls to Evaluate

Call the evaluate endpoint with a recording URL or transcript from your production calls. Bluejay scores each call against your agent’s configured metrics.
4

Review Results

Retrieve call logs to inspect scores, latency data, and per-metric breakdowns across your evaluated conversations.

Core API areas

  • Agents: create and manage the systems you want to evaluate.
  • Simulations: define test scenarios, digital humans, and simulation runs.
  • Observability: evaluate live calls, logs, and quality signals.
  • Workflows: automate evaluation and operational follow-up.
  • Webhooks: stream Bluejay events into your own tooling.