---
title: "High-Level API Flow"
slug: "high-level-api-flow"
updated: 2024-03-15T17:49:31Z
published: 2024-03-15T17:49:31Z
canonical: "help.yahooinc.com/high-level-api-flow"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# High-Level API Flow

To work successfully with the DataX API, you’ll need to understand the high-level DataX API flow, as illustrated in the following diagram:

![](https://cdn.us.document360.io/098e3080-9ea6-4eb4-acdb-13b988f387a2/Images/Documentation/flow-chart.png?sv=2026-02-06&spr=https&st=2026-10-28T07%3A21%3A16Z&se=2026-10-28T08%3A21%3A16Z&sr=c&sp=r&sig=KCMy8t7C9nh%2Fwphoy4mgqh3QuMNDfyrb%2FWPhnafYcM0%3D)

## Ordered Sequence of Steps

The following steps illustrate the DataX API flow:

**Step 1:** Format your data as one of the DataX published formats – primarily JSON, with some text formatting options for easy onboarding.

**Step 2:** Describe your data via DataX’s published MetaData format – just a few fields formatted as JSON.

**Step 3:** Create a multipart/form-data HTTP request, with “metadata” as the first field and “data” as the second field.

**Step 4:** Send a POST request to datax.yahooapis.com against the resource and API version you are uploading to, e.g., POST {version}/taxonomy, POST{version}/audience etc, where {version} is the letter v followed by the major version of the API specification, i.e., “v1” for API specification 1.x.x.

**Step 5:** DataX responds back with an extended MetaData with useful information and links that you can use to monitor your uploads.