Alias

Unique ID that retains all the essential information about the data without compromising its security. A value can have multiple aliases.

Reveal multiple aliases

get
/aliases

Given a list of aliases, retrieves all associated values stored in the vault.

NOTE: This endpoint may expose sensitive data. Therefore, it is disabled by default. To enable it, please contact your VGS account manager or drop us a line at [email protected]envelope.

NOTE: metadata information fields of the alias classifiers, created_at and format are supported only for PERSISTENT storage, in case of VOLATILE storage these fields will be filled up with default values.

Authorizations
OAuth2clientCredentialsRequired

This api utilizes the OAuth2.0 Client Credentials flow utilizing VGS service account credentials

Token URL:
Query parameters
aliasesstringRequired

Comma-separated list of aliases to reveal.

Example: ["tok_sandbox_5UpnbMvaihRuRwz5QXwBFw,tok_sandbox_9ToiJHedw1nE1Jfx1qYYgz"]
storagestringOptional

PERSISTENT or VOLATILE storage

Example: ["PERSISTENT"]
Responses
chevron-right
200

OK

application/json
get
/aliases

Create aliases

post
/aliases

Stores multiple values at once & returns their aliases. Alternatively, this endpoint may be used to associate additional (i.e. secondary) aliases with the same underlying data as the reference alias specified in the request body.

NOTE: You cannot reference the same alias more than once in a single request.

NOTE: metadata information fields of the alias classifiers, created_at and format are supported only for PERSISTENT storage, in case of VOLATILE storage these fields will be filled up with default values.

Authorizations
OAuth2clientCredentialsRequired

This api utilizes the OAuth2.0 Client Credentials flow utilizing VGS service account credentials

Token URL:
Header parameters
Content-TypestringRequired

The media type of the resource being sent in the request body.

Example: application/json
Body
Responses
post
/aliases

Batch Delete Aliases

post
/aliases/delete

Deletes multiple aliases.

Authorizations
OAuth2clientCredentialsRequired

This api utilizes the OAuth2.0 Client Credentials flow utilizing VGS service account credentials

Token URL:
Header parameters
Content-TypestringRequired

The media type of the resource being sent in the request body.

Example: application/json
Body

Format for batch requests (limit 20)

datastring[]Optional
storagestring · enumOptionalPossible values:
Responses
post
/aliases/delete

No content

Reveal single alias

get
/aliases/{alias}

Retrieves a stored value along with its aliases.

NOTE: metadata information fields of the alias classifiers, created_at and format are supported only for PERSISTENT storage, in case of VOLATILE storage these fields will be filled up with default values.

Authorizations
OAuth2clientCredentialsRequired

This api utilizes the OAuth2.0 Client Credentials flow utilizing VGS service account credentials

Token URL:
Path parameters
aliasstringRequired

Alias to operate on.

Example: tok_sandbox_bhtsCwFUzoJMw9rWUfEV5e
Query parameters
storagestring · enumOptionalDefault: PERSISTENTPossible values:
Responses
chevron-right
200

OK

application/json
get
/aliases/{alias}

Update data classifiers

put
/aliases/{alias}

Apply a new set of classifiers to the value that the specified alias is associated with. Note that this will replace existing classifiers.

NOTE: update operation is not supported for VOLATILE aliases.

NOTE: metadata information fields of the alias classifiers, created_at and format are supported only for PERSISTENT storage, in case of VOLATILE storage these fields will be filled up with default values.

Authorizations
OAuth2clientCredentialsRequired

This api utilizes the OAuth2.0 Client Credentials flow utilizing VGS service account credentials

Token URL:
Path parameters
aliasstringRequired

Alias to operate on.

Example: tok_sandbox_bhtsCwFUzoJMw9rWUfEV5e
Body
Responses
put
/aliases/{alias}

No content

Delete alias

delete
/aliases/{alias}

Removes a single alias.

Authorizations
OAuth2clientCredentialsRequired

This api utilizes the OAuth2.0 Client Credentials flow utilizing VGS service account credentials

Token URL:
Path parameters
aliasstringRequired

Alias to operate on.

Example: tok_sandbox_bhtsCwFUzoJMw9rWUfEV5e
Query parameters
storagestring · enumOptionalDefault: PERSISTENTPossible values:
Responses
delete
/aliases/{alias}

No content

Last updated