Deployments API

Check whether deployed fixes actually worked in production.

Get Deployment Impact

GET /api/v1/deployments/impact

Query Parameters

Parameter	Type	Default	Description
agentId	string	—	Filter to a specific agent
status	string	—	Filter by verification status: verified, monitoring, not_fixed, regressed, confounded
limit	number	10	Max results to return

Response

{
  "agents": [
    {
      "agentId": "agent_456",
      "agentName": "Customer Support Agent",
      "verificationStatus": "verified",
      "reductionPercent": 62,
      "postFixConversationCount": 47,
      "issues": [
        {
          "issueId": "issue_123",
          "title": "Incorrect refund policy",
          "beforeFailCount": 18,
          "afterFailCount": 7
        }
      ],
      "answerComparison": {
        "before": "Our refund policy is 14 days.",
        "after": "Our refund policy is 30 days for all purchases."
      }
    }
  ],
  "summary": {
    "totalDeployments": 12,
    "verified": 7,
    "monitoring": 3,
    "notFixed": 1,
    "regressed": 0,
    "confounded": 1
  }
}

Example

# Get all deployment impact data
curl https://converra.ai/api/v1/deployments/impact \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter by status
curl "https://converra.ai/api/v1/deployments/impact?status=verified&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter by agent
curl "https://converra.ai/api/v1/deployments/impact?agentId=agent_456" \
  -H "Authorization: Bearer YOUR_API_KEY"

SDK Usage

const impact = await converra.deployments.getImpact({
  status: 'verified',
  limit: 5
});

console.log('Verified fixes:', impact.summary.verified);
for (const agent of impact.agents) {
  console.log(`${agent.agentName}: ${agent.reductionPercent}% reduction`);
}

---

Verification Statuses

Status	Description
verified	Fix confirmed working — >50% failure reduction observed
monitoring	Post-fix observation in progress, not enough data yet
not_fixed	Issue persists after fix was deployed
regressed	Previously verified fix is regressing
confounded	Cannot verify — agent was edited independently outside Converra

---

Response Fields

Agent Object

Field	Type	Description
agentId	string	Agent identifier
agentName	string	Agent display name
verificationStatus	string	Current verification status
reductionPercent	number	Percentage reduction in failures post-fix
postFixConversationCount	number	Conversations observed since fix was deployed
issues	array	Per-issue verification results
answerComparison	object	Before/after answer examples showing the fix

Issue Object

Field	Type	Description
issueId	string	Issue identifier
title	string	Issue description
beforeFailCount	number	Failures before the fix
afterFailCount	number	Failures after the fix

Summary Object

Field	Type	Description
totalDeployments	number	Total tracked deployments
verified	number	Fixes confirmed working
monitoring	number	Fixes still being observed
notFixed	number	Fixes that did not resolve the issue
regressed	number	Fixes that regressed
confounded	number	Fixes that cannot be verified

---

Error Responses

Unauthorized

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

Status: 401 Unauthorized

---

Related

• Webhooks - Deployment verification webhook events
• Insights - Agent performance insights