Projects

Projects help you organize your API keys and webhooks by Sui network. Each project is tied to a specific network (Mainnet or Testnet), allowing you to separate your development and production resources.

Understanding Projects

Project Hierarchy

Organization
 └── Project (Mainnet)
      └── API Keys
      └── Webhooks
 └── Project (Testnet)
      └── API Keys
      └── Webhooks

Key Concepts

• One Network Per Project: Each project is associated with a single Sui network
• Multiple Projects Per Network: You can create multiple projects for the same network
• Resource Isolation: API keys and webhooks belong to a specific project
• Shared Quota: Credit quota is shared at the organization level, while projects track consumption for visibility

Creating a Project

1. Navigate to Projects in your dashboard
2. Click Create Project
3. Enter a project name (e.g., "Production App", "Staging")
4. Select the network:
   • Mainnet (blue badge) - For production applications
   • Testnet (yellow badge) - For development and testing
5. Click Create Project

Note: A default Mainnet project is automatically created when you create a new organization.

Project Limits by Plan

The number of projects you can create depends on your subscription tier:

Plan	Max Projects
Free	2
Team	5
Professional	10
Business	15
Enterprise	Unlimited

Managing Projects

Switching Between Projects

Use the project selector dropdown in the dashboard header to switch between projects. When you switch projects:

• API Keys list updates to show only keys for that project
• Webhooks list updates to show only webhooks for that project
• Usage stats update to show project-specific consumption

Viewing Project Resources

In the Projects page, each project card shows:

• Network badge (Mainnet/Testnet)
• Number of API keys
• Number of webhooks
• Creation date

Deleting a Project

1. Go to the Projects page
2. Click the delete button on the project card
3. Confirm the deletion

Warning: Deleting a project permanently removes all associated API keys and webhooks. This action cannot be undone.

Note: You cannot delete your last project. Each organization must have at least one project.

Best Practices

Separate Development and Production

Create separate projects for different environments:

• Production (Mainnet) - Live application
• Staging (Testnet) - Pre-production testing
• Development (Testnet) - Active development

Use Descriptive Names

Name your projects clearly to indicate their purpose:

• "Mobile App - Production"
• "Web Dashboard - Staging"
• "Integration Tests"

Monitor Usage Per Project

Track request consumption per project in the Overview dashboard to:

• Identify which applications consume the most resources
• Optimize API calls in high-usage projects
• Plan capacity needs

Network Selection

Mainnet

Use Mainnet projects for:

• Production applications serving real users
• Applications processing real transactions
• Live monitoring and webhooks

Testnet

Use Testnet projects for:

• Development and debugging
• Integration testing
• Load testing and performance evaluation
• Experimenting with new features

Note: On Testnet, node gRPC serves live data; archival gRPC and GraphQL with full history since genesis are available on Mainnet.

FAQ

Can I move resources between projects?

No, API keys and webhooks are tied to their project and cannot be moved. You'll need to create new resources in the target project.

What happens to usage stats when I delete a project?

Historical usage data is preserved at the organization level, but project-specific breakdowns will no longer be available.

Can I change a project's network after creation?

No, the network is fixed when the project is created. Create a new project if you need a different network.

Next Steps

• Generate API Keys for your project
• Set up Webhooks to monitor blockchain events
• Explore API Gateways for your network