Skip to main content

Permissions and scope

Authentication determines both the available operations and the resources that can be queried. A user token can work with all of the user's resources, including resources created through any of the user's API Keys. An API Key can only work with resources created using that same key.

OperationUser tokenAPI KeyScope
/users/me and /users/me/subscriptionsYesNoUser information and subscription
Create, list, query, update, revoke, activate, and delete API KeysYesNoThe user's keys
POST /filesYesYesThe API Key is associated with the created file
List, query, download, and delete filesAll user filesOnly files created with the keyScope depends on the credentials
Create runsOn the user's filesOnly on files created with the keyThe run is associated with the credentials
List and query runs and resultsAll user resourcesOnly resources created with the keyIncludes result files
Manage file commentsYes, on accessible resourcesNoComments are managed with user credentials

An API Key cannot manage other API Keys or access resources created with another API Key. An operation outside this scope may return 401 Unauthorized, 403 Forbidden, or 404 Not Found, depending on the operation and resource.

Storage, inference, concurrency, and API-key limits depend on the user's tier. See Tiers and limits for the published values.