​
Workspaces

Workspaces in Portkey are sub-organizations that enable better separation of data, teams, scope, and visibility within your larger organization. They provide a more granular level of control and organization, allowing you to structure your projects and teams efficiently. Key features of Workspaces:
  • Team Management: You can add team members to workspaces with specific roles (manager or member), allowing for precise access control.
  • Dedicated API Keys: Workspaces contain their own API keys, which can be of two types:
    • Service Account type: For automated processes and integrations
    • User type: For individual user access
    • Both these types of keys are scoped to the workspace by default and can only execute actions within that workspace.
  • Completion API Scoping: Completion APIs are always scoped by workspace and can only be accessed using workspace API keys.
  • Admin Control: While only org admins can create workspaces, managers can add API keys and team members with roles to existing workspaces.
  • Flexible Updates: When making updates to entities via admin keys (at the org level), you can specify the workspace_id to target specific workspaces.
Workspaces provide a powerful way to organize your projects, teams, and resources within your larger organization, ensuring proper access control and data separation. This structure allows for efficient management of resources and access within each workspace, providing a clear separation between different projects or teams within your organization.

​
Deleting a Workspace

  • Before deleting a workspace, all resources within it must be removed.
  • You can’t delete the default Shared Team Workspace.
To delete a workspace in Portkey, follow these steps:
  1. Navigate to the sidebar in the Portkey app
  2. Open the workspace menu dropdown
  3. Select the workspace you wish to delete
  4. Click on the delete option (trash icon) next to the workspace name
When attempting to delete a workspace, you’ll receive a confirmation dialog. If the workspace still contains resources, you’ll see a warning message prompting you to delete these resources first.

Workspace deletion confirmation

Resources that must be deleted before removing a workspace like - Prompts, Prompt partials, Providers, Configs, Guardrails and more. Once all resources have been removed, enter the workspace name in the confirmation field to proceed with deletion.
Workspace deletion is permanent and cannot be undone
Alternatively you can also delete workspaces using the Admin API:

Delete a Workspace API

Organizations

User Roles & Permissions

API Keys (AuthN and AuthZ)