Skip to main content

Add an object

Learn how to add an object in Piiano Vault​

An object is a group of personal or sensitive data values that belong to a collection.

Adding an object to a collection is similar to adding a row to a table; depending on the collection you want to add an object to, you should provide values for all properties or a subset of them. When an object is added, it's assigned a unique ID.

Whether your request for object values succeeds depends on the permissions you've been granted as part of the Vault’s identity and access management settings.

Add an object to a collection​

Overview​

The steps you take to add an object to the collection are:

  1. Define the property values for the object.
  2. Use the CLI Add object command or REST API Add object operation passing the property values and the collection name.

Step-by-step​

You want to add an object to the buyers collection you created in Create a collection with these values:

  • name = "John Doe"
  • email = "john@somemail.com"
  • address = "45 Rockefeller Plaza, New York"
  • phone number = "+1-121212123"

For these values you use a JSON object to define the data to the REST API or CLI, like this:

{
  "name": "John Doe",
  "email": "john@somemail.com",
  "phone_number": "+1-121212123",
  "address": "45 Rockefeller Plaza, New York"
}

You now add the object using the CLI like this:

pvault object add \
  --collection buyers \
  --fields '{
  "name":"John Doe",
  "email":"john@somemail.com",
  "phone_number":"+1-121212123",
  "address":"45 Rockefeller Plaza, New York"
}'

You get a response similar to this:

+--------------------------------------+
|                 id                   |
+--------------------------------------+
| ab3d5be0-ffde-4a8c-983a-f79dd5d34e17 |
+--------------------------------------+

Or using the REST API, this time for Jane Doe, like this:

curl -s -X POST \
  --url 'http://localhost:8123/api/pvlt/1.0/data/collections/buyers/objects?reason=AppFunctionality' \
  -H 'Authorization: Bearer pvaultauth' \
  -H 'Content-Type: application/json' \
  -d '{
  "name":"Jane Doe",
  "email":"jane@somemail.com",
  "phone_number":"+1-121212124",
  "address":"45 Rockefeller Plaza, New York"
}'

You get a response similar to this:

{
  "id": "b00e021c-7880-43c8-9bdc-e4fa3a474a85"
}

On this page