Scopes provide control over the set of functionality and features available when using our API. Modifying scopes allows for fine-grained control over the data that users have access to, and can help keep your app secure from malicious attacks.
You can control scopes for our apps at three different levels:
App-Specific API Keys Control access to resources used by a specific app and a specific user
Personal Access Tokens Control access to resources available to a specific user
Collaboration Control access to resources available to collaborators
A variety of use cases can be address by selecting different combinations of scopes.
For example, you might want to create an app that only has access to the search endpoint, but for search to work properly it needs access to Predict at the operation level (so that it can perform advanced visual searches like searching by an image crop, which first needs to be understood with a prediction before search is performed).
By giving the combination of predict op-level but only search endpoint, you can create an app that can perform searches, but not model predictions (like PostModelOutputs).
You have control over both operation and endpoint level scopes.
Operation level scopes provide control over the ability to read, write, or delete a given resource type. To see the always up to date list of operation level scopes avilable in your plan create a key in Portal.
Annotations:Add (Write Annotations)
Annotations:Delete (Delete Annotations)
Annotations:Get (Read Annotations)
Concepts:Add (Write Concepts)
Concepts:Get (Read Concepts)
Inputs:Add (Write Inputs)
Inputs:Delete (Delete Inputs)
Inputs:Get (Read Inputs)
Models:Add (Write Models)
Models:Delete (Delete Models)
Models:Get (Read Models)
Models:Train (Train a Custom Model)
Predict (Predict on Public and Custom Models)
Search (Search by Inputs and Concepts)
Workflows:Add (Write Workflows)
Workflows:Delete (Delete Workflows)
Workflows:Get (Read Workflows)
Endpoint level scopes give you control over access to specific endpoints. To see the always up to date list of endpoint level scopes available in your plan create a key in Portal.