Skip to content

Workspace Settings

Workspace settings allow you to configure and customize your Treblle workspace according to your team’s needs.

As a workspace owner, you can manage workspace details, security settings, sharing options, and administrative controls.

Workspace Details

Configure the basic information and branding for your workspace to help team members identify and understand its purpose.

Workspace Information

Workspace Name

  • Current Name: Display name for your workspace
  • Editing: Click Edit to modify the workspace name
  • Naming Guidelines: Choose descriptive names that reflect your organization or project
  • Save Changes: Click Save to apply name changes

Workspace Icon

  • Upload Icon: Add a custom icon to represent your workspace
  • Edit Image: Modify existing workspace icons
  • Remove Image: Delete current workspace icon to use default
  • Image Requirements: Recommended square format for best display

SDK Token Management and Workspace ID

SDK Token: Critical security credentials for integrating your APIs with Treblle. Workspace ID: Unique identifier for your workspace within the Treblle platform.

SDK Token Information

  • Purpose: Used to configure Treblle SDK packages
  • Security: Keep tokens secure and never share publicly
  • Regeneration: Generate new tokens if compromised
  • Copy Function: One-click copy for easy integration

Workspace ID Details

  • Unique Identifier: Distinguishes your workspace from others
  • API Integration: Used for programmatic access to workspace
  • Copy Function: Easy copying for technical integrations
  • Immutable: Workspace IDs cannot be changed once created

Share Feature Configuration

Control how team members can share API data and documentation from your workspace.

Share Feature Benefits

When Enabled:

  • Team members can share API documentation
  • External stakeholders can access shared API information
  • Facilitates collaboration with external developers
  • Enables public API documentation

When Disabled:

  • All sharing functionality is blocked
  • Enhanced security for sensitive APIs
  • Internal-only API documentation
  • Restricted access to workspace content

Workspace Options

Administrative controls for managing workspace membership and lifecycle.

Leave Workspace

Exit your current workspace while preserving it for other members.

Leaving Process

  1. Consider Impact: Evaluate your role and responsibilities
  2. Transfer Ownership: If you’re the owner, transfer to another member first
  3. Click Leave: Use the Leave button in workspace options
  4. Confirm Action: Acknowledge the consequences of leaving

Consequences of Leaving

  • Immediate Loss of Access: No longer able to view workspace content
  • Data Inaccessibility: Cannot access APIs, requests, or analytics
  • No Recovery: Cannot rejoin without new invitation
  • Owner Transfer Required: Must transfer ownership before leaving

When you leave a workspace, you instantly lose access to everything in that workspace. The only way back is via an invite from the owner.

Delete Workspace

Permanently remove the workspace and all associated data.

Deletion Considerations

What Gets Deleted:

  • All API documentation and endpoints
  • Request logs and analytics data
  • Team member access and permissions
  • Workspace settings and configurations
  • Historical data and reports

Irreversible Action:

  • No data recovery possible
  • No backups maintained by Treblle
  • All team members lose access immediately
  • Cannot recreate with same name/settings

Access Control and Permissions

Owner Responsibilities

As a workspace owner, you have full administrative control:

User Management:

  • Invite and remove team members
  • Assign and modify user roles
  • Control access to sensitive APIs
  • Manage workspace permissions

Settings Control:

  • Modify all workspace settings
  • Configure security features
  • Manage billing and subscriptions
  • Control sharing permissions

Data Management:

  • Access all workspace data
  • Configure data retention policies
  • Manage API documentation
  • Control export capabilities

Member Limitations

Standard members have restricted access:

Cannot Modify:

  • Workspace settings and configuration
  • Other users’ roles and permissions
  • Billing and subscription information
  • Critical security settings

Can Access:

  • Assigned APIs and their data
  • General workspace features
  • Collaboration tools
  • Personal account settings