Namespaces in Validio are used to organize and isolate resources into managed groups, allowing teams to access only the resources assigned to them. This separation ensures that each team can manage its resources independently, without interference from other teams, and helps control data visibility within the Validio platform.

There are two root namespaced resources: Credentials and Channels. All other resources (such as sources, validators, and notification rules) are created from one of these root resources and inherit their namespace.

Your namespace assignment in Validio controls data that you see in the UI:

• Overview: Summarizes data for all namespaces you have access to, with the option to select a specific namespace.
• Credentials: Requires selecting a namespace when creating credentials.
• Sources: Assigned to the namespace of the credential used to create them, and all resources created in the source (validators, segments, and so on) will inherit the namespace.
• Catalog and Lineage: Shows all resources you have permission to see, regardless of the selected namespace.
• Incidents and Errors: Displayed based on the namespace of the source.
• Notifications: Requires selecting a namespace when creating notification channels, and notification rules follow the channel's namespace.

For more information, see About Validio RBAC.

Create a New Namespace

To add a new namespace,

1. Navigate to Workspace > Namespaces.
2. Click + New Namespace.
3. Enter a Name for your namespace.
4. (Optional) Upload an avatar.
5. From the list,
   1. Select the relevant members, teams, and API keys to assign to the namespace. You will see a summary of your selection below the table.
   2. Select the relevant role (View, Admin, Editor) to assign to each member, team, and API Key you add to the namespace.
6. Click Create Namespace to finish.

Delete a Namespace

To delete a Namespace,

1. Navigate to Workspace > Namespaces.
2. Click the ⋮ menu at the end of the row for the relevant namespace.
3. Select Delete.

If the selected namespace is connected to credentials or channels, you will not be able to delete the namespace until you delete each connected resource. You will see an error message listing the connected resources to delete.

Add API Keys to a Namespace

When you create an API key using the UI, you will need to manually add the API key to each namespace that it needs to access. For more information, see Managing API Keys.

To add API keys to a namespace in the UI,

1. Navigate to Workspace > Namespaces.
2. Select the Namespace you want to add the API key to (create a new namespace).
3. Under Add members, teams, or API keys, scroll down to API Keys.
4. Check the API Keys you want to add to the Namespace and select which role (Viewer, Editor, Admin) it should have.
5. Click Update (or Create namespace).