Asana

Name: Asana API
Brand: Asana
Availability: InStock

✓ Official Vendor SpecProductivityTask Managementoauth2, bearer167 EndpointsREST

For Agents

Assign tasks, track project milestones, and query workload across teams. Supports goals, portfolios, custom fields, and real-time event subscriptions for 167 operations.

Install Jentic One Beta

Connect the Asana to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Asana, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Asana API.

Assign tasks with due dates, dependencies, and custom field values across multiple projects

Track goal progress with metric targets and supporting work relationships

Build and reorder project timelines with milestones and section groupings

GET STARTED

Start building with Asana API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Asana API for, with concrete tasks.

★ AI Agent Task Automation

AI agents use the Asana API through Jentic to automate task creation, assignment, and status updates without manual intervention. An agent can search for the right operation by intent, load the task creation schema, and execute it in under a minute. This replaces manual copy-paste workflows and ensures tasks are created with correct custom fields, assignees, and project memberships from the start.

Create a task in project 'Sprint Backlog' assigned to user GID 12345 with due date 2026-05-15, custom field 'Priority' set to 'High', and add it to section 'To Do'

Cross-Team Project Tracking

Track work across multiple teams using portfolios and goals. The Asana API exposes 167 endpoints for querying project status, goal completion percentages, and portfolio item ordering. Teams get a single source of truth for who owns what, which milestones are at risk, and how individual tasks roll up into strategic objectives.

Retrieve all items in portfolio GID 67890 and return each project's completion percentage and owner

Sprint Planning and Backlog Management

Plan sprints by querying tasks across projects, filtering by custom fields like story points and priority, then reorganizing them into sections representing sprint phases. The API supports bulk task operations, section reordering, and project template instantiation so that repeatable sprint structures can be set up programmatically each cycle.

List all tasks in project 'Product Backlog' with custom field 'Story Points' greater than 3, then move them to section 'Sprint 12'

Compliance Audit Trail

Access workspace-level audit log events through the Asana API to track who changed what and when. The audit log endpoint returns timestamped records of task modifications, permission changes, and data exports. This supports SOC 2 and internal compliance requirements without requiring third-party logging tools.

Fetch audit log events for workspace GID 11111 from the last 7 days filtered to 'task_deleted' and 'project_archived' event types

Key Endpoints

167 endpoints — organize and track work across teams with projects, tasks, subtasks, custom fields, goals, and portfolios.

METHOD

PATH

DESCRIPTION

POST

/tasks

Create a new task

GET

/projects/{project_gid}/tasks

List tasks in a project

PUT

/tasks/{task_gid}

Update a task

GET

/goals

List goals in a workspace

POST

/goals/{goal_gid}/setMetricCurrentValue

Update goal metric progress

GET

/portfolios/{portfolio_gid}/items

List items in a portfolio

GET

/workspaces/{workspace_gid}/audit_log_events

Query workspace audit log

GET

/events

Poll for resource change events

POST

/tasks

Create a new task

GET

/projects/{project_gid}/tasks

List tasks in a project

PUT

/tasks/{task_gid}

Update a task

GET

/goals

List goals in a workspace

POST

/goals/{goal_gid}/setMetricCurrentValue

Update goal metric progress

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Asana OAuth 2.0 tokens and Personal Access Tokens are stored encrypted in the Jentic MAXsystem vault. Agents receive scoped access tokens — raw keys and refresh tokens never enter the agent context.

Intent-based discovery

Agents search by intent (e.g., 'create a task in Asana with custom fields') and Jentic returns matching operations from the 167-endpoint spec with their input schemas, so agents can call the right endpoint without browsing Asana developer docs.

Time to first call

Direct Asana integration: 3-5 days for OAuth flow, webhook setup, and error handling. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Asana API through Jentic.

What authentication does the Asana API use?

The Asana API supports OAuth 2.0 and Personal Access Tokens (PATs). OAuth 2.0 is used for app integrations requiring user consent, while PATs provide direct access for scripts and agents. Through Jentic, these credentials are stored encrypted in the MAXsystem vault — agents receive scoped tokens without handling raw secrets. Configure access at https://app.jentic.com/sign-up.

Can I track goal progress with the Asana API?

Yes. The /goals endpoint lists goals filtered by workspace, team, or time period. Each goal has metric fields (current_number_value, target_number_value) that you update via POST /goals/{goal_gid}/setMetricCurrentValue. Supporting relationships link tasks and projects to goals so progress rolls up automatically.

What are the rate limits for the Asana API?

Asana enforces a rate limit of 1,500 requests per minute per Personal Access Token or OAuth token. Responses include X-RateLimit-Remaining headers. Batch operations on up to 10 actions per request are available via POST /batch to reduce call volume for bulk updates.

How do I create a task with custom fields through Jentic?

Search Jentic for 'create asana task with custom fields'. Jentic returns the POST /tasks operation schema including the custom_fields parameter (a map of field GID to value). Load the schema, populate assignee, due_on, projects, and custom_fields, then execute. The full flow takes under a minute compared to days of direct integration work.

Does the Asana API support real-time event streaming?

Asana provides a polling-based event system via GET /events. You supply a resource GID and a sync token; the API returns all changes since that token. This covers task creates, updates, deletes, and project membership changes. Poll intervals of 5-10 seconds are recommended for near-real-time sync.

Can I instantiate projects from templates via the API?

Yes. Use GET /project_templates to list available templates, then POST /project_templates/{project_template_gid}/instantiateProject with a name and team GID. The new project inherits all sections, tasks, custom fields, and rules from the template.

Asana

Connect the Asana to your agent

Capabilities

Start building with Asana API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs