API Objects

Understand how Banyan objects are represented in the Banyan API, and how to express them in JSON

  • Updated on Jun 29, 2023

Banyan API objects are presistent entities in the Banyan platform. Banyan uses these entities to represent the state of your organization’s connectivity and security. To work with Banyan API objects - whether to create, modify, or delete them - you use Banyan’s Restful API.

API Object Details

The following API objects are publicly documented:


API Object Syntax

All Banyan API objects follow a standard format and are internally managed via the golang language. Every API object contains the following attributes. Metadata represents data that helps uniquely identify the object and explain what it does. Spec represents the actual specification of the object.

type Object struct {
  Kind       string `json:"kind"`
  APIVersion string `json:"apiVersion"`
  Type       string `json:"type"`
  Metadata          `json:"metadata"`
  Spec              `json:"spec"`
}

type Kind

Kind specifies one the objects detailed below

Kind       string `json:"kind"`

type APIVersion

APIVersion should be set to “rbac.banyanops.com/v1”

APIVersion string `json:"apiVersion"`

type Type

Type (unused) is used to distinguish between different types of objects

Type       string `json:"type"`

Can’t find what you’re looking for?

We’re happy to help. Contact our team.