Apps Management
Learn how to manage your Clarifai applications
Manage via the UI
App Overview
The App Overview page gives a glimpse of your app and its purpose. To access it, go to your application's individual page and select the Overview option on the collapsible left sidebar.
You'll be redirected to a page that gives an overview of the contents of your app.
You can accomplish various tasks on that page.
- Click the pencil icon next to the app ID to change it.
- Click the Edit Visibility button at the upper-right corner to edit the visibility of your app to either public or private.
- Click the star icon at the upper-right corner to highlight your app. This marks it as a favorite and makes it easier to access among other listed apps.
- Click the three dots at the upper-right corner to reveal a drop-down list that lets you duplicate the app, copy its ID, or delete it.
- View the number of each type of resource contained in your app—inputs, datasets, models, workflows, and modules. If the number is large and has been truncated in the display, click on the tooltip (?) to reveal the precise count of the resource.
- Click the plus icon (+) within any resource type section to add the resource to your app. If you click the button, you’ll be redirected to a subsequent page that allows you to add the resource you want.
- Click the "view" link within any resource type section to view all the respective resources available in your app.
- Add notes that describe what your app is about.
- Upload a cover image and use it as a reference for the app.
- Edit the app’s description.
- View the app’s base workflow, last updated date, and default language.
- Copy the app's URL and share it across various platforms and social media channels for wider visibility and reach.
- View the types of models contained in the app.
- View and edit the collaborators associated with the app.
App Settings
You can change the settings of an application at any time. To do so, go to the application's individual page and select the Settings option on the collapsible left sidebar.
You'll be redirected to the Settings page, where you can change the application's settings.
Let's talk about the changes you can make on the page.
This page has intuitive elements that let you search for specific items and sort displayed items based on your preferences.
API Keys
Create API Keys
Click the Create API Key button to add a new API key to your app. Then, use the form that pops up to generate a new API key — provide a short description, select the scopes, and click the Confirm button.
The new app-specific key will be listed in the API Keys section, where you can carry out various management tasks on it.
Copy an API Key
You can copy an API key to the clipboard by clicking the copy button.
Show an API Key
You can reveal an API key by clicking the show button. You can also hide it by clicking the same button.
Edit an API Key
You can edit an API key by clicking the edit button. A form will pop up that allows you to update the description and scopes of your API key.
Delete an API Key
You can delete an API key by clicking the delete button.
Collaborators
Collaboration is a functionality that allows you to share your apps so that you can work with your team members to label data, create models, and more. With this feature, you can control the permissions available in your apps and manage the capabilities available to each user.
For example, you can give a trusted collaborator full access privileges. You can also invite a worker and grant them limited permissions, such as only to annotate data but not to delete them.
Add Collaborators
To add a collaborator to your app, click the Add Collaborators button in the Collaborators section. A form will appear that allows you to invite a collaborator.
Enter the email address associated with the collaborator’s Clarifai account and specify the scope of resources you want them to access.
Lastly, click the Confirm button. The invited collaborator will receive an email notification informing them that they have been added to the app.
-
The collaborator you want to invite must have a registered account on the Clarifai portal.
-
Personal Access Tokens (PATs) are automatically generated for collaborators, providing them access to the Clarifai API.
-
Collaborators can also invite other collaborators.
Alternatively, you can add a collaborator directly from the App Overview page.
In the upper-right corner of the App Overview page, click the add collaborator button. Next, use the form that pops up to invite a collaborator — provide an email address associated with their Clarifai account, select their scopes, and click the Confirm button.
You can select specific scopes when adding a collaborator. Modifying these scopes provides fine-grained control over the data that users can access, enhancing your app's security and preventing unauthorized intrusions.
In the Add Collaborator form, you can click the Select All Scopes button to choose all scopes at once. Alternatively, you can select individual scopes from the listed BASIC SCOPES, or click on the ADVANCED SCOPES option to access more advanced choices.
You can edit a collaborator's scopes at a later time.
These are the basic scopes you can choose:
Annotation: Add and Remove Annotations on Inputs
Collaborator: Add, Remove and Patch Collaborators
Collector: Add, Remove and Patch Input Collectors
Concept: Add, Remove and Patch Concept
Input: Add and Remove Inputs to an App
Model: Add, Remove and Train Custom Models
Predict: Predict on Public and Custom Models
Search: Search over Inputs an App
Task: Add, Remove and Patch Scribe labeling Tasks
Vocab: Add, Remove and Delete lists of Concepts
Workflow: Add, Remove and Delete Workflows of Models
Click here to learn more about scopes.
Delete a Collaborator
You can remove a collaborator by clicking the delete button.