VAST Data realms API
Realms are user defined customized permission realms for VMS manager users. They define sets of object types and can be granted to managers and roles for VMS 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/vastdata-realms-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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:
description: VAST Management API definition
title: VAST API Swagger Schema activedirectory Realms API
version: '1.0'
security:
- ApiToken: []
tags:
- description: Realms are user defined customized permission realms for VMS manager users. They define sets of object types and can be granted to managers and roles for VMS permissions.
name: realms
paths:
/realms/:
get:
description: This endpoint lists the user defined realms configured.
operationId: realms_list
parameters:
- in: query
name: page
schema:
type: string
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/Realm'
title: Realms
type: array
description: Realm information
summary: List Realms
tags:
- realms
post:
operationId: realms_create
requestBody:
content:
application/json:
schema:
properties:
name:
description: Realm name
type: string
object_types:
items:
type: string
type: array
tenant_id:
description: Tenant ID
type: integer
required:
- name
type: object
x-originalParamName: RealmCreateParams
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/Realm'
description: ''
summary: Create Realm
tags:
- realms
/realms/{id}/:
delete:
description: This endpoint deletes a realm.
operationId: realms_delete
parameters:
- description: Realm ID
in: path
name: id
required: true
schema:
type: string
responses:
'204':
description: ''
summary: Delete Realm
tags:
- realms
get:
description: This endpoint returns details of a realm.
operationId: realms_read
parameters:
- description: Realm ID
in: path
name: id
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Realm'
description: ''
summary: Return Details of a Realm.
tags:
- realms
patch:
description: This endpoint modifies realm.
operationId: realms_modify
parameters:
- description: Realm ID
in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
properties:
name:
description: Name
type: string
type: object
x-originalParamName: RealmModifyParams
responses:
'200':
description: ''
summary: Modify realm
tags:
- realms
/realms/{id}/assign/:
patch:
description: This endpoint assign object to realm.
operationId: realms_assign
parameters:
- description: Realm ID
in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
properties:
object_type:
description: Object
type: string
type: object
x-originalParamName: RealmAssignParams
responses:
'200':
description: ''
summary: Assign object type to realm
tags:
- realms
/realms/{id}/unassign/:
patch:
description: This endpoint unassign object from realm.
operationId: realms_unassign
parameters:
- description: Realm ID
in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
properties:
object_type:
description: Object
type: string
type: object
x-originalParamName: RealmUnassignParams
responses:
'200':
description: ''
summary: Unassign object type from realm
tags:
- realms
components:
schemas:
PartialTenantInfo:
properties:
id:
description: Tenant ID
type: integer
name:
description: Tenant Name
type: string
type: object
Realm:
properties:
guid:
type: string
id:
type: integer
x-cli-header: ID
name:
description: The name of the realm
type: string
object_types:
items:
type: string
type: array
tenant:
$ref: '#/components/schemas/PartialTenantInfo'
tenant_id:
description: Tenant ID
type: integer
required:
- name
type: object
securitySchemes:
ApiToken:
description: Send current valid API token in an Authorization header with format Api-Token <token>.
in: header
name: ApiToken
type: apiKey
basicAuth:
description: Basic authentication using VMS user name and password
scheme: basic
type: http