Projects
Projects are the most powerful way to organize your API work in Tigrister. While Box lets you save individual requests, Projects provide a structured way to manage entire APIs with modules, endpoints, environments, and servers.
Projects bring structure to your API work. Instead of a flat list of saved requests, you get a hierarchical tree of modules and endpoints that mirrors your API design.
When to Use Projects
Projects are ideal when:
You're building, testing, or documenting an API with multiple related endpoints that share common base URLs and authentication.
You need to test the same endpoints against different environments (development, staging, production) with different variables.
You're designing an API and want to define expected responses, validate contracts, and maintain documentation.
You want to organize endpoints into logical groups (modules) like "Users", "Products", "Orders", etc.
Projects vs Box vs History
Understanding when to use each feature:
| Feature | Projects | Box | History |
|---|---|---|---|
| Organization | Hierarchical (modules) | Flat list | Chronological |
| Environments | Per-project environments | Uses global | Snapshot only |
| Servers | Multiple base URLs | Individual URLs | Recorded URL |
| Contract Validation | Full support | Custom schema only | No |
| Response Saved | Expected responses | No | Full response |
| Best For | API development | Quick saves | Request audit |
Project Structure
Every project follows a clear hierarchy:
Key Concepts
Modules
Modules are logical groups that organize related endpoints. Think of them as folders or categories. A "Users" module might contain all user-related endpoints like login, register, profile, etc.
Endpoints
Endpoints are the actual API requests within a module. Each endpoint has a method (GET, POST, etc.), a path, and can have its own headers, body, parameters, and expected responses.
Project Environments
Each project can have its own set of environments (Development, Staging, Production) with different variable values. When you switch environments, all endpoints automatically use the new values.
Servers
Servers define the base URLs for your API. A project can have multiple servers (e.g., https://api.example.com for production, https://staging.api.example.com for staging).
Quick Start
Get started with Projects in 4 steps:
Create a Project
Click "New Project" in the Projects section of the sidebar.
Add a Module
Use the project's menu (⋮) and select "Add Module".
Add Endpoints
Use the module's menu (⋮) and select "Add Endpoint".
Configure & Test
Click an endpoint to open it, configure the request, and send it.