> For the complete documentation index, see [llms.txt](https://v2.dataos.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://v2.dataos.info/consume/v1/activate/apis/collection.md).

# Collection

The Postman collection gives you ready-to-run requests, so you can pull governed data into your app without building calls from scratch. It already covers GraphQL, semantic queries, metadata, activity, quality, and other operational APIs, so you confirm a request works in Postman before committing it to code.

## Before you start

Generate a [DataOS API token](/consume/v1/get-started/before-you-begin.md), open the target product, and make sure Postman is installed. See [API tokens](https://v2.dataos.info/references/key-concepts/api-tokens) for how tokens work.

## Import and configure

1. From the product page, select **Activate → APIs**, and under **Postman collection** select **Download**.
2. Import the collection into Postman. It appears with grouped folders: Health, Metadata, Exports, Data Quality, Plans, Runs, Semantic REST, Semantic SQL, and Semantic GraphQL.
3. Set two values before sending a request:

<table><thead><tr><th width="114.7666015625">Value</th><th>What to use</th></tr></thead><tbody><tr><td><code>baseUrl</code></td><td>The product base URL from <strong>Connect → APIs</strong>, set in the collection Variables tab</td></tr><tr><td><code>token</code></td><td>Your <a href="/pages/7rh6mFCr0rhl6vO76XjW">DataOS API token</a>, set as a Bearer token in the collection Authorization tab</td></tr></tbody></table>

4. Start with **Health → Liveness probe** to confirm the base URL works, then run the request you need from the relevant folder.

The collection groups requests by area: health and metadata; Semantic REST, Semantic SQL, and Semantic GraphQL; and activity, quality, notifications, perspectives, followers, and query-result APIs.

When you are ready to move from testing to code, use the [SDK](/consume/v1/activate/apis/sdk.md) for typed clients. For collection variables, the async query workflow, and environment management, see the [Postman collection reference](https://v2.dataos.info/references/interfaces/apis/data-product-apis/getting-started/postman-collection) in References.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://v2.dataos.info/consume/v1/activate/apis/collection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.