AgentCore API Documentation

Welcome to AgentCore API Gateway

AgentCore API Gateway provides a unified, high-performance entry point for all interactions with the AgentCore platform. Built on FastAPI, it delivers 60,000+ requests/second with enterprise-grade security and developer-friendly documentation.

Quick Start in 3 Steps:

Authenticate: POST /auth/token with username/password
Get Token: Copy the access_token from response
Make Requests: Include token in Authorization: Bearer TOKEN header

Demo credentials: username: user, password: user123

🔐 Authentication

JWT tokens with RS256 signing
OAuth 2.0 (Google, GitHub, Microsoft)
Enterprise SSO (SAML, LDAP)
Automatic token refresh
Session management

⚡ High Performance

60,000+ requests/second
<5ms routing latency
10,000+ concurrent WebSocket connections
Async/await architecture
Connection pooling

🛡️ Security

Rate limiting per IP/user/endpoint
DDoS protection with auto-blocking
Input validation (XSS, SQL injection)
Security headers (HSTS, CSP, etc.)
TLS 1.3 support

📡 Real-time

WebSocket support
Server-Sent Events (SSE)
Event subscriptions
Automatic reconnection
Heartbeat monitoring

🔍 Observability

Prometheus metrics
Structured logging
Distributed tracing
Request/response logging
Performance monitoring

👨‍💻 Developer Experience

OpenAPI 3.0 specification
Interactive Swagger UI
Code examples (Python, JS, cURL)
<10 minute onboarding
Comprehensive error messages

📚 Documentation

Getting Started Guide - Quick 10-minute tutorial
Authentication Guide - JWT, OAuth, and SSO setup
Rate Limiting Guide - Policies and best practices
Real-time Communication - WebSocket and SSE usage
Error Handling - Error codes and troubleshooting

💻 Code Examples

Python Client - Full-featured Python SDK
JavaScript Client - Browser and Node.js compatible
cURL Examples - Command-line examples

🔗 API Endpoints

/docs - Interactive Swagger UI
/redoc - Alternative API documentation
/openapi.json - OpenAPI specification
/health - Health check endpoint
/metrics - Prometheus metrics