@workast/sdk 3.1.0 → 3.2.0

package/dist/index.cjs

@@ -154,6 +154,7 @@ var Attachments = class {
   client;
   /**
    * Get a signed URL to download an attachment file.
+   * Requires `file:find`.
    *
    * @example
    * const attachment = await workast.attachments.retrieveFileUrl('attachment-id');
@@ -180,6 +181,7 @@ var CalendarEventsResource = class {
   client;
   /**
    * List user calendar events.
+   * Requires `calendar:find`.
    *
    * @example
    * const results = await workast.calendar.events.list({ from: '2025-10-29', to: '2025-11-05' });
@@ -223,6 +225,7 @@ var Fields = class {
   client;
   /**
    * List custom fields in the team.
+   * Requires one of: `field:find` (least privilege) or `field:manage`.
    *
    * @example
    * const fields = await workast.fields.list({ listId: 'list-id' });
@@ -241,6 +244,7 @@ var Fields = class {
   }
   /**
    * Create a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * const field = await workast.fields.create({ name: 'Priority', type: 'text' });
@@ -250,6 +254,7 @@ var Fields = class {
   }
   /**
    * Update a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * const field = await workast.fields.update('field-id', { name: 'Priority' });
@@ -264,6 +269,7 @@ var Fields = class {
   }
   /**
    * Remove a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * await workast.fields.del('field-id');
@@ -286,6 +292,7 @@ var ListSublists = class {
   client;
   /**
    * List unique sublist names across lists.
+   * Requires one of: `list:find` (least privilege) or `list:manage`.
    *
    * @example
    * const names = await workast.lists.sublists.list({ types: ['group'] });
@@ -309,6 +316,7 @@ var ListSublists = class {
   }
   /**
    * Create a sublist in a list.
+   * Requires one of: `list:create` (least privilege) or `list:manage`.
    *
    * @example
    * const sublist = await workast.lists.sublists.create('list-id', { name: 'To-do' });
@@ -323,6 +331,7 @@ var ListSublists = class {
   }
   /**
    * Update a sublist.
+   * Requires one of: `list:update` (least privilege) or `list:manage`.
    *
    * @example
    * await workast.lists.sublists.update('list-id', 'sublist-id', { name: 'Done' });
@@ -337,6 +346,7 @@ var ListSublists = class {
   }
   /**
    * Remove a sublist.
+   * Requires one of: `list:update` (least privilege) or `list:manage`.
    *
    * @example
    * await workast.lists.sublists.del('list-id', 'sublist-id');
@@ -357,6 +367,7 @@ var ListParticipantsResource = class {
   client;
   /**
    * List participants on a list.
+   * Requires one of: `list:participant:find` (least privilege) or `list:manage`.
    *
    * @example
    * const users = await workast.lists.participants.list('list-id');
@@ -371,6 +382,7 @@ var ListParticipantsResource = class {
   }
   /**
    * Add participants to a list.
+   * Requires one of: `list:participant:manage` (least privilege) or `list:manage`.
    *
    * @example
    * await workast.lists.participants.add('list-id', { users: ['user-id'] });
@@ -385,6 +397,7 @@ var ListParticipantsResource = class {
   }
   /**
    * Remove participants from a list.
+   * Requires one of: `list:participant:manage` (least privilege) or `list:manage`.
    *
    * @example
    * await workast.lists.participants.del('list-id', { users: ['user-id'] });
@@ -405,6 +418,7 @@ var ListFields = class {
   client;
   /**
    * Enable a custom field on a list.
+   * Requires `field:manage`.
    *
    * @example
    * await workast.lists.fields.enable('list-id', 'field-id');
@@ -419,6 +433,7 @@ var ListFields = class {
   }
   /**
    * Disable a custom field on a list.
+   * Requires `field:manage`.
    *
    * @example
    * await workast.lists.fields.disable('list-id', 'field-id');
@@ -445,6 +460,7 @@ var Lists = class {
   fields;
   /**
    * Create a list.
+   * Requires one of: `list:create` (least privilege) or `list:manage`.
    *
    * @example
    * const list = await workast.lists.create({ name: 'Engineering' });
@@ -454,6 +470,7 @@ var Lists = class {
   }
   /**
    * Get a list by ID.
+   * Requires one of: `list:find` (least privilege) or `list:manage`.
    *
    * @example
    * const list = await workast.lists.retrieve('list-id');
@@ -463,6 +480,7 @@ var Lists = class {
   }
   /**
    * Update a list.
+   * Requires one of: `list:update` (least privilege) or `list:manage`.
    *
    * @example
    * await workast.lists.update('list-id', { name: 'Engineering' });
@@ -472,6 +490,7 @@ var Lists = class {
   }
   /**
    * Search lists.
+   * Requires one of: `list:find` (least privilege) or `list:manage`.
    *
    * @example
    * const lists = await workast.lists.list({ type: 'group', limit: 10 });
@@ -519,6 +538,7 @@ var Lists = class {
   }
   /**
    * Get the personal list.
+   * Requires one of: `list:find` (least privilege) or `list:manage`.
    *
    * @example
    * const list = await workast.lists.retrievePersonal();
@@ -528,6 +548,7 @@ var Lists = class {
   }
   /**
    * Archive a list.
+   * Requires `list:manage`.
    *
    * @example
    * await workast.lists.archive('list-id');
@@ -542,6 +563,7 @@ var Lists = class {
   }
   /**
    * Unarchive a list.
+   * Requires `list:manage`.
    *
    * @example
    * await workast.lists.unarchive('list-id');
@@ -556,6 +578,7 @@ var Lists = class {
   }
   /**
    * Join a list.
+   * Requires `list:join`.
    *
    * @example
    * await workast.lists.join('list-id');
@@ -570,6 +593,7 @@ var Lists = class {
   }
   /**
    * Request access to a private list.
+   * Requires `list:join`.
    *
    * @example
    * await workast.lists.requestAccess('list-id');
@@ -584,6 +608,7 @@ var Lists = class {
   }
   /**
    * Import a template into a list.
+   * Requires one of: `task:create` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.lists.importTemplate('list-id', 'template-id', { updateDueDates: 30 });
@@ -606,6 +631,7 @@ var MeetingsResource = class {
   client;
   /**
    * List meetings.
+   * Requires one of: `meeting:find` (least privilege) or `meeting:manage`.
    *
    * @example
    * const results = await workast.meetings.list({ timeMin: '2026-01-01T00:00:00Z', maxResults: 15 });
@@ -638,6 +664,7 @@ var MeetingsResource = class {
   }
   /**
    * Create a meeting from a calendar event, or create a new calendar event.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.createFromEvent({
@@ -651,6 +678,7 @@ var MeetingsResource = class {
   }
   /**
    * Get a meeting by ID.
+   * Requires one of: `meeting:find` (least privilege) or `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.retrieve('meeting-id');
@@ -660,6 +688,7 @@ var MeetingsResource = class {
   }
   /**
    * Update meeting notes.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.update('meeting-id', { notes: 'Ship v3' });
@@ -669,6 +698,7 @@ var MeetingsResource = class {
   }
   /**
    * Get meeting recording assets and transcript.
+   * Requires one of: `meeting:find` (least privilege) or `meeting:manage`.
    *
    * @example
    * const recording = await workast.meetings.retrieveRecording('meeting-id');
@@ -683,6 +713,7 @@ var MeetingsResource = class {
   }
   /**
    * Enable the notetaker for a meeting.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.enableNotetaker('meeting-id', {
@@ -699,6 +730,7 @@ var MeetingsResource = class {
   }
   /**
    * Disable or remove the notetaker from a meeting.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.disableNotetaker('meeting-id');
@@ -721,6 +753,7 @@ var NotesResource = class {
   client;
   /**
    * List notes.
+   * Requires one of: `note:find` (least privilege) or `note:manage`.
    *
    * @example
    * const results = await workast.notes.list({ title: 'Spec', limit: 10 });
@@ -761,6 +794,7 @@ var NotesResource = class {
   }
   /**
    * Get a note by ID.
+   * Requires one of: `note:find` (least privilege) or `note:manage`.
    *
    * @example
    * const note = await workast.notes.retrieve('note-id');
@@ -770,6 +804,7 @@ var NotesResource = class {
   }
   /**
    * Update a note.
+   * Requires one of: `note:update` (least privilege) or `note:manage`.
    *
    * @example
    * const note = await workast.notes.update('note-id', { title: 'Spec', version: 1, body: '<p>Hello</p>' });
@@ -779,6 +814,7 @@ var NotesResource = class {
   }
   /**
    * Delete a note.
+   * Requires `note:manage`.
    *
    * @example
    * await workast.notes.del('note-id');
@@ -796,6 +832,7 @@ var NotificationsResource = class {
   client;
   /**
    * List notifications for the logged-in user.
+   * Requires one of: `notification:find` (least privilege) or `notification:manage`.
    *
    * @example
    * const results = await workast.notifications.list({ read: false, limit: 10 });
@@ -823,6 +860,7 @@ var NotificationsResource = class {
   }
   /**
    * Mark a notification as read.
+   * Requires `notification:manage`.
    *
    * @example
    * await workast.notifications.markRead('notification-id');
@@ -837,6 +875,7 @@ var NotificationsResource = class {
   }
   /**
    * Mark a notification as unread.
+   * Requires `notification:manage`.
    *
    * @example
    * await workast.notifications.markUnread('notification-id');
@@ -859,6 +898,7 @@ var Reactions = class {
   client;
   /**
    * Add a reaction to an activity.
+   * Requires one of: `activity:react` (least privilege) or `task:manage`.
    *
    * @example
    * const reaction = await workast.reactions.add('activity-id', { emoji: ':+1:' });
@@ -873,6 +913,7 @@ var Reactions = class {
   }
   /**
    * Remove a reaction from an activity.
+   * Requires one of: `activity:react` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.reactions.del('activity-id', 'reaction-id');
@@ -895,9 +936,10 @@ var SearchesResource = class {
   client;
   /**
    * List searches for the logged-in user.
+   * Requires one of: `search:find` (least privilege) or `search:manage`.
    *
    * @example
-   * const results = await workast.searches.list({ home: true, limit: 10 });
+   * const results = await workast.searches.list({ limit: 10 });
    */
   list(query, options) {
     const params = new URLSearchParams(options?.query);
@@ -910,9 +952,6 @@ var SearchesResource = class {
     if (query?.sort) {
       params.set("sort", query.sort);
     }
-    if (query?.home != null) {
-      params.set("home", String(query.home));
-    }
     return this.client.request(
       "GET",
       "/search",
@@ -922,6 +961,7 @@ var SearchesResource = class {
   }
   /**
    * Create a search.
+   * Requires `search:manage`.
    *
    * @example
    * const search = await workast.searches.create({
@@ -934,6 +974,7 @@ var SearchesResource = class {
   }
   /**
    * Get a search by ID.
+   * Requires one of: `search:find` (least privilege) or `search:manage`.
    *
    * @example
    * const search = await workast.searches.retrieve('search-id');
@@ -957,6 +998,7 @@ var SearchesResource = class {
   }
   /**
    * Update a search.
+   * Requires `search:manage`.
    *
    * @example
    * const search = await workast.searches.update('search-id', { name: 'Updated' });
@@ -971,6 +1013,7 @@ var SearchesResource = class {
   }
   /**
    * Delete a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.del('search-id');
@@ -983,8 +1026,31 @@ var SearchesResource = class {
       options
     );
   }
+  /**
+   * List searches pinned on the home screen.
+   * Requires one of: `home:search:find` (least privilege) or `home:search:manage`.
+   *
+   * @example
+   * const results = await workast.searches.listHome({ limit: 10 });
+   */
+  listHome(query, options) {
+    const params = new URLSearchParams(options?.query);
+    if (query?.limit != null) {
+      params.set("limit", String(query.limit));
+    }
+    if (query?.skip != null) {
+      params.set("skip", String(query.skip));
+    }
+    return this.client.request(
+      "GET",
+      "/search/home",
+      void 0,
+      params.toString() ? { ...options, query: params } : options
+    );
+  }
   /**
    * Add a search to the home screen.
+   * Requires `home:search:manage`.
    *
    * @example
    * await workast.searches.addHome('search-id');
@@ -999,6 +1065,7 @@ var SearchesResource = class {
   }
   /**
    * Remove a search from the home screen.
+   * Requires `home:search:manage`.
    *
    * @example
    * await workast.searches.removeHome('search-id');
@@ -1013,6 +1080,7 @@ var SearchesResource = class {
   }
   /**
    * Share a search with users.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.share('search-id', { users: ['user-id'] });
@@ -1027,6 +1095,7 @@ var SearchesResource = class {
   }
   /**
    * Unshare a search from users.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.unshare('search-id', { users: ['user-id'] });
@@ -1041,6 +1110,7 @@ var SearchesResource = class {
   }
   /**
    * Set a reminder on a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.setReminder('search-id', {
@@ -1057,6 +1127,7 @@ var SearchesResource = class {
   }
   /**
    * Delete a reminder from a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.delReminder('search-id');
@@ -1079,6 +1150,7 @@ var Tags = class {
   client;
   /**
    * List tags in the team.
+   * Requires one of: `tag:find` (least privilege) or `tag:manage`.
    *
    * @example
    * const tags = await workast.tags.list({ listId: 'list-id' });
@@ -1100,6 +1172,7 @@ var Tags = class {
   }
   /**
    * Create a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * const tag = await workast.tags.create({ name: 'Priority', color: '#ff0000' });
@@ -1109,6 +1182,7 @@ var Tags = class {
   }
   /**
    * Update a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * const tag = await workast.tags.update('tag-id', { name: 'Priority' });
@@ -1123,6 +1197,7 @@ var Tags = class {
   }
   /**
    * Delete a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * await workast.tags.del('tag-id');
@@ -1145,6 +1220,7 @@ var TaskSubtasks = class {
   client;
   /**
    * Create a subtask on a task.
+   * Requires one of: `task:create` (least privilege) or `task:manage`.
    *
    * @example
    * const subtask = await workast.tasks.subtasks.create('task-id', { text: 'Write tests' });
@@ -1160,6 +1236,7 @@ var TaskDependencies = class {
   client;
   /**
    * Add a dependency to a task.
+   * Requires one of: `task:manage:dependency` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.dependencies.add('task-id', 'dependency-id');
@@ -1174,6 +1251,7 @@ var TaskDependencies = class {
   }
   /**
    * Remove a dependency from a task.
+   * Requires one of: `task:manage:dependency` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.dependencies.del('task-id', 'dependency-id');
@@ -1194,6 +1272,7 @@ var TaskAttachments = class {
   client;
   /**
    * Create an attachment on a task.
+   * Requires one of: `task:manage:attachment` (least privilege) or `task:manage`.
    *
    * @example
    * const attachment = await workast.tasks.attachments.create('task-id', { author: 'user-id' });
@@ -1203,6 +1282,7 @@ var TaskAttachments = class {
   }
   /**
    * Update a task attachment.
+   * Requires one of: `task:manage:attachment` (least privilege) or `task:manage`.
    *
    * @example
    * const attachment = await workast.tasks.attachments.update('task-id', 'attachment-id', { date: '2026-01-01' });
@@ -1217,6 +1297,7 @@ var TaskAttachments = class {
   }
   /**
    * Delete a task attachment.
+   * Requires one of: `task:manage:attachment` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.attachments.del('task-id', 'attachment-id');
@@ -1237,6 +1318,7 @@ var TaskActivitiesResource = class {
   client;
   /**
    * List activities on a task.
+   * Requires one of: `task:activity:find` (least privilege) or `task:manage`.
    *
    * @example
    * const results = await workast.tasks.activities.list('task-id', { type: ['comment'], limit: 10 });
@@ -1271,6 +1353,7 @@ var TaskActivitiesResource = class {
   }
   /**
    * Create a comment activity on a task.
+   * Requires one of: `task:manage:activity` (least privilege) or `task:manage`.
    *
    * @example
    * const activity = await workast.tasks.activities.create('task-id', { type: 'comment', value: 'Looks good' });
@@ -1280,6 +1363,7 @@ var TaskActivitiesResource = class {
   }
   /**
    * Update a task activity.
+   * Requires one of: `task:manage:activity` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.activities.update('task-id', 'activity-id', { value: 'Updated comment' });
@@ -1294,6 +1378,7 @@ var TaskActivitiesResource = class {
   }
   /**
    * Delete a task activity.
+   * Requires one of: `task:manage:activity` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.activities.del('task-id', 'activity-id');
@@ -1322,6 +1407,7 @@ var Tasks = class {
   activities;
   /**
    * Create a task in a list.
+   * Requires one of: `task:create` (least privilege) or `task:manage`.
    *
    * @example
    * const task = await workast.tasks.create('list-id', { text: 'Ship v3' });
@@ -1329,8 +1415,19 @@ var Tasks = class {
   create(listId, body, options) {
     return this.client.request("POST", `/list/${encodeURIComponent(listId)}/task`, body, options);
   }
+  /**
+   * Create a task in the personal list.
+   * Requires one of: `task:create` (least privilege) or `task:manage`.
+   *
+   * @example
+   * const task = await workast.tasks.createPersonal({ text: 'Ship v3' });
+   */
+  createPersonal(body, options) {
+    return this.client.request("POST", "/list/personal/task", body, options);
+  }
   /**
    * Get a task by ID.
+   * Requires one of: `task:find` (least privilege) or `task:manage`.
    *
    * @example
    * const task = await workast.tasks.retrieve('task-id');
@@ -1340,6 +1437,7 @@ var Tasks = class {
   }
   /**
    * Get a task by short ID.
+   * Requires one of: `task:find` (least privilege) or `task:manage`.
    *
    * @example
    * const task = await workast.tasks.retrieveByShortId('t4k1');
@@ -1349,6 +1447,7 @@ var Tasks = class {
   }
   /**
    * Update a task.
+   * Requires `task:manage`.
    *
    * @example
    * await workast.tasks.update('task-id', { text: 'Ship v3' });
@@ -1358,6 +1457,7 @@ var Tasks = class {
   }
   /**
    * Delete a task.
+   * Requires one of: `task:manage:remove` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.del('task-id');
@@ -1367,6 +1467,7 @@ var Tasks = class {
   }
   /**
    * Search tasks.
+   * Requires one of: `task:find` (least privilege) or `task:manage`.
    *
    * @example
    * const results = await workast.tasks.list({
@@ -1378,6 +1479,7 @@ var Tasks = class {
   }
   /**
    * Complete a task.
+   * Requires one of: `task:manage:status` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.complete('task-id');
@@ -1387,6 +1489,7 @@ var Tasks = class {
   }
   /**
    * Uncomplete a task.
+   * Requires one of: `task:manage:status` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.uncomplete('task-id');
@@ -1396,6 +1499,7 @@ var Tasks = class {
   }
   /**
    * Assign users to a task.
+   * Requires one of: `task:manage:assignee` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.assign('task-id', { users: ['user-id'] });
@@ -1405,6 +1509,7 @@ var Tasks = class {
   }
   /**
    * Unassign users from a task.
+   * Requires one of: `task:manage:assignee` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.unassign('task-id', { users: ['user-id'] });
@@ -1414,6 +1519,7 @@ var Tasks = class {
   }
   /**
    * Add followers to a task.
+   * Requires `user:task:follow`.
    *
    * @example
    * await workast.tasks.follow('task-id', { users: ['user-id'] });
@@ -1423,6 +1529,7 @@ var Tasks = class {
   }
   /**
    * Remove followers from a task.
+   * Requires `user:task:follow`.
    *
    * @example
    * await workast.tasks.unfollow('task-id', { users: ['user-id'] });
@@ -1432,6 +1539,7 @@ var Tasks = class {
   }
   /**
    * Move tasks to another list.
+   * Requires one of: `task:manage:move` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.move('list-id', { tasks: ['task-id'], target: 'other-list-id' });
@@ -1441,6 +1549,7 @@ var Tasks = class {
   }
   /**
    * Create many tasks in a list.
+   * Requires one of: `task:create` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.createMany('list-id', [{ text: 'One' }, { text: 'Two' }]);
@@ -1450,6 +1559,7 @@ var Tasks = class {
   }
   /**
    * Update many tasks.
+   * Requires `task:manage`.
    *
    * @example
    * const result = await workast.tasks.updateMany({ tasks: ['task-id'], status: 'done' });
@@ -1459,6 +1569,7 @@ var Tasks = class {
   }
   /**
    * List home (favourite) tasks.
+   * Requires one of: `home:task:find` (least privilege) or `home:task:manage`.
    *
    * @example
    * const home = await workast.tasks.listHome();
@@ -1468,6 +1579,7 @@ var Tasks = class {
   }
   /**
    * Add a task to the home screen.
+   * Requires `home:task:manage`.
    *
    * @example
    * await workast.tasks.addHome('task-id');
@@ -1477,6 +1589,7 @@ var Tasks = class {
   }
   /**
    * Remove a task from the home screen.
+   * Requires `home:task:manage`.
    *
    * @example
    * await workast.tasks.removeHome('task-id');
@@ -1486,6 +1599,7 @@ var Tasks = class {
   }
   /**
    * Add tags to a task.
+   * Requires one of: `task:manage:tag` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.addTag('task-id', { tags: ['tag-id'] });
@@ -1495,6 +1609,7 @@ var Tasks = class {
   }
   /**
    * Remove tags from a task.
+   * Requires one of: `task:manage:tag` (least privilege) or `task:manage`.
    *
    * @example
    * await workast.tasks.removeTag('task-id', { tags: ['tag-id'] });
@@ -1504,6 +1619,7 @@ var Tasks = class {
   }
   /**
    * Convert a task into a subtask of another task.
+   * Requires `task:manage`.
    *
    * @example
    * await workast.tasks.convertToSubtask('task-id', { parentTaskId: 'parent-id' });
@@ -1518,6 +1634,7 @@ var Tasks = class {
   }
   /**
    * Convert a subtask into a standalone task.
+   * Requires `task:manage`.
    *
    * @example
    * const task = await workast.tasks.convertToTask('task-id');
@@ -1540,6 +1657,7 @@ var Tokens = class {
   client;
   /**
    * Get the token details.
+   * Requires any authenticated token (no specific scope).
    *
    * @example
    * const token = await workast.tokens.retrieve();
@@ -1569,6 +1687,7 @@ var Users = class {
   client;
   /**
    * Get the logged-in user.
+   * Requires any authenticated token (no specific scope).
    *
    * @example
    * const me = await workast.users.me();
@@ -1578,6 +1697,7 @@ var Users = class {
   }
   /**
    * List users in the team.
+   * Requires one of: `user:find` (least privilege) or `user:manage`.
    *
    * @example
    * const users = await workast.users.list({ name: 'Ada', limit: 10 });
@@ -1615,6 +1735,7 @@ var Users = class {
   }
   /**
    * Get a user by ID.
+   * Requires one of: `user:find` (least privilege) or `user:manage`.
    *
    * @example
    * const user = await workast.users.retrieve('user-id');
@@ -1624,6 +1745,7 @@ var Users = class {
   }
   /**
    * Get a user by email.
+   * Requires one of: `user:find` (least privilege) or `user:manage`.
    *
    * @example
    * const user = await workast.users.retrieveByEmail('ada@example.com');
@@ -1642,6 +1764,7 @@ var Users = class {
   }
   /**
    * Invite a user to the team.
+   * Requires one of: `user:invite` (least privilege) or `user:manage`.
    *
    * @example
    * const user = await workast.users.invite({ name: 'Ada', email: 'ada@example.com', role: 'member' });
@@ -1669,6 +1792,7 @@ var WorkflowsResource = class {
   client;
   /**
    * List workflows created by the logged-in user.
+   * Requires one of: `workflow:find` (least privilege) or `workflow:manage`.
    *
    * @example
    * const results = await workast.workflows.list({ limit: 10, skip: 0 });
@@ -1678,6 +1802,7 @@ var WorkflowsResource = class {
   }
   /**
    * Create a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * const workflow = await workast.workflows.create({
@@ -1692,6 +1817,7 @@ var WorkflowsResource = class {
   }
   /**
    * Get a workflow by ID.
+   * Requires one of: `workflow:find` (least privilege) or `workflow:manage`.
    *
    * @example
    * const workflow = await workast.workflows.retrieve('workflow-id');
@@ -1706,6 +1832,7 @@ var WorkflowsResource = class {
   }
   /**
    * Update a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.update('workflow-id', { prompt: 'Ship v3' });
@@ -1720,6 +1847,7 @@ var WorkflowsResource = class {
   }
   /**
    * Delete a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.del('workflow-id');
@@ -1734,6 +1862,7 @@ var WorkflowsResource = class {
   }
   /**
    * Activate a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.activate('workflow-id');
@@ -1748,6 +1877,7 @@ var WorkflowsResource = class {
   }
   /**
    * Deactivate a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.deactivate('workflow-id');