Version 2.0

Get Cbac Banner

GET/api/v2/admin/cbacBanner

Returns a classification banner string and colors for the given set of marking IDs.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:admin-read.

Query parameters

displayType

string (enum)optional

The display type of the banner. Defaults to PORTION_MARKING. BANNER_LINE is a long classification string used in the header of a document; PORTION_MARKING is a short classification string used for individual paragraphs.

Enum values: BANNER_LINE, PORTION_MARKING

markingIds

list<MarkingId>optional

The marking IDs for which to generate a banner. Duplicate marking IDs are ignored. Marking IDs that the current CBAC configuration does not recognize are ignored and omitted from the markings response.

Show child attributes

Response body

CbacBanner

object

Hide child attributes

classificationString

string

The formatted classification string for the requested markings and display type.

markings

list<MarkingId>optional

The marking IDs that the banner represents, with duplicates removed. Marking IDs that the current CBAC configuration does not recognize are omitted. The order is unspecified.

Show child attributes

textColor

string

The color to use for the banner text.

backgroundColors

list<Color>optional

The background colors to use when displaying the banner. The list currently contains a single color, which should be used as a solid background. If more than one color is returned, use the first.

Show child attributes

Examples

Request

Copied!

curl \
\t-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/admin/cbacBanner?displayType=PORTION_MARKING&markingIds=MTS%2CMNF"

Response

Copied!

{
  "markings": [
    "MTS",
    "MNF"
  ],
  "backgroundColors": [
    "#0F4B8F"
  ],
  "classificationString": "MTS//MNF",
  "textColor": "#FFFFFF"
}

Error responses

Error Name
`GetCbacBannerPermissionDenied`	Error Code	`PERMISSION_DENIED`
	Status Code	403
	Description	The provided token does not have permission to get the CBAC banner for the markings.
	Parameters	`markingIds`
`CbacUnavailable`	Error Code	`INVALID_ARGUMENT`
	Status Code	400
	Description	CBAC is not available.
	Parameters
`UnknownClassificationBannerDisplayType`	Error Code	`INVALID_ARGUMENT`
	Status Code	400
	Description	The provided classification banner display type is not recognized.
	Parameters	`displayType`
`CbacBannerNotFound`	Error Code	`NOT_FOUND`
	Status Code	404
	Description	The given CbacBanner could not be found.
	Parameters

See Errors for a general overview of errors in the platform.