@pipedream/asana 1.1.1 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/actions/add-task-to-section/add-task-to-section.mjs +4 -16
  2. package/actions/common/common.mjs +3 -6
  3. package/actions/create-project/create-project.mjs +8 -16
  4. package/actions/create-subtask/create-subtask.mjs +9 -23
  5. package/actions/create-task/create-task.mjs +9 -23
  6. package/actions/create-task-comment/create-task-comment.mjs +5 -7
  7. package/actions/create-task-from-template/create-task-from-template.mjs +4 -6
  8. package/actions/delete-task/delete-task.mjs +4 -6
  9. package/actions/find-task-by-id/find-task-by-id.mjs +5 -7
  10. package/actions/get-portfolio/get-portfolio.mjs +2 -2
  11. package/actions/get-tasks-from-task-list/get-tasks-from-task-list.mjs +2 -2
  12. package/actions/list-organizations-options/list-organizations-options.mjs +10 -3
  13. package/actions/list-portfolio-items/list-portfolio-items.mjs +2 -2
  14. package/actions/list-portfolios/list-portfolios.mjs +3 -3
  15. package/actions/list-tags/list-tags.mjs +69 -0
  16. package/actions/list-task-stories/list-task-stories.mjs +28 -17
  17. package/actions/list-task-templates/list-task-templates.mjs +61 -0
  18. package/actions/list-teams/list-teams.mjs +3 -3
  19. package/actions/list-users/list-users.mjs +3 -3
  20. package/actions/list-workspaces/list-workspaces.mjs +2 -2
  21. package/actions/search-projects/search-projects.mjs +82 -35
  22. package/actions/search-sections/search-sections.mjs +9 -6
  23. package/actions/search-tasks/search-tasks.mjs +9 -14
  24. package/actions/search-tasks-premium/search-tasks-premium.mjs +9 -13
  25. package/actions/search-user-projects/search-user-projects.mjs +16 -9
  26. package/actions/update-task/update-task.mjs +6 -13
  27. package/asana.app.mjs +77 -88
  28. package/package.json +1 -1
  29. package/sources/common/common.mjs +1 -1
  30. package/sources/new-completed-task/new-completed-task.mjs +2 -2
  31. package/sources/new-project/new-project.mjs +1 -1
  32. package/sources/new-story/new-story.mjs +2 -2
  33. package/sources/new-subtask/new-subtask.mjs +3 -3
  34. package/sources/new-tag/new-tag.mjs +2 -2
  35. package/sources/new-task/new-task.mjs +2 -2
  36. package/sources/new-team/new-team.mjs +1 -1
  37. package/sources/new-user/new-user.mjs +1 -1
  38. package/sources/new-workspace/new-workspace.mjs +1 -1
  39. package/sources/tag-added-to-task/tag-added-to-task.mjs +3 -3
  40. package/sources/tags-added-to-any-task/tags-added-to-any-task.mjs +3 -3
  41. package/sources/task-assigned-in-project/task-assigned-in-project.mjs +3 -3
  42. package/sources/task-field-updated-in-project/task-field-updated-in-project.mjs +2 -5
  43. package/sources/task-updated-in-project/task-updated-in-project.mjs +4 -4
@@ -3,9 +3,9 @@ import common from "../common/common.mjs";
3
3
 
