> For the complete documentation index, see [llms.txt](https://docs.nuvolos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nuvolos.com/how-to-guides/common-workflows/requesting-roles.md).

# Requesting roles

<mark style="color:$primary;">**Outcome**</mark>\
You submit a role request for content you can see but cannot interact with, and track it through approval.

<mark style="color:$primary;">**Before you start**</mark>

* You can see the dataset or space but cannot view its contents.
* You understand that an **Organisation Manager** or **Space Administrator** will review your request - it is not automatic.

If you need access to a course, research project, or dataset you can see but can't interact with, you can submit a role request. The most common case is requesting the Viewer role for a public dataset where you currently hold only the Observer role.

### Request a Viewer role for a public dataset

{% stepper %}
{% step %}
Open the dataset from the toolbar menu.
{% endstep %}

{% step %}
Click **REQUEST ROLE** on the overview page.
{% endstep %}
{% endstepper %}

Once submitted, an Organisation Manager will review the request. You can view the dataset once your request is approved.

### Cancel a pending request

If you change your mind about a request, you can withdraw it as long as it is still pending.

{% stepper %}
{% step %}
Open the notifications icon in the toolbar.
{% endstep %}

{% step %}
Find your request in the **REQUESTS SUBMITTED** section.
{% endstep %}

{% step %}
Click the red cancel button to withdraw the request.
{% endstep %}
{% endstepper %}

### Track your requests

Use the notifications icon in the toolbar to see two types of requests:

* Requests you have submitted - waiting for approval.
* Requests requiring your approval - only relevant if you have manager privileges. See [Administration › Organisation administration](/administration/organisation-management.md) for the approver workflow.

Other useful filters in the requests view:

* Colour-coded mail checkboxes filter requests (for example, show only pending requests).
* Username and organisation filters help you find specific requests quickly.


---

# 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://docs.nuvolos.com/how-to-guides/common-workflows/requesting-roles.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.