NVIDIA Run:ai Permissions API
The Permissions API from NVIDIA Run:ai — 2 operation(s) for permissions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/runai:runai-permissions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: latest
description: '# Introduction
The NVIDIA Run:ai Control-Plane API reference is a guide that provides an easy-to-use programming interface for adding various tasks to your application, including workload submission, resource management, and administrative operations.'
title: NVIDIA Run:ai Permissions API
x-logo:
url: https://api.redocly.com/registry/raw/runai-xq8/saas/latest/public/runai-logo-api.png
altText: NVIDIA Run:ai
href: https://run.ai
license:
name: NVIDIA Run:ai
url: https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-software-license-agreement/
servers:
- url: https://app.run.ai
security:
- bearerAuth: []
tags:
- name: Permissions
paths:
/api/v1/authorization/permissions:
get:
summary: Get a summary of user permissions
description: Retrieve a summary of user permissions.
operationId: get_permissions
tags:
- Permissions
responses:
'200':
description: Executed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/Permissions'
'401':
$ref: '#/components/responses/401Unauthorized'
'500':
$ref: '#/components/responses/500InternalServerError'
'503':
$ref: '#/components/responses/503ServiceUnavailable'
/api/v1/authorization/permitted-scopes:
post:
summary: Calculate permitted scopes
description: Use to calculate user permitted scopes for an action on a resource.
operationId: get_permitted_scopes
tags:
- Permissions
requestBody:
description: The request parameters.
required: true
content:
application/json:
schema:
type: object
required:
- resourceType
properties:
resourceType:
$ref: '#/components/schemas/ResourceType'
action:
type:
- string
- 'null'
enum:
- create
- read
- update
- delete
responses:
'200':
description: Executed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PermittedScopesActions'
'401':
$ref: '#/components/responses/401Unauthorized'
'500':
$ref: '#/components/responses/500InternalServerError'
'503':
$ref: '#/components/responses/503ServiceUnavailable'
components:
schemas:
ResourceType:
type: string
description: "Resource type enum for authorization. \n\nNote: The 'apps' resource type is DEPRECATED. Please use 'service-account' instead for managing service accounts.\n"
enum:
- department
- tenant
- project
- cluster
- cluster-config
- nodepools
- nodes
- settings
- security-settings
- branding-settings
- users
- apps
- service-account
- dashboards-overview
- dashboards-analytics
- dashboards-consumption
- roles
- access_rules
- jobs
- workloads
- workspaces
- trainings
- inferences
- environments
- pvc-assets
- git-assets
- host-path-assets
- nfs-assets
- s3-assets
- compute-resources
- templates
- credentials
- events-history
- policies
- cm-volume-assets
- datavolumes
- secret-volume-assets
- storage-class-configuration
- access-keys
- workload-properties
- network-topologies
- registries
- scrapeable-metrics
PermittedScopesActions:
type: object
required:
- create
- read
- update
- delete
properties:
create:
$ref: '#/components/schemas/PermittedScopes'
read:
$ref: '#/components/schemas/PermittedScopes'
update:
$ref: '#/components/schemas/PermittedScopes'
delete:
$ref: '#/components/schemas/PermittedScopes'
Permission:
type: object
required:
- resourceType
- actions
- groupId
- displayName
properties:
resourceType:
$ref: '#/components/schemas/ResourceType'
displayName:
type: string
example: Projects
groupId:
$ref: '#/components/schemas/ResourceTypeGroupId'
actions:
type: array
items:
$ref: '#/components/schemas/Action'
Action:
type: string
enum:
- create
- read
- update
- delete
- sync
Error:
required:
- code
- message
properties:
code:
type: integer
minimum: 100
maximum: 599
message:
type: string
details:
type: string
example:
code: 400
message: Bad request - Resource should have a name
ResourceTypeGroupId:
type: string
enum:
- organization
- physical-resource
- iam
- dashboard
- workload
- workload-asset
Permissions:
type: array
items:
$ref: '#/components/schemas/Permission'
x-schema-name: Permissions
PermittedScopes:
type: object
properties:
system:
type: boolean
example: false
tenants:
type: array
items:
type: string
example: '1'
tenant:
deprecated: true
type: string
example: '1'
clusters:
type: array
items:
type: string
example: a418ed33-9399-48c0-a890-122cadd13bfd
departments:
type: array
items:
type: string
example: '7'
projects:
type: array
items:
type: string
responses:
503ServiceUnavailable:
description: unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: 503
message: Please try again in few minutes.
401Unauthorized:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: 401
message: Issuer is not familiar.
500InternalServerError:
description: unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: 500
message: Something went wrong.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Bearer authentication
x-tagGroups:
- name: Organizations
tags:
- Clusters
- Departments
- Reports
- NodePools
- Nodes
- Projects
- Tenant
- Logo
- Researcher Command Line Interface
- Researcher Command Line Interface Deprecated
- Administrator Command Line Interface
- Network Topologies
- name: Authentication and Authorization
tags:
- Access Keys
- Access rules
- Permissions
- Applications
- Service Accounts
- Roles
- Tokens
- Users
- User Applications
- Idps
- Me
- Settings
- Org unit
- name: Audit
tags:
- AuditLogs
- name: Datavolumes
tags:
- Datavolumes
- name: Workloads
tags:
- Events
- Pods
- Workloads
- Workloads V2
- NVIDIA NIM
- Workspaces
- Trainings
- Inferences
- Revisions
- Distributed
- Workloads batch
- Workload properties
- Workload templates
- Distributed Inferences
- name: Workload assets
tags:
- Compute
- Credentials
- Datasources
- Environment
- Storage Classes
- Storage Class Configuration
- Git
- HostPath
- NFS
- PVC
- Registry
- S3
- ConfigMap
- Secret
- Template
- name: Policies
tags:
- Policy
- name: Notifications
tags:
- Notification State
- Notification Types
- NotificationChannels
- Subscriptions
- name: AI Applications
tags:
- AI Applications