# Asana

{% stepper %}
{% step %}

### Domain

The domain of the Asana server you want to connect to. Requests will be directed to this address.

{% hint style="info" %}
Default: `app.asana.com`
{% endhint %}
{% endstep %}

{% step %}

### Personal Access Token (PAT)

Ensure you have a Personal Access Token (PAT) for Asana with sufficient permissions for the intended API calls (e.g., reading or modifying user and project data).

{% stepper %}
{% step %}

#### PAT Generation — Step 1

Go to the Asana Developer Console: <https://app.asana.com/0/my-apps>
{% endstep %}

{% step %}

#### PAT Generation — Step 2

In the **My Apps** section, scroll down to **Personal Access Tokens**.
{% endstep %}

{% step %}

#### PAT Generation — Step 3

Click **"Create new token"**.
{% endstep %}

{% step %}

#### PAT Generation — Step 4

Enter a name or description for your token (e.g. "Integration Script").
{% endstep %}

{% step %}

#### PAT Generation — Step 5

Click **"Create token"** to generate it.
{% endstep %}

{% step %}

#### PAT Generation — Step 6

You will now see your newly generated PAT. Save this token securely — once you leave the page, you won’t be able to view it again.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Ensure your PAT has sufficient permissions for the API operations you plan to perform.
{% endhint %}
{% endstep %}

{% step %}

### Workspace/Organization ID

Globally unique identifier for your workspace or organization.
{% endstep %}

{% step %}

### Proxy URL

Proxy URL. (optional)
{% endstep %}

{% step %}

### Is Secure?

Choose this if your connection is going to be over HTTPS.
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
Attention: Please perform a connection test to ensure there is a valid connection to the Asana host. When the discovery operation is finalized, you will be able to see the details on the Assets page.
{% endhint %}


---

# 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.octoxlabs.com/adapters/adapters/asana.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.