Project management
Asana in your product and your AI agents, through one API
The Asana toolkit lists workspaces, teams and projects, and creates, reads, updates and deletes tasks and their comments. Your product or AI agent calls them through Connect, which stores the API key or OAuth credentials and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/asana_create_project/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"data": {}
}
}How it works
From a connected customer to the first Asana call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Asana account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Asana.
Push work into Asana
A SaaS turns an event, such as an approved proposal, into a task in the right project of the customer's Asana.
Mirror status both ways
An agency tool lists the tasks of a project and completes or updates them from its own dashboard.
Task agent with comments
An AI agent creates a task from a conversation, reads its stories and adds a comment with the next step.
Tools
12 Asana tools
- List workspacesGETLists the workspaces and organizations the user can see. Use the gid of an item as workspace in the other tools. Send limit to page; the next_page.offset of the response goes in offset.
- List teamsGETLists the teams of an organization that the user can see. A project created in an organization needs the gid of one of them as team.
- List projectsGETLists the projects of a workspace. Only gid and name come back unless opt_fields lists more. Send limit to page; the next_page.offset of the response goes in offset.
- Create projectPOSTCreates a project and returns it. The fields go inside data, which needs name and workspace, plus team when the workspace is an organization.
- Update projectPUTUpdates a project and returns it. Only the fields sent inside data change.
- List tasksGETLists the tasks of a project or section, or the tasks assigned to someone in a workspace. Send project, or section, or assignee together with workspace. Only gid and name come back unless opt_fields lists more. Send limit to page; the next_page.offset of the response goes in offset.
- Get taskGETReturns the full record of one task: name, notes, assignee, dates, completion, projects and custom fields.
- Create taskPOSTCreates a task and returns it. The fields go inside data, which needs workspace, projects or parent; projects and parent already set the workspace. Use due_on for a date or due_at for a date and time, never both.
- Update taskPUTUpdates a task and returns it. Only the fields sent inside data change; completed set to true completes the task. Projects and followers do not change here.
- Delete taskDELETEDeletes a task. It goes to the trash of the user and can be restored there within 30 days.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/asana, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
Questions about the Asana toolkit
Do I need to build against the Asana API?
No. Connect ships 12 Asana tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Asana account?
With the mode the toolkit accepts: API key, OAuth with your product's app. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
