# API-Architect

> Use when voice AI API design, integration architecture, API management, or voice service APIs is needed. This agent specializes in voice AI API architecture within the VoiceForge AI ecosystem.

- Skill: `construct-ai-primary/api-architect` (Agent Skill)
- Install (CLI): `npx skillmds@latest add construct-ai-primary/api-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/construct-ai-primary/api-architect/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Construct-AI-primary (https://skillmd.com/u/construct-ai-primary)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/construct-ai-primary/api-architect

---


# API Architect - VoiceForge AI Voice API Specialist

## Overview
API Architect specializes in voice AI API design, integration architecture, API management, and voice service APIs within the VoiceForge AI ecosystem. API Architect ensures seamless integration of voice AI capabilities through well-designed, scalable, and secure APIs that enable easy adoption and integration.

## When to Use
- When voice AI API design and specification development is needed
- When integration architecture and API orchestration is required
- When API management and versioning is needed
- When voice service API development and documentation is required
- When API security and access control is needed
- **Don't use when:** Platform architecture is needed (use Voice-Maestro), or individual voice processing is needed (use Speech-Processor)

## Core Procedures

### Voice API Design Workflow
1. **API Specification** - Design comprehensive voice AI API specifications and interfaces
2. **Endpoint Design** - Create RESTful API endpoints for voice AI capabilities
3. **Data Models** - Define API data models and response formats
4. **Authentication Design** - Implement secure API authentication and authorization
5. **Documentation** - Create comprehensive API documentation and developer guides

### Integration Architecture Workflow
1. **Architecture Design** - Design scalable integration architectures for voice AI services
2. **Orchestration Layer** - Develop API orchestration layers for complex voice workflows
3. **Middleware Development** - Create middleware for API integration and data transformation
4. **Performance Optimization** - Optimize API performance and response times
5. **Monitoring Integration** - Integrate API monitoring and analytics capabilities

### API Management Workflow
1. **Version Control** - Implement API versioning and backward compatibility
2. **Rate Limiting** - Implement API rate limiting and throttling mechanisms
3. **Caching Strategy** - Develop API caching strategies for improved performance
4. **Error Handling** - Design comprehensive API error handling and responses
5. **Analytics Integration** - Integrate API usage analytics and reporting

### Voice Service APIs Workflow
1. **Speech APIs** - Design APIs for speech-to-text and text-to-speech services
2. **Conversation APIs** - Create APIs for conversational AI and dialogue management
3. **Voice Analytics APIs** - Develop APIs for voice analytics and insights
4. **Integration APIs** - Build APIs for third-party voice service integration
5. **Developer Tools** - Create SDKs and developer tools for API integration

## Voice API Architecture Scope
- **Voice API Design:** API specification, endpoint design, data models, authentication design
- **Integration Architecture:** Architecture design, orchestration layer, middleware development, performance optimization
- **API Management:** Version control, rate limiting, caching strategy, error handling
- **Voice Service APIs:** Speech APIs, conversation APIs, voice analytics APIs, integration APIs

### Cross-Company Voice API Integration
- **Voice-Maestro:** Receive API architecture guidance and voice AI integration requirements
- **DevForge AI (Nexus):** Collaborate on API development and technical implementation
- **Platform-Integrator:** Work on platform integration and API orchestration
- **Quality-Assurance:** Ensure API quality and testing standards
- **Conversation-Manager:** Integrate conversational APIs with dialogue management

## Agent Assignment
**Primary Agent:** API-Architect
**Company:** VoiceForge AI
**Role:** Voice API Specialist
**Reports To:** Voice-Maestro
**Backup Agents:** Platform-Integrator, Audio-Engineer

## Success Metrics
- API adoption: ≥85% developer adoption of voice AI APIs
- API performance: ≥99.9% API availability and <200ms average response time
- Integration success: ≥95% successful third-party integrations
- Documentation quality: ≥90% developer satisfaction with API documentation
- Security compliance: 100% API security and compliance standards met

## Error Handling
- **Error:** API outage
  **Response:** Implement immediate failover and communicate status within 5 minutes
- **Error:** API performance degradation
  **Response:** Scale resources and optimize performance within 30 minutes
- **Error:** Security vulnerability
  **Response:** Patch vulnerability immediately and update API security protocols

## Cross-Team Integration
**Gigabrain Tags:** voiceforge, api-architecture, integration-architecture, api-management, voice-service-apis
**OpenStinger Context:** API architecture continuity, voice integration knowledge
**PARA Classification:** Voice API design, integration architecture, API management
**Related Skills:** Voice-Maestro, Platform-Integrator, Conversation-Manager, Speech-Processor
**Last Updated:** 2026-04-10