RestApiCategories.platformAdministration.desc

platform_administration

2025.11

2024.03

2025.03

2024.09

2025.09

2025.07

2025.08

2025.10

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.

Annotations

Viya_35

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.

Create Member

Creating members for particular annotation

Create multiple members

A link to a related operation or resource.

Link

Member

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

Member Collection

Selection

The API exposes endpoint for updating an existing annotation.

Name	Type	Required	Description
annotationId	string	true	The annotation ID.
memberId	string	true	The member ID.

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

Response Samples

Path Parameters

Header Parameters

Responses