> 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/evaluate/query-in-studio/save-as-perspective.md).

# Save as Perspective

A perspective is a saved, governed query built on a product's semantic layer. It preserves the dimensions, measures, filters, and time window you selected, so the same result can be reused, shared, or consumed through a Data API. (To find perspectives others have saved, see [Discover → Perspectives](/consume/v1/discover/search-the-hub/perspectives.md).)

## Save a query

After running a query in [Studio](/consume/v1/evaluate/query-in-studio.md), open the **Save as Perspective** dialog and give it an identity others can find and trust:

![Save as Perspective dialog showing name, description, tags, visibility, and auto refresh](/files/9eMAEAho7pUdUGISgBYe)

* **Name** (required): how people recognize it.
* **Glossary term**: ties the perspective to a shared business definition.
* **Description**: what it returns, so consumers know whether it answers their question.
* **Tags**: make it easier to find and group.
* **Visibility**: who can use it. Keep it to **Only me** while drafting, or open it to share.
* **Auto refresh**: whether the result stays current automatically.

Select **Save**, then **View details** to open the new perspective.

## Explore a perspective

The perspective page has four tabs and an **About** panel (description, product, visibility, owner, tags, and the models behind it):

| Tab       | What it gives you                                                                                              |
| --------- | -------------------------------------------------------------------------------------------------------------- |
| Data      | The result, with last-updated time and row and column counts, so you can confirm it returns what you expect    |
| Columns   | Each field with its tags and profile, so you understand it before building on it                               |
| Lineage   | How the perspective is built from inputs, outputs, and semantic models, so you can judge how trustworthy it is |
| Data APIs | The endpoint, required `Authorization` header, and response schema to serve it into an application or report   |

The Data APIs tab is the bridge to activation: it gives you everything needed to consume the perspective programmatically. See [APIs](/consume/v1/activate/apis.md).


---

# 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/evaluate/query-in-studio/save-as-perspective.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.