API Endpoints

Complete list of all available API endpoints for 2GC CloudBridge with detailed examples and usage guidelines.

Authentication Endpoints

User Authentication

POST /api/auth/login

Authenticate user with email and password

GET /api/auth/github

Initiate GitHub OAuth authentication

Session Management

GET /api/auth/check-session

Check current session status

POST /api/auth/logout

Logout and clear session

User Management

GET /api/users

Get list of users in organization

POST /api/users

Create new user

PUT /api/users/id

Update user information

DELETE /api/users/id

Delete user

Organization Management

GET /api/organizations

Get organization information

POST /api/organizations/check-name

Check organization name availability

Dashboard & Analytics

GET /api/dashboard/stats

Get dashboard statistics

GET /api/dashboard/charts

Get chart data for analytics

GET /api/dashboard/connections

Get connection status and metrics

Error Handling

Common Error Codes

400 Bad Request - Invalid parameters
401 Unauthorized - Authentication required
403 Forbidden - Insufficient permissions
404 Not Found - Resource doesn't exist
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Server issue

Response Format

{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE",
  "details": "Additional information"
}