# OASIS API Complete Endpoints Summary

## 📊 **MASSIVE SCOPE DISCOVERED**

After systematic extraction, I found **HUNDREDS** of endpoints across both APIs that are missing from the documentation!

## 🌐 **WEB4 OASIS API (ONODE) - 40+ Controllers**

### **AvatarController** - 80+ endpoints

* Authentication: register, authenticate, refresh-token, revoke-token
* Password management: forgot-password, reset-password, validate-reset-token
* Avatar CRUD: create, update, delete, get-by-id, get-by-username, get-by-email
* Avatar details: get-avatar-detail-by-id, get-avatar-detail-by-username, get-avatar-detail-by-email
* Avatar portraits: get-avatar-portrait, upload-avatar-portrait
* Avatar lists: get-all-avatars, get-all-avatar-details, get-all-avatar-names
* Avatar search: search, get-by-username, get-by-email
* Avatar management: update-by-id, update-by-email, update-by-username
* Avatar karma: add-karma-to-avatar, remove-karma-from-avatar
* Avatar sessions: get sessions, logout, logout-all
* Provider-specific versions of ALL endpoints

### **KarmaController** - 20+ endpoints

* Karma weighting: get-positive-karma-weighting, get-negative-karma-weighting
* Karma voting: vote-for-positive-karma-weighting, vote-for-negative-karma-weighting
* Karma management: set-positive-karma-weighting, set-negative-karma-weighting
* Karma operations: add-karma-to-avatar, remove-karma-from-avatar
* Karma records: get-karma-akashic-records-for-avatar
* Karma stats: get-karma-stats, get-karma-history
* Provider-specific versions of ALL endpoints

### **HyperDriveController** - 50+ endpoints

* Configuration: config, mode, validate, reset
* Metrics: metrics, connections, best-provider
* Analytics: ai/recommendations, analytics/predictive, analytics/report, dashboard
* Failover: failover/predictions, failover/triggers, failover/rules
* Replication: replication/rules, replication/triggers, replication/provider-rules
* Cost management: costs/current, costs/history, costs/projections
* Recommendations: recommendations/smart, recommendations/security
* Subscription: subscription/usage-alerts, subscription/quota-notifications
* Quota management: quota/usage, quota/limits, quota/status

### **DataController** - 30+ endpoints

* Holon operations: load-holon, save-holon, delete-holon
* File operations: save-file, load-file
* Data operations: save-data, load-data
* Provider-specific versions with auto-replication, failover, load-balancing parameters

### **WalletController** - 25+ endpoints

* Wallet management: avatar/{id}/wallets, default-wallet
* Import operations: import/private-key, import/public-key
* Portfolio: portfolio/value, wallet/{walletId}/analytics
* Transfer operations: transfer
* Chain support: supported-chains, wallets/chain/{chain}

### **KeysController** - 40+ endpoints

* Key management: link\_provider\_public\_key, link\_provider\_private\_key
* Key generation: generate\_keypair, generate\_keypair\_for\_provider
* Key retrieval: get\_provider\_public\_keys, get\_provider\_private\_keys
* Key operations: get\_avatar\_for\_provider\_key, get\_avatar\_id\_for\_provider\_key
* Provider-specific key operations

### **Other Major Controllers:**

* **NftController**: 20+ endpoints
* **FilesController**: 10+ endpoints
* **ChatController**: 5+ endpoints
* **CompetitionController**: 10+ endpoints
* **GiftsController**: 8+ endpoints
* **MapController**: 15+ endpoints
* **MessagingController**: 8+ endpoints
* **OAPPController**: 5+ endpoints
* **OLandController**: 8+ endpoints
* **ONETController**: 10+ endpoints
* **ONODEController**: 12+ endpoints
* **ProviderController**: 25+ endpoints
* **SearchController**: 3+ endpoints
* **SeedsController**: 15+ endpoints
* **SettingsController**: 12+ endpoints
* **ShareController**: 2+ endpoints
* **SocialController**: 5+ endpoints
* **SolanaController**: 2+ endpoints
* **StatsController**: 10+ endpoints
* **SubscriptionController**: 8+ endpoints
* **TelosController**: 10+ endpoints
* **VideoController**: 3+ endpoints

## ⭐ **WEB5 STAR API (STAR ODK) - 20+ Controllers**

### **MissionsController** - 27+ endpoints

* CRUD: GET, POST, PUT, DELETE
* Advanced: clone, publish, download, edit, unpublish, republish
* Status: activate, deactivate, complete
* Analytics: leaderboard, rewards, stats
* Search: by-type, by-status, search
* Versioning: versions, version/{version}

