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

# Asana

> Authorize a workspace to read and update tasks through an agent.

An Administrator opens **Connectors → Connect → Asana** and starts authorization.
Sign in to the intended Asana account, review the OAuth request and return to
Nuphos. The granted account and workspace determine which projects and tasks
can be reached; an OAuth grant does not bypass Asana project permissions.

## Verify and work

Select the connection in a conversation and ask the agent to list accessible
workspaces or read one known task. Confirm the workspace before creating work.
The agent can read, create, comment on and complete tasks within the grant.

Name the project, assignee and intended change when publishing. A task change
is not an infrastructure plan by default; [permission modes](https://docs.nuphos.ai/security/auto-mode.md)
control runtime prompts. If a task is being used to track a fix, move it to
complete only after the fix is actually verified.

## Troubleshooting and removal

For a missing task, check which account authorized the connection and whether it
can access the project. Reauthorize if the grant expired or was revoked. Remove
the connection in Nuphos and revoke app access in Asana to end authorization;
existing tasks and comments stay in Asana.

See [Asana OAuth](https://developers.asana.com/docs/oauth) for the provider model.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.