API Changelog
| Field | Value |
|---|---|
| Document ID | ASCEND-REF-001 |
| Version | 1.0.0 |
| Last Updated | December 19, 2025 |
| Author | Ascend Engineering Team |
| Publisher | OW-KAI Technologies Inc. |
| Classification | Enterprise Client Documentation |
| Compliance | SOC 2 CC6.1/CC6.2, PCI-DSS 7.1/8.3, HIPAA 164.312, NIST 800-53 AC-2/SI-4 |
Reading Time: 5 minutes | Skill Level: All Levels
Current Version
API Version: v1
Base URL: https://pilot.owkai.app/api/v1
Version History
v1.5.0 (December 2025)
New Features
-
MCP Governance - Full Model Context Protocol support
POST /api/mcp/servers/register- Register MCP serversPOST /api/mcp/evaluate- Evaluate MCP tool callsGET /api/mcp/servers- List registered serversPUT /api/mcp/servers/{id}/trust- Set trust levels
-
Data Rights API - GDPR/CCPA compliance
POST /api/data-rights/access/request- Access requestsPOST /api/data-rights/erasure/request- Erasure requestsPOST /api/data-rights/consent/record- Record consentGET /api/data-rights/requests/{id}- Request status
-
BYOK (Bring Your Own Key) - Customer-managed encryption
POST /api/byok/configure- Configure BYOKPOST /api/byok/rotate- Rotate keysGET /api/byok/status- Encryption status
Improvements
- Reduced action submission latency by 30%
- Enhanced risk assessment with new PII detection
- Improved audit log query performance
Breaking Changes
None
v1.4.0 (November 2025)
New Features
-
Agent Health Monitoring
POST /api/agents/{id}/heartbeat- Send heartbeatGET /api/agents/{id}/health- Health status- Automatic health degradation detection
-
Notification Channels
POST /api/notifications/channels- Create channelPOST /api/notifications/channels/{id}/test- Test delivery- Slack and Teams support
-
Smart Alerts
GET /api/alerts/active- Active alertsPOST /api/alerts/{id}/acknowledge- Acknowledge- WebSocket streaming:
ws://pilot.owkai.app/api/alerts/stream
Improvements
- Added
processing_time_msto action responses - Enhanced webhook retry logic (exponential backoff)
- Improved error messages with resolution hints
Deprecations
GET /api/agents/status→ UseGET /api/agents/{id}/health
v1.3.0 (October 2025)
New Features
-
Compliance Export
POST /api/compliance-export/exports- Generate reportsGET /api/compliance-export/exports/{id}- Download- SOC 2, HIPAA, PCI-DSS templates
-
Bulk Operations
POST /api/v1/actions/bulk- Submit multiple actionsPOST /api/governance/bulk-decision- Bulk approve/deny
-
Analytics Enhancements
GET /api/analytics/risk-trends- Risk score trendsGET /api/analytics/agent-performance- Agent metrics
Improvements
- Increased rate limits for Enterprise tier
- Added
correlation_idsupport for request tracing - Enhanced audit log filtering
v1.2.0 (September 2025)
New Features
-
SSO Support
- SAML 2.0 integration
- OIDC support
- JIT user provisioning
-
Multi-Tenant Isolation
- Row-Level Security enabled
- Per-tenant encryption keys
- Organization-scoped API keys
Improvements
- Reduced P99 latency to 250ms
- Enhanced smart rule condition operators
- Improved documentation
v1.1.0 (August 2025)
New Features
-
Smart Rules Engine
POST /api/smart-rules- Create rules- Conditional logic support
- Priority-based evaluation
-
Agent Kill Switch
POST /api/agents/{id}/kill- Emergency stopPOST /api/agents/{id}/reactivate- Resume
-
Webhook System
POST /api/webhooks- Create webhook- HMAC signature verification
- Retry with exponential backoff
Improvements
- Added
metadatafield to actions - Enhanced error responses
- Improved rate limit headers
v1.0.0 (July 2025)
Initial Release
-
Actions API
POST /api/v1/actions- Submit actionGET /api/v1/actions/{id}- Get actionPOST /api/v1/actions/{id}/approve- ApprovePOST /api/v1/actions/{id}/deny- Deny
-
Agents API
POST /api/agents/register- Register agentGET /api/agents- List agentsGET /api/agents/{id}- Get agent
-
Authentication
- API key authentication
- JWT token authentication
- MFA support
-
Risk Assessment
- Automatic risk scoring
- Configurable thresholds
- Risk factor breakdown
Deprecation Policy
- Notice Period: 6 months minimum
- Migration Support: Documentation and examples provided
- Sunset Process:
- Deprecation announcement
- Warning headers added
- Rate limiting on deprecated endpoints
- Endpoint removal
Versioning Strategy
ASCEND follows semantic versioning:
- Major (vX.0.0): Breaking changes
- Minor (v1.X.0): New features, backwards compatible
- Patch (v1.0.X): Bug fixes
API Stability
| Endpoint Category | Stability |
|---|---|
/api/v1/actions | Stable |
/api/agents | Stable |
/api/smart-rules | Stable |
/api/mcp | Beta |
/api/data-rights | Beta |
Migration Guides
Subscribe to Updates
# Get API changelog via webhook
curl -X POST "https://pilot.owkai.app/api/webhooks" \
-H "Authorization: Bearer <admin_jwt>" \
-d '{
"url": "https://your-endpoint.com/webhook",
"events": ["api.changelog"]
}'
Document Version: 1.0.0 | Last Updated: December 2025