Docs / Work tools

Asana

Authorize an Asana account over OAuth so the agent can read, create, comment on and complete tasks.

Pangea connects to Asana through OAuth. The agent can then read, create, comment on and complete tasks in the workspaces the authorizing account can reach.

Connect

1. As a team Administrator, open Connectors, find Asana and click Add, then click Authorize Asana.
2. Sign in to the Asana account you want to use and review the request.
3. Approve it. Asana sends you back to the Mac app, and the connection completes by itself.

The authorizing account decides which workspaces, projects and tasks the agent can reach. An OAuth grant does not bypass Asana project permissions. Authorizing the same account again updates the existing connection.

Verify and work

Select the connection in a conversation. Ask the agent to list the workspaces it can see, or to read one task you know. Confirm the workspace before it creates anything.

When you ask for a change, name the project, the assignee and what should change. A task change does not create an infrastructure plan by itself. Permission modes control the prompts you see while it runs. If a task tracks a fix, have the agent complete it only after the fix is verified.

Troubleshooting and removal

If a task is missing, check which account authorized the connection and whether it can access that project. Authorize again if the grant expired or was revoked.

To end access, remove the connection in Pangea and revoke the app in your Asana settings. Tasks and comments the agent already wrote stay in Asana.

See Asana OAuth for how Asana handles grants.