Product documentationUpdated September 29, 2025
Project Operations
Create projects, define scope, set execution defaults, and assign permissions to establish a stable foundation for API testing in Total Shift Left.
Overview
Project creation establishes the foundation for your test suite: scope, environments, execution defaults, and who can change what.
Create a project (initial setup)
When creating a new project:
- Define identity:
- unique name
- clear description
- owner/team alignment
- Choose defaults:
- initial environment (start with dev/stage)
- project visibility (private/team/org as applicable)
Set project scope
Define the boundaries and characteristics of your project:
- What’s in scope: services, versions, and the API surface you expect to cover.
- What’s out of scope: endpoints you intentionally exclude, and why.
- Technical parameters: base URL(s), auth method, and any rate limiting constraints.
Related: Configuration fundamentals.
Configure project-level defaults
Establish global settings that apply to all tests within the project:
- Execution: timeouts, retries for transient failures, and parallel limits.
- Data: seeding strategy and how you avoid cross-run collisions.
- Notifications: who gets alerted and where.
Assign team access
Control who can access and modify the project:
- Assign roles that match responsibility (Admin, Tester/Editor, Viewer).
- Use least privilege by default; expand permissions only when needed.
Related: Role permissions and Audit logs.
Related articles
Related articles
- Managing Projects · Product documentation
- Project · Product documentation
- Project Settings · Product documentation
Next steps
- Getting started · Install + connect your spec
- Configuration fundamentals · Stabilize runs
- Initial configuration · Users, licensing, projects
- Release notes · Updates and fixes
Still stuck?
Tell us what you’re trying to accomplish and we’ll point you to the right setup—installation, auth, or CI/CD wiring.