# Datatabledata Tutorial

This tutorial will help you to learn how to interact with the Buzzy API endpoint for Datatable - the endpoint is called "microappdata"

For the canonical explanation of row metadata and `embeddingRowID`, see [Row Metadata and Relationships](/rest-api/buzzy-rest-api/rest-api/microapp-data-operations/row-metadata-and-relationships.md).

{% hint style="info" %}
Please note: Datatable were Previously called "Microapps", the name of the endpoint is thus microappdata.
{% endhint %}

### Prerequisites

To work with this tutorial you will need a version of [postman](https://www.postman.com/downloads). In addition a user with password that has access to a Buzzy server is required.

### Steps

1. Begin by creating a new request in postman. Set the request to POST and the url to yourserver/api/login. Set the body:

   ```
   {
    "email":"my-email@buzzy.buzz",
    "password":"my-password"
   }
   ```

   Click Send. The result should be a user id and token.

![tutorial-microappdata-postman1](/files/HZkhjErLzQZcXriXEGwR)

1. Now lets create a request to get the records from a Datatable. Create a new request in postman. Set the request to post and the url to yourserver/api/microappdata. Set two header key value pairs: X-User-Id and X-Auth-Token to the values returned in step 1.

<figure><img src="/files/jOozEHkbsi3unc4IMy8i" alt=""><figcaption></figcaption></figure>

Add the Datatable id to the body:

```
{
	"microAppID":"<insert Datatable id here>"
} 
```

The DatatableId can be found by opening the Datatable in a browser and viewing the properties.

![tutorial-microappdata-postman3](/files/lDCHkWWjwmtmPKU2h6v0)

Click Send, the result should be records from the Datatable best viewed as JSON.

![tutorial-microappdata-postman4](/files/zM567HvWpzUzIV3hV82r)

Note that embedded Datatables are queried using this same endpoint. The body of the request contains the association:

```
{
    "microAppID": "<insert Datatable id here>",
    "searchFilter": [
        {
            "resourceID": "<insert Datatable id here>",
            "embeddingRowID": "<insert parent row id here>"
        }
    ]
}
```

The `embeddingRowID` stores the parent row ID for the child row relationship. Use it whenever you need to query the child rows that belong to one parent row.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buzzy.buzz/rest-api/buzzy-rest-api/datatabledata-tutorial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.