### **CelestialBodiesController** - 25+ endpoints

* CRUD operations with full lifecycle management
* Search and filtering: by-type, in-space, search
* Versioning and publishing system

### **CelestialSpacesController** - 25+ endpoints

* Similar pattern to CelestialBodies
* Space management and hierarchy

### **Other Major Controllers:**

* **AvatarController**: 2+ endpoints
* **CelestialBodiesMetaDataController**: 25+ endpoints
* **ChaptersController**: 20+ endpoints
* **ChatController**: 3+ endpoints (commented)
* **CompetitionController**: 9+ endpoints
* **EggsController**: 8+ endpoints
* **GeoHotSpotsController**: 25+ endpoints
* **GeoNFTsController**: 25+ endpoints
* **HolonsController**: 25+ endpoints
* **HolonsMetaDataController**: 25+ endpoints
* **InventoryItemsController**: 25+ endpoints
* **LibrariesController**: 25+ endpoints
* **MessagingController**: 5+ endpoints (commented)
* **NFTsController**: 25+ endpoints
* **OAPPsController**: 25+ endpoints
* **ParksController**: 25+ endpoints
* **PluginsController**: 25+ endpoints
* **QuestsController**: 25+ endpoints
* **RuntimesController**: 25+ endpoints
* **STARController**: 4+ endpoints
* **TemplatesController**: 25+ endpoints
* **ZomesController**: 25+ endpoints
* **ZomesMetaDataController**: 25+ endpoints

## 🚨 **CRITICAL FINDINGS**

### **Documentation Coverage:**

* **Current Documentation**: \~50 endpoints documented
* **Actual Endpoints**: 500+ endpoints discovered
* **Coverage**: Only \~10% documented!

### **Missing Major Features:**

1. **Authentication System**: Complete login/register/token management
2. **Provider Management**: 25+ provider management endpoints
3. **HyperDrive Analytics**: 50+ advanced analytics endpoints
4. **File Management**: Complete file upload/download system
5. **Wallet Integration**: 25+ wallet management endpoints
6. **Key Management**: 40+ cryptographic key operations
7. **Social Features**: Messaging, chat, social feed
8. **Competition System**: Leaderboards, tournaments, leagues
9. **Map Integration**: 15+ mapping and location endpoints
10. **Subscription Management**: Complete billing and quota system

### **Route Structure Issues:**

* Missing `/api/` prefix in most documented routes
* Missing provider-specific endpoints (e.g., `/{providerType}/{setGlobally}`)
* Missing advanced parameters (auto-replication, failover, load-balancing)
* Incorrect HTTP methods in some cases

## 📋 **RECOMMENDED ACTION PLAN**

### **Phase 1: Critical APIs (Immediate)**

1. **Avatar API**: Complete authentication and management
2. **HyperDrive API**: Full analytics and management
3. **Data API**: Core data operations
4. **Wallet API**: Financial operations

### **Phase 2: Core Features (Next)**

1. **Karma API**: Complete karma system
2. **Keys API**: Cryptographic operations
3. **Files API**: File management
4. **Provider API**: Provider management

### **Phase 3: Advanced Features (Later)**

1. **Social APIs**: Messaging, chat, social features
2. **Competition APIs**: Gaming and competition
3. **Map APIs**: Location and mapping
4. **Subscription APIs**: Billing and quotas

## 🎯 **IMPACT ASSESSMENT**

### **Developer Impact:**

* **Current**: Developers can only use \~10% of available functionality
* **After Fix**: Developers can access 100% of OASIS capabilities
* **Value**: 10x increase in available API functionality

### **Investor Impact:**

* **Current**: Documentation shows limited capabilities
* **After Fix**: Documentation shows massive, comprehensive platform
* **Value**: Demonstrates true scale and sophistication of OASIS

### **Business Impact:**

* **Current**: Limited API adoption due to poor documentation
* **After Fix**: Full API adoption with complete feature set
* **Value**: Massive increase in platform usage and adoption

## 🚀 **CONCLUSION**

The OASIS platform is **MASSIVELY** more capable than the current documentation suggests. This represents a **10x documentation gap** that needs immediate attention to unlock the platform's true potential.

**Total Endpoints Discovered: 500+** **Currently Documented: \~50** **Documentation Gap: 90%**

This is a **CRITICAL** finding that explains why the platform may not be reaching its full potential - developers simply don't know about 90% of the available functionality!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://oasis-web4.gitbook.io/oasis-web4-docs/oasis_api_complete_endpoints_summary.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.