Team Management in ReAPI

Team management in ReAPI is designed to be straightforward and support open collaboration, reflecting ReAPI’s philosophy that development teams work best in an environment with transparent access. With this approach, ReAPI minimizes unnecessary restrictions, making collaboration more efficient while keeping core roles defined for practical organization.

Roles and Permissions

ReAPI includes four key roles, each with distinct permissions:

1. Owner

• The Owner is the top-level role with full access to all settings, configurations, and permissions
• Typically, this role is assigned to the workspace creator or a senior team lead

2. Admin

• Admins have nearly the same permissions as the Owner
• They can manage team members, configure workspace-level settings (e.g., setting the OpenAI API key), and access all features across the workspace and projects
• This role aligns with the open environment principle, allowing trusted team members to make necessary changes for project progression

3. Editor

• Editors can create and modify content within the workspace
• This includes designing APIs, adding or updating API tests, and collaborating on documentation
• Editors cannot manage team members or adjust certain configurations, preserving these controls for Admins and Owners
• This role is ideal for team members actively involved in the content but not in administrative tasks

4. Reader

• Readers have view-only access across the workspace
• They can:
  • View all API designs and tests
  • Run tests as needed
• Readers cannot update any API documentation or tests, ensuring that those who need to review information or verify test results have access without affecting active work

Note: This role design supports ReAPI’s commitment to an open environment, where all team members have visibility into project content and activities, ensuring seamless communication and collaboration.

Future Advanced Access Control (Enterprise)

For teams requiring more granular access control, ReAPI will introduce an Enterprise-level access management feature, expected next year. This enhancement will allow for advanced permissions and fine-grained control over specific project areas, suitable for larger teams or organizations with unique security and access requirements.

This approach balances simplicity with flexibility, fostering an environment where collaboration thrives while preserving essential role-based controls.