RestApiCategories.platformAdministration.desc

platform_administration

2025.03

2024.09

2025.09

2026.07

2026.03

2026.09

2026.06

2026.08

The Annotations API allows users to associate annotations with resources that other decoupled APIs manage.  An annotation augments a target resource, which is typically a column or table, with information that extends beyond its physical properties.  This information might include categorization (such as `email` and `address`), role (such as `categorical` and `primary key`), or other descriptive information.

Annotations

Viya_35

The Annotations API allows users to associate annotations with resources that other decoupled API manage.  An annotation augments a target resource, which is typically a column or table, with information that extends beyond its physical properties.  This information might include categorization (such as `email` and `address`), role (such as `categorical` and `primary key`), or other descriptive information.

Returns header information and verifies that the member exists.

The value of the ETag that was returned from a GET or previous PUT of this type.  This header is optional, but if provided, this MUST match exactly the current value of the etag of the object.

If-Match

annotationId

memberId

The ISO8601 date string that represents the timestamp of the last update to this object.

Last-Modified

A tag that identifies this revision of this object.

Etag

This is an example of an error that could be returned for bad requests

Error

application/vnd.sas.error

The specified request was invalid for one of these reasons: <ul> <li>The annotation ID for the specified member is not correct. <li>The new member value exceeds the maximum allowable length. </ul>

Example of an error that might be returned on a 404 response

Get headers verify that the member exists

The annotations provides tags related lifecycle APIs.

Annotation

A collection of annotation objects through which you can page.

Annotation Collection

Collection of AnnotationIDs to list members

Annotation Member Map Collection

Create Annotation

Information about the external object that is associated with the annotation. The annotationId in the request body must match the annotationId in the URI for single-member create requests.

Create Member

Creating members for particular annotation

Create multiple members

A link to a related operation or resource.

Link

Information about the external object that is associated with the annotation.

Member

A collection of annotation member objects through which you can page.

Member Collection

Identifies a collection of resources for bulk queries. The resources array contains identifiers or URIs, depending on type (id, uri, mixed).

Selection

The API exposes endpoint for updating an existing annotation.

Status	Meaning	Description
200	OK	The annotation member exists.	Headers
400	Bad Request	The specified request was invalid for one of these reasons: The annotation ID for the specified member is not correct. The new member value exceeds the maximum allowable length.		Schema
404	Not Found	The specified member does not exist.		Schema

Get headers verify that the member exists

Request Samples

Path Parameters

Header Parameters

Responses


annotationId	string	true	The annotation ID.
memberId	string	true	The member ID.