4
4
  export default {
5
5
  name: "Add Task To Section",
6
- description: "Add a task to a specific, existing section. This will remove the task from other sections of the project. [See the documentation](https://developers.asana.com/docs/add-task-to-section)",
6
+ description: "Moves a task into a specific section within an Asana project, removing it from any other section it currently occupies in that project. Use **Search Sections** to find the section GID and **Search Tasks** to find the task GID. Returns an empty object `{}` on success. Example: call with `project: '1204567890123456'`, `task: '1202345678901234'`, `section_gid: '1203456789012345'` → task is moved into that section and returns `{}`. [See the documentation](https://developers.asana.com/docs/add-task-to-section)",
7
7
  key: "asana-add-task-to-section",
8
- version: "0.2.16",
8
+ version: "1.0.0",
9
9
  annotations: {
10
10
  destructiveHint: false,
11
11
  openWorldHint: true,
@@ -14,17 +14,14 @@ export default {
14
14
  type: "action",
15
15
  ai: "optimized",
16
16
  props: {
17
- ...common.props,
17
+ asana: common.props.asana,
18
18
  task: {
19
19
  label: "Task",
20
20
  type: "string",
21
- description: "The task to add to this section.",
21
+ description: "The task to add to this section (a task GID, e.g. `1202345678901234`).",
22
22
  propDefinition: [
23
23
  asana,
24
24
  "tasks",
25
- (c) => ({
26
- project: c.project,
27
- }),
28
25
  ],
29
26
  },
30
27
  section_gid: {
@@ -34,9 +31,6 @@ export default {
34
31
  propDefinition: [
35
32
  asana,
36
33
  "sections",
37
- (c) => ({
38
- project: c.project,
39
- }),
40
34
  ],
41
35
  },
42
36
  insert_before: {
@@ -47,9 +41,6 @@ export default {
47
41
  propDefinition: [
48
42
  asana,
49
43
  "tasks",
50
- (c) => ({
51
- project: c.project,
52
- }),
53
44
  ],
54
45
  },
55
46
  insert_after: {
@@ -60,9 +51,6 @@ export default {
60
51
  propDefinition: [
61
52
  asana,
62
53
  "tasks",
63
- (c) => ({
64
- project: c.project,
65
- }),
66
54
  ],
67
55
  },
68
56
  },
@@ -4,13 +4,13 @@ export default {
4
4
  props: {
5
5
  asana,
6
6
  workspace: {
7
- label: "Workspace",
8
- description: "Gid of a workspace.",
9
- type: "string",
10
7
  propDefinition: [
11
8
  asana,
12
9
  "workspaces",
13
10
  ],
11
+ label: "Workspace",
12
+ description: "GID of the workspace, e.g. `1200123456789012`. Use **List Workspaces** to find available workspace GIDs.",
13
+ type: "string",
14
14
  },
15
15
  project: {
16
16
  label: "Project",
@@ -18,9 +18,6 @@ export default {
18
18
  propDefinition: [
19
19
  asana,
20
20
  "projects",
21
- (c) => ({
22
- workspace: c.workspace,
23
- }),
24
21
  ],
25
22
  },
26
23
  },
@@ -4,8 +4,9 @@ import constants from "../common/constants.mjs";
4
4
  export default {
5
5
  key: "asana-create-project",
6
6
  name: "Create Project",
7
- description: "Create a new project in a workspace or team. [See the documentation](https://developers.asana.com/docs/create-a-project)",
8
- version: "0.10.9",
7
+ description: "Creates a new project in an Asana workspace or team. Use this to set up a new initiative, sprint, or work stream. For organization workspaces you must supply a `team` GID (use **List Teams** to find it). Returns the new project record including its `gid`. Example: call with `projectName: 'Q4 Marketing Campaign'`, `workspace: '1200123456789012'`, `team: '1203456789012345'`, `defaultView: 'board'` → returns `{gid: '1204567890123456', name: 'Q4 Marketing Campaign'}`. [See the documentation](https://developers.asana.com/docs/create-a-project)",
8
+ version: "1.0.0",
9
+ ai: "optimized",
9
10
  annotations: {
10
11
  destructiveHint: false,
11
12
  openWorldHint: true,
@@ -16,7 +17,7 @@ export default {
16
17
  asana,
17
18
  workspace: {
18
19
  label: "Workspace",
19
- description: "GID of a workspace.",
20
+ description: "GID of a workspace. Use **List Workspaces** to find available workspace GIDs.",
20
21
  type: "string",
21
22
  propDefinition: [
22
23
  asana,
@@ -27,15 +28,12 @@ export default {
27
28
  propDefinition: [
28
29
  asana,
29
30
  "teams",
30
- ({ workspace }) => ({
31
- workspace,
32
- }),
33
31
  ],
34
32
  type: "string",
35
33
  label: "Team",
36
34
  description: "The team that this project is shared with. If the workspace for your project is an organization, you must supply a team to share the project with",
37
35
  },
38
- name: {
36
+ projectName: {
39
37
  label: "Name",
40
38
  description: "Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
41
39
  type: "string",
@@ -103,15 +101,12 @@ export default {
103
101
  },
104
102
  followers: {
105
103
  label: "Followers",
106
- description: "Comma separated string of users. Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project.",
104
+ description: "GIDs of users to add as followers (e.g. `1198765432109876`). Followers are a subset of members who have opted in to receive \"tasks added\" notifications for a project. Use **List Users** to find available user GIDs.",
107
105
  type: "string[]",
108
106
  optional: true,
109
107
  propDefinition: [
110
108
  asana,
111
109
  "users",
112
- ({ workspace }) => ({
113
- workspace,
114
- }),
115
110
  ],
116
111
  },
117
112
  htmlNotes: {
@@ -122,15 +117,12 @@ export default {
122
117
  },
123
118
  owner: {
124
119
  label: "Owner",
125
- description: "The current owner of the project",
120
+ description: "The current owner of the project (a user GID, e.g. `1198765432109876`). Use **List Users** to find available user GIDs.",
126
121
  type: "string",
127
122
  optional: true,
128
123
  propDefinition: [
129
124
  asana,
130
125
  "users",
131
- ({ workspace }) => ({
132
- workspace,
133
- }),
134
126
  ],
135
127
  },
136
128
  defaultAccessLevel: {
@@ -172,7 +164,7 @@ export default {
172
164
  method: "post",
173
165
  data: {
174
166
  data: {
175
- name: this.name,
167
+ name: this.projectName,
176
168
  notes: this.notes,
177
169
  team: this.team,
178
170
  color: this.color,
@@ -4,8 +4,9 @@ import common from "../common/common.mjs";
4
4
  export default {
5
5
  key: "asana-create-subtask",
6
6
  name: "Create Subtask",
7
- description: "Creates a new subtask and adds it to the parent task. [See the documentation](https://developers.asana.com/docs/create-a-subtask)",
8
- version: "0.4.8",
7
+ description: "Creates a new subtask nested under an existing parent task. Use this when the work is a sub-item of another task; for top-level tasks use **Create Task**. The parent task GID is required. Returns the new subtask record including its `gid`. Example: call with `task_gid: '1202345678901234'`, `subtaskName: 'Write first draft'`, `due_on: '2026-10-05'` → returns `{gid: '1207890123456789', name: 'Write first draft', resource_type: 'task'}`. [See the documentation](https://developers.asana.com/docs/create-a-subtask)",
8
+ version: "1.0.0",
9
+ ai: "optimized",
9
10
  annotations: {
10
11
  destructiveHint: false,
11
12
  openWorldHint: true,
@@ -16,45 +17,36 @@ export default {
16
17
  ...common.props,
17
18
  task_gid: {
18
19
  label: "Task GID",
19
- description: "The task GID to operate on.",
20
+ description: "The parent task GID to operate on. Use **Search Tasks** to find available task GIDs.",
20
21
  type: "string",
21
22
  propDefinition: [
22
23
  asana,
23
24
  "tasks",
24
- (c) => ({
25
- project: c.project,
26
- }),
27
25
  ],
28
26
  },
29
- name: {
27
+ subtaskName: {
30
28
  label: "Name",
31
29
  description: "Name of the subtask. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
32
30
  type: "string",
33
31
  },
34
32
  assignee: {
35
33
  label: "Assignee",
36
- description: "Gid of a user.",
34
+ description: "Gid of a user. Use **List Users** to find available user GIDs.",
37
35
  type: "string",
38
36
  optional: true,
39
37
  propDefinition: [
40
38
  asana,
41
39
  "users",
42
- ({ workspace }) => ({
43
- workspace,
44
- }),
45
40
  ],
46
41
  },
47
42
  assignee_section: {
48
43
  label: "Assignee Section",
49
- description: "The assignee section is a subdivision of a project that groups tasks together in the assignee's \"My Tasks\" list.",
44
+ description: "The assignee section is a subdivision of a project that groups tasks together in the assignee's \"My Tasks\" list (a section GID, e.g. `1203456789012345`). Use **Get Tasks From Task List** with `optFields` including `assignee_section` to retrieve the authenticated user's own My Tasks section GIDs. GIDs for another assignee's sections must come from that person's own My Tasks list, not from this account.",
50
45
  type: "string",
51
46
  optional: true,
52
47
  propDefinition: [
53
48
  asana,
54
49
  "sections",
55
- (c) => ({
56
- project: c.project,
57
- }),
58
50
  ],
59
51
  },
60
52
  completed: {
@@ -77,15 +69,12 @@ export default {
77
69
  },
78
70
  followers: {
79
71
  label: "Followers",
80
- description: "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
72
+ description: "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user (e.g. `1198765432109876`). Use **List Users** to find available user GIDs.",
81
73
  type: "string[]",
82
74
  optional: true,
83
75
  propDefinition: [
84
76
  asana,
85
77
  "users",
86
- ({ workspace }) => ({
87
- workspace,
88
- }),
89
78
  ],
90
79
  },
91
80
  html_notes: {
@@ -110,9 +99,6 @@ export default {
110
99
  propDefinition: [
111
100
  asana,
112
101
  "tags",
113
- ({ workspace }) => ({
114
- workspace,
115
- }),
116
102
  ],
117
103
  optional: true,
118
104
  },
@@ -123,7 +109,7 @@ export default {
123
109
  method: "post",
124
110
  data: {
125
111
  data: {
126
- name: this.name,
112
+ name: this.subtaskName,
127
113
  assignee: this.assignee,
128
114
  assignee_section: this.assignee_section,
129
115
  completed: this.completed,
@@ -4,8 +4,9 @@ import common from "../common/common.mjs";
4
4
  export default {
5
5
  key: "asana-create-task",
6
6
  name: "Create Task",
7
- description: "Creates a new task. [See the documentation](https://developers.asana.com/docs/create-a-task)",
8
- version: "0.4.8",
7
+ description: "Creates a new task in Asana. Use this to add a standalone task to a workspace or project. For subtasks, use **Create Subtask** instead; for template-based tasks, use **Create Task from Template**. Returns the new task record including its `gid`. Example: call with `taskName: 'Review Q3 report'`, `workspace: '1200123456789012'`, `due_on: '2026-10-01'` → returns `{gid: '1202345678901234', name: 'Review Q3 report', resource_type: 'task'}`. [See the documentation](https://developers.asana.com/docs/create-a-task)",
8
+ version: "1.0.0",
9
+ ai: "optimized",
9
10
  annotations: {
10
11
  destructiveHint: false,
11
12
  openWorldHint: true,
@@ -14,7 +15,7 @@ export default {
14
15
  type: "action",
15
16
  props: {
16
17
  ...common.props,
17
- name: {
18
+ taskName: {
18
19
  label: "Name",
19
20
  description: "Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.",
20
21
  type: "string",
@@ -23,36 +24,27 @@ export default {
23
24
  propDefinition: [
24
25
  asana,
25
26
  "tags",
26
- ({ workspace }) => ({
27
- workspace,
28
- }),
29
27
  ],
30
28
  optional: true,
31
29
  },
32
30
  assignee: {
33
31
  label: "Assignee",
34
- description: "Gid of a user.",
32
+ description: "Gid of a user. Use **List Users** to find available user GIDs.",
35
33
  type: "string",
36
34
  optional: true,
37
35
  propDefinition: [
38
36
  asana,
39
37
  "users",
40
- ({ workspace }) => ({
41
- workspace,
42
- }),
43
38
  ],
44
39
  },
45
40
  assignee_section: {
46
41
  label: "Assignee Section",
47
- description: "The assignee section is a subdivision of a project that groups tasks together in the assignee's \"My Tasks\" list.",
42
+ description: "The assignee section is a subdivision of a project that groups tasks together in the assignee's \"My Tasks\" list (a section GID, e.g. `1203456789012345`). Use **Get Tasks From Task List** with `optFields` including `assignee_section` to retrieve the authenticated user's own My Tasks section GIDs. GIDs for another assignee's sections must come from that person's own My Tasks list, not from this account.",
48
43
  type: "string",
49
44
  optional: true,
50
45
  propDefinition: [
51
46
  asana,
52
47
  "sections",
53
- (c) => ({
54
- project: c.project,
55
- }),
56
48
  ],
57
49
  },
58
50
  completed: {
@@ -75,15 +67,12 @@ export default {
75
67
  },
76
68
  followers: {
77
69
  label: "Followers",
78
- description: "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
70
+ description: "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user (e.g. `1198765432109876`). Use **List Users** to find available user GIDs.",
79
71
  type: "string[]",
80
72
  optional: true,
81
73
  propDefinition: [
82
74
  asana,
83
75
  "users",
84
- ({ workspace }) => ({
85
- workspace,
86
- }),
87
76
  ],
88
77
  },
89
78
  html_notes: {
@@ -100,15 +89,12 @@ export default {
100
89
  },
101
90
  parent: {
102
91
  label: "Parent",
103
- description: "Gid of a task.",
92
+ description: "Gid of the parent task, e.g. `1202345678901234`. Use **Search Tasks** to find available task GIDs.",
104
93
  type: "string",
105
94
  optional: true,
106
95
  propDefinition: [
107
96
  asana,
108
97
  "tasks",
109
- (c) => ({
110
- project: c.project,
111
- }),
112
98
  ],
113
99
  },
114
100
  start_on: {
@@ -136,7 +122,7 @@ export default {
136
122
  method: "post",
137
123
  data: {
138
124
  data: {
139
- name: this.name,
125
+ name: this.taskName,
140
126
  assignee: this.assignee,
141
127
  assignee_section: this.assignee_section,
142
128
  completed: this.completed,
@@ -4,8 +4,9 @@ import common from "../common/common.mjs";
4
4
  export default {
5
5
  key: "asana-create-task-comment",
6
6
  name: "Create Task Comment",
7
- description: "Adds a comment to a task. [See the documentation](https://developers.asana.com/docs/create-a-story-on-a-task)",
8
- version: "0.2.15",
7
+ description: "Adds a comment (story) to an existing Asana task. Use this to post a text update or pinned note visible to task followers. Provide either `text` (plain text) or `html_text` (HTML-formatted), but not both. Returns the new story record including its `gid` and `type`. Example: call with `task_gid: '1202345678901234'`, `text: 'Approved — ready to ship!'` → returns `{gid: '1209012345678901', type: 'comment', text: 'Approved — ready to ship!'}`. [See the documentation](https://developers.asana.com/docs/create-a-story-on-a-task)",
8
+ version: "1.0.0",
9
+ ai: "optimized",
9
10
  annotations: {
10
11
  destructiveHint: false,
11
12
  openWorldHint: true,
@@ -13,17 +14,14 @@ export default {
13
14
  },
14
15
  type: "action",
15
16
  props: {
16
- ...common.props,
17
+ asana: common.props.asana,
17
18
  task_gid: {
18
19
  label: "Task GID",
19
- description: "The task GID to operate on.",
20
+ description: "The task GID to operate on. Use **Search Tasks** to find available task GIDs.",
20
21
  type: "string",
21
22
  propDefinition: [
22
23
  asana,
23
24
  "tasks",
24
- (c) => ({
25
- project: c.project,
26
- }),
27
25
  ],
28
26
  },
29
27
  text: {
@@ -3,8 +3,9 @@ import common from "../common/common.mjs";
3
3
  export default {
4
4
  name: "Create Task from Template",
5
5
  key: "asana-create-task-from-template",
6
- description: "Creates a new task from a task template. [See the documentation](https://developers.asana.com/reference/instantiatetask)",
7
- version: "0.0.10",
6
+ description: "Creates a new Asana task by instantiating an existing task template. Use this when a team has a reusable task structure (e.g. a bug-report or onboarding template); for ad-hoc tasks use **Create Task**. Use **List Task Templates** to find the template GID. This kicks off an asynchronous job — the response is a job resource, not the finished task; `new_task.gid` is available immediately but the task's fields may still be populating, so use **Find Task by ID** if you need to confirm it's ready. The new task's project and memberships are determined by the template itself, not by any project passed here. Example: call with `taskTemplateId: '1205678901234567'`, `name: 'Bug: Login page crash'` → returns `{gid: '1205555555555555', resource_type: 'job', new_task: {gid: '1206789012345678'}}`. [See the documentation](https://developers.asana.com/reference/instantiatetask)",
7
+ version: "1.0.0",
8
+ ai: "optimized",
8
9
  annotations: {
9
10
  destructiveHint: false,
10
11
  openWorldHint: true,
@@ -12,14 +13,11 @@ export default {
12
13
  },
13
14
  type: "action",
14
15
  props: {
15
- ...common.props,
16
+ asana: common.props.asana,
16
17
  taskTemplateId: {
17
18
  propDefinition: [
18
19
  common.props.asana,
19
20
  "taskTemplate",
20
- (c) => ({
21
- project: c.project,
22
- }),
23
21
  ],
24
22
  },
25
23
  name: {
@@ -4,8 +4,9 @@ import common from "../common/common.mjs";
4
4
  export default {
5
5
  key: "asana-delete-task",
6
6
  name: "Delete Task",
7
- description: "Deletes a specific and existing task. [See the documentation](https://developers.asana.com/docs/delete-a-task)",
8
- version: "0.0.16",
7
+ description: "Deletes an Asana task. This moves the task to the deleting user's trash and removes it from active views immediately; it can be recovered for 30 days before Asana permanently removes it. Use **Find Task by ID** to confirm the task GID before deleting. Returns an empty data object `{}` on success. Example: call with `task_gid: '1202345678901234'` → returns `{}`. [See the documentation](https://developers.asana.com/docs/delete-a-task)",
8
+ version: "1.0.0",
9
+ ai: "optimized",
9
10
  annotations: {
10
11
  destructiveHint: true,
11
12
  openWorldHint: true,
@@ -13,7 +14,7 @@ export default {
13
14
  },
14
15
  type: "action",
15
16
  props: {
16
- ...common.props,
17
+ asana: common.props.asana,
17
18
  task_gid: {
18
19
  label: "Task GID",
19
20
  description: "The ID of the task to delete.",
@@ -21,9 +22,6 @@ export default {
21
22
  propDefinition: [
22
23
  asana,
23
24
  "tasks",
24
- (c) => ({
25
- project: c.project,
26
- }),
27
25
  ],
28
26
  },
29
27
  },
@@ -4,8 +4,9 @@ import common from "../common/common.mjs";
4
4
  export default {
5
5
  key: "asana-find-task-by-id",
6
6
  name: "Find Task by ID",
7
- description: "Searches for a task by id. Returns the complete task record for a single task. [See the documentation](https://developers.asana.com/docs/get-a-task)",
8
- version: "0.3.0",
7
+ description: "Retrieves the complete record for a single Asana task by its GID. Use this to fetch full task details (description, assignee, due date, custom fields) after obtaining a task GID from **Search Tasks**. Use `optFields` to request additional fields not returned by default. Example: call with `task_gid: '1202345678901234'`, `optFields: ['due_on','assignee','custom_fields']` → returns the full task record for that GID. [See the documentation](https://developers.asana.com/docs/get-a-task)",
8
+ version: "1.0.0",
9
+ ai: "optimized",
9
10
  annotations: {
10
11
  destructiveHint: false,
11
12
  openWorldHint: true,
@@ -13,17 +14,14 @@ export default {
13
14
  },
14
15
  type: "action",
15
16
  props: {
16
- ...common.props,
17
+ asana: common.props.asana,
17
18
  task_gid: {
18
19
  label: "Task GID",
19
- description: "The ID of the task to update.",
20
+ description: "The ID of the task to retrieve, e.g. `1202345678901234`. Use **Search Tasks** to find available task GIDs.",
20
21
  type: "string",
21
22
  propDefinition: [
22
23
  asana,
23
24
  "tasks",
24
- (c) => ({
25
- project: c.project,
26
- }),
27
25
  ],
28
26
  },
29
27
  optFields: {
@@ -3,8 +3,8 @@ import asana from "../../asana.app.mjs";
3
3
  export default {
4
4
  key: "asana-get-portfolio",
5
5
  name: "Get Portfolio",
6
- description: "Returns the complete portfolio record for a single portfolio. Use this after **List Portfolios** to retrieve full portfolio details including custom fields, members, and owner; the `optFields` prop requests specific properties (e.g. `custom_field_settings`, `members`, `start_on`, `due_on`). [See the documentation](https://developers.asana.com/reference/getportfolio)",
7
- version: "0.0.2",
6
+ description: "Returns the complete portfolio record for a single portfolio. Use this after **List Portfolios** to retrieve full portfolio details including custom fields, members, and owner; the `optFields` prop requests specific properties (e.g. `custom_field_settings`, `members`, `start_on`, `due_on`). Example: call with `portfolioId: '1208901234567890'`, `optFields: ['members','owner','due_on']` → returns `{gid: '1208901234567890', name: 'Product Launch', owner: {...}, members: [...]}`. [See the documentation](https://developers.asana.com/reference/getportfolio)",
7
+ version: "0.0.3",
8
8
  annotations: {
9
9
  destructiveHint: false,
10
10
  openWorldHint: true,
@@ -3,8 +3,8 @@ import asana from "../../asana.app.mjs";
3
3
  export default {
4
4
  key: "asana-get-tasks-from-task-list",
5
5
  name: "Get Tasks From Task List",
6
- description: "Returns tasks from the user's personal **My Tasks** inbox — NOT a project task list. Use this when the user asks for 'my tasks', 'my task list', or 'My Tasks'. Only a workspace GID is needed; no project GID required. [See the documentation](https://developers.asana.com/reference/gettasksforusertasklist)",
7
- version: "1.1.1",
6
+ description: "Returns tasks from the authenticated user's personal **My Tasks** inbox — NOT a project task list. Use this when the user asks for 'my tasks', 'my task list', or 'My Tasks'. Only a workspace GID is needed; no project GID required. Example: call with `workspace: '1200123456789012'` → returns all tasks in the authenticated user's My Tasks list, e.g. `[{gid: '1202345678901234', name: 'Review Q3 report'}]`. [See the documentation](https://developers.asana.com/reference/gettasksforusertasklist)",
7
+ version: "1.1.2",
8
8
  annotations: {
9
9
  destructiveHint: false,
10
10
  openWorldHint: true,
@@ -3,9 +3,10 @@ import asana from "../../asana.app.mjs";
3
3
  export default {
4
4
  key: "asana-list-organizations-options",
5
5
  name: "List Organizations Options",
6
- description: "Retrieves available options for the Organizations field.",
7
- version: "0.0.3",
6
+ description: "Returns all Asana workspaces for the authenticated account that are organizations (i.e. `is_organization: true`). Use this to obtain organization GIDs for org-scoped actions. Prefer **List Workspaces** when you need all workspaces including non-organization ones. Returns an array of `{label, value}` pairs where `value` is the organization GID. Example: returns `[{label: 'Acme Corp', value: '1200123456789012'}]`. [See the documentation](https://developers.asana.com/reference/getworkspaces)",
7
+ version: "0.0.4",
8
8
  type: "action",
9
+ ai: "optimized",
9
10
  annotations: {
10
11
  destructiveHint: false,
11
12
  openWorldHint: true,
@@ -15,7 +16,13 @@ export default {
15
16
  asana,
16
17
  },
17
18
  async run({ $ }) {
18
- const options = await asana.propDefinitions.organizations.options.call(this.asana);
19
+ const organizations = await this.asana.getOrganizations({
20
+ $,
21
+ });
22
+ const options = organizations.map((organization) => ({
23
+ label: organization.name,
24
+ value: organization.gid,
25
+ }));
19
26
  $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
20
27
  ? ""
21
28
  : "s"}`);
@@ -4,8 +4,8 @@ import constants from "../common/constants.mjs";
4
4
  export default {
5
5
  key: "asana-list-portfolio-items",
6
6
  name: "List Portfolio Items",
7
- description: "Returns a list of the items (projects) in the given portfolio. Use this after **List Portfolios** to answer count, timing, and spend questions; the default Opt Fields include `created_at`, `start_on`, `due_on`, and `custom_fields`. Archived filtering happens client-side because Asana has no server-side filter on this endpoint. [See the documentation](https://developers.asana.com/reference/getitemsforportfolio)",
8
- version: "0.0.2",
7
+ description: "Returns a list of the projects in an Asana portfolio. Use this after **List Portfolios** to enumerate projects within a portfolio and answer count, timing, and spend questions; the default Opt Fields include `created_at`, `start_on`, `due_on`, and `custom_fields`. Archived filtering happens client-side. Example: call with `portfolioId: '1208901234567890'`, `excludeArchived: true` → returns active projects like `[{gid: '1204567890123456', name: 'Website Redesign', start_on: '2026-01-01', due_on: '2026-06-30'}]`. [See the documentation](https://developers.asana.com/reference/getitemsforportfolio)",
8
+ version: "0.0.3",
9
9
  annotations: {
10
10
  destructiveHint: false,
11
11
  openWorldHint: true,
@@ -3,8 +3,8 @@ import asana from "../../asana.app.mjs";
3
3
  export default {
4
4
  key: "asana-list-portfolios",
5
5
  name: "List Portfolios",
6
- description: "Returns a list of portfolios in the given workspace owned by the given user. Use this to discover portfolio GIDs before calling **Get Portfolio** or **List Portfolio Items**. Owner defaults to the authenticated user; regular API users can only list portfolios they own. [See the documentation](https://developers.asana.com/reference/getportfolios)",
7
- version: "0.0.2",
6
+ description: "Returns a list of portfolios in an Asana workspace owned by the given user. Use this to discover portfolio GIDs before calling **Get Portfolio** or **List Portfolio Items**. Owner defaults to the authenticated user; regular API users can only list portfolios they own. Example: call with `workspace: '1200123456789012'` → returns `[{gid: '1208901234567890', name: 'Product Launch'}, ...]`. [See the documentation](https://developers.asana.com/reference/getportfolios)",
7
+ version: "0.0.3",
8
8
  annotations: {
9
9
  destructiveHint: false,
10
10
  openWorldHint: true,
@@ -22,7 +22,7 @@ export default {
22
22
  owner: {
23
23
  type: "string",
24
24
  label: "Owner",
25
- description: "The GID of the user who owns the portfolios. Defaults to the authenticated user (`me`). Use the **List Users** action to find user GIDs. Regular API users can only list portfolios they own; service accounts may specify any user.",
25
+ description: "The GID of the user who owns the portfolios (e.g. `1198765432109876`). Defaults to the authenticated user (`me`). Use the **List Users** action to find user GIDs. Regular API users can only list portfolios they own; service accounts may specify any user.",
26
26
  optional: true,
27
27
  },
28
28
  optFields: {
@@ -0,0 +1,69 @@
1
+ import asana from "../../asana.app.mjs";
2
+
3
+ export default {
4
+ key: "asana-list-tags",
5
+ name: "List Tags",
6
+ description: "Returns tags in an Asana workspace, up to 100 by default (increase `maxResults` for more) — not guaranteed to include every tag in a large workspace. Use this to discover tag GIDs before applying tags to tasks with **Create Task** or **Create Subtask** (the `tags` prop). Example: call with `workspace: '1200123456789012'` → returns tags like `[{gid: '1202345678901234', name: 'urgent'}]`. [See the documentation](https://developers.asana.com/reference/gettags)",
7
+ version: "0.0.1",
8
+ type: "action",
9
+ ai: "optimized",
10
+ annotations: {
11
+ destructiveHint: false,
12
+ openWorldHint: true,
13
+ readOnlyHint: true,
14
+ },
15
+ props: {
16
+ asana,
17
+ workspace: {
18
+ label: "Workspace",
19
+ description: "The workspace GID to list tags for, e.g. `1200123456789012`. Use the **List Workspaces** action to find available workspace GIDs.",
20
+ type: "string",
21
+ propDefinition: [
22
+ asana,
23
+ "workspaces",
24
+ ],
25
+ },
26
+ maxResults: {
27
+ propDefinition: [
28
+ asana,
29
+ "maxResults",
30
+ ],
31
+ },
32
+ },
33
+ async run({ $ }) {
34
+ const defaultLimit = 100;
35
+ let hasMore, count = 0;
36
+ const params = {
37
+ workspace: this.workspace,
38
+ limit: defaultLimit,
39
+ };
40
+ const results = [];
41
+
42
+ do {
43
+ const {
44
+ data, next_page: next,
45
+ } = await this.asana.getTags({
46
+ params,
47
+ $,
48
+ });
49
+
50
+ hasMore = next;
51
+ params.offset = next?.offset;
52
+
53
+ if (!data || data.length === 0) break;
54
+
55
+ for (const tag of data) {
56
+ results.push(tag);
57
+ if (++count >= this.maxResults) {
58
+ hasMore = false;
59
+ break;
60
+ }
61
+ }
62
+ } while (hasMore);
63
+
64
+ $.export("$summary", `${results.length} tag${results.length !== 1
65
+ ? "s"
66
+ : ""} retrieved`);
67
+ return results;
68
+ },
69
+ };