@workast/sdk 3.1.0 → 3.2.0

package/dist/mock.cjs

@@ -151,6 +151,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');
@@ -177,6 +178,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' });
@@ -220,6 +222,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' });
@@ -238,6 +241,7 @@ var Fields = class {
   }
   /**
    * Create a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * const field = await workast.fields.create({ name: 'Priority', type: 'text' });
@@ -247,6 +251,7 @@ var Fields = class {
   }
   /**
    * Update a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * const field = await workast.fields.update('field-id', { name: 'Priority' });
@@ -261,6 +266,7 @@ var Fields = class {
   }
   /**
    * Remove a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * await workast.fields.del('field-id');
@@ -283,6 +289,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'] });
@@ -306,6 +313,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' });
@@ -320,6 +328,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' });
@@ -334,6 +343,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');
@@ -354,6 +364,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');
@@ -368,6 +379,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'] });
@@ -382,6 +394,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'] });
@@ -402,6 +415,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');
@@ -416,6 +430,7 @@ var ListFields = class {
   }
   /**
    * Disable a custom field on a list.
+   * Requires `field:manage`.
    *
    * @example
    * await workast.lists.fields.disable('list-id', 'field-id');
@@ -442,6 +457,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' });
@@ -451,6 +467,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');
@@ -460,6 +477,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' });
@@ -469,6 +487,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 });
@@ -516,6 +535,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();
@@ -525,6 +545,7 @@ var Lists = class {
   }
   /**
    * Archive a list.
+   * Requires `list:manage`.
    *
    * @example
    * await workast.lists.archive('list-id');
@@ -539,6 +560,7 @@ var Lists = class {
   }
   /**
    * Unarchive a list.
+   * Requires `list:manage`.
    *
    * @example
    * await workast.lists.unarchive('list-id');
@@ -553,6 +575,7 @@ var Lists = class {
   }
   /**
    * Join a list.
+   * Requires `list:join`.
    *
    * @example
    * await workast.lists.join('list-id');
@@ -567,6 +590,7 @@ var Lists = class {
   }
   /**
    * Request access to a private list.
+   * Requires `list:join`.
    *
    * @example
    * await workast.lists.requestAccess('list-id');
@@ -581,6 +605,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 });
@@ -603,6 +628,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 });
@@ -635,6 +661,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({
@@ -648,6 +675,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');
@@ -657,6 +685,7 @@ var MeetingsResource = class {
   }
   /**
    * Update meeting notes.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.update('meeting-id', { notes: 'Ship v3' });
@@ -666,6 +695,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');
@@ -680,6 +710,7 @@ var MeetingsResource = class {
   }
   /**
    * Enable the notetaker for a meeting.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.enableNotetaker('meeting-id', {
@@ -696,6 +727,7 @@ var MeetingsResource = class {
   }
   /**
    * Disable or remove the notetaker from a meeting.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.disableNotetaker('meeting-id');
@@ -718,6 +750,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 });
@@ -758,6 +791,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');
@@ -767,6 +801,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>' });
@@ -776,6 +811,7 @@ var NotesResource = class {
   }
   /**
    * Delete a note.
+   * Requires `note:manage`.
    *
    * @example
    * await workast.notes.del('note-id');
@@ -793,6 +829,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 });
@@ -820,6 +857,7 @@ var NotificationsResource = class {
   }
   /**
    * Mark a notification as read.
+   * Requires `notification:manage`.
    *
    * @example
    * await workast.notifications.markRead('notification-id');
@@ -834,6 +872,7 @@ var NotificationsResource = class {
   }
   /**
    * Mark a notification as unread.
+   * Requires `notification:manage`.
    *
    * @example
    * await workast.notifications.markUnread('notification-id');
@@ -856,6 +895,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:' });
@@ -870,6 +910,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');
@@ -892,9 +933,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);
@@ -907,9 +949,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",
@@ -919,6 +958,7 @@ var SearchesResource = class {
   }
   /**
    * Create a search.
+   * Requires `search:manage`.
    *
    * @example
    * const search = await workast.searches.create({
@@ -931,6 +971,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');
@@ -954,6 +995,7 @@ var SearchesResource = class {
   }
   /**
    * Update a search.
+   * Requires `search:manage`.
    *
    * @example
    * const search = await workast.searches.update('search-id', { name: 'Updated' });
@@ -968,6 +1010,7 @@ var SearchesResource = class {
   }
   /**
    * Delete a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.del('search-id');
@@ -980,8 +1023,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');
@@ -996,6 +1062,7 @@ var SearchesResource = class {
   }
   /**
    * Remove a search from the home screen.
+   * Requires `home:search:manage`.
    *
    * @example
    * await workast.searches.removeHome('search-id');
@@ -1010,6 +1077,7 @@ var SearchesResource = class {
   }
   /**
    * Share a search with users.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.share('search-id', { users: ['user-id'] });
@@ -1024,6 +1092,7 @@ var SearchesResource = class {
   }
   /**
    * Unshare a search from users.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.unshare('search-id', { users: ['user-id'] });
@@ -1038,6 +1107,7 @@ var SearchesResource = class {
   }
   /**
    * Set a reminder on a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.setReminder('search-id', {
@@ -1054,6 +1124,7 @@ var SearchesResource = class {
   }
   /**
    * Delete a reminder from a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.delReminder('search-id');
@@ -1076,6 +1147,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' });
@@ -1097,6 +1169,7 @@ var Tags = class {
   }
   /**
    * Create a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * const tag = await workast.tags.create({ name: 'Priority', color: '#ff0000' });
@@ -1106,6 +1179,7 @@ var Tags = class {
   }
   /**
    * Update a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * const tag = await workast.tags.update('tag-id', { name: 'Priority' });
@@ -1120,6 +1194,7 @@ var Tags = class {
   }
   /**
    * Delete a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * await workast.tags.del('tag-id');
@@ -1142,6 +1217,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' });
@@ -1157,6 +1233,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');
@@ -1171,6 +1248,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');
@@ -1191,6 +1269,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' });
@@ -1200,6 +1279,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' });
@@ -1214,6 +1294,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');
@@ -1234,6 +1315,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 });
@@ -1268,6 +1350,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' });
@@ -1277,6 +1360,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' });
@@ -1291,6 +1375,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');
@@ -1319,6 +1404,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' });
@@ -1326,8 +1412,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');
@@ -1337,6 +1434,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');
@@ -1346,6 +1444,7 @@ var Tasks = class {
   }
   /**
    * Update a task.
+   * Requires `task:manage`.
    *
    * @example
    * await workast.tasks.update('task-id', { text: 'Ship v3' });
@@ -1355,6 +1454,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');
@@ -1364,6 +1464,7 @@ var Tasks = class {
   }
   /**
    * Search tasks.
+   * Requires one of: `task:find` (least privilege) or `task:manage`.
    *
    * @example
    * const results = await workast.tasks.list({
@@ -1375,6 +1476,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');
@@ -1384,6 +1486,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');
@@ -1393,6 +1496,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'] });
@@ -1402,6 +1506,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'] });
@@ -1411,6 +1516,7 @@ var Tasks = class {
   }
   /**
    * Add followers to a task.
+   * Requires `user:task:follow`.
    *
    * @example
    * await workast.tasks.follow('task-id', { users: ['user-id'] });
@@ -1420,6 +1526,7 @@ var Tasks = class {
   }
   /**
    * Remove followers from a task.
+   * Requires `user:task:follow`.
    *
    * @example
    * await workast.tasks.unfollow('task-id', { users: ['user-id'] });
@@ -1429,6 +1536,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' });
@@ -1438,6 +1546,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' }]);
@@ -1447,6 +1556,7 @@ var Tasks = class {
   }
   /**
    * Update many tasks.
+   * Requires `task:manage`.
    *
    * @example
    * const result = await workast.tasks.updateMany({ tasks: ['task-id'], status: 'done' });
@@ -1456,6 +1566,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();
@@ -1465,6 +1576,7 @@ var Tasks = class {
   }
   /**
    * Add a task to the home screen.
+   * Requires `home:task:manage`.
    *
    * @example
    * await workast.tasks.addHome('task-id');
@@ -1474,6 +1586,7 @@ var Tasks = class {
   }
   /**
    * Remove a task from the home screen.
+   * Requires `home:task:manage`.
    *
    * @example
    * await workast.tasks.removeHome('task-id');
@@ -1483,6 +1596,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'] });
@@ -1492,6 +1606,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'] });
@@ -1501,6 +1616,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' });
@@ -1515,6 +1631,7 @@ var Tasks = class {
   }
   /**
    * Convert a subtask into a standalone task.
+   * Requires `task:manage`.
    *
    * @example
    * const task = await workast.tasks.convertToTask('task-id');
@@ -1537,6 +1654,7 @@ var Tokens = class {
   client;
   /**
    * Get the token details.
+   * Requires any authenticated token (no specific scope).
    *
    * @example
    * const token = await workast.tokens.retrieve();
@@ -1566,6 +1684,7 @@ var Users = class {
   client;
   /**
    * Get the logged-in user.
+   * Requires any authenticated token (no specific scope).
    *
    * @example
    * const me = await workast.users.me();
@@ -1575,6 +1694,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 });
@@ -1612,6 +1732,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');
@@ -1621,6 +1742,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');
@@ -1639,6 +1761,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' });
@@ -1666,6 +1789,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 });
@@ -1675,6 +1799,7 @@ var WorkflowsResource = class {
   }
   /**
    * Create a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * const workflow = await workast.workflows.create({
@@ -1689,6 +1814,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');
@@ -1703,6 +1829,7 @@ var WorkflowsResource = class {
   }
   /**
    * Update a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.update('workflow-id', { prompt: 'Ship v3' });
@@ -1717,6 +1844,7 @@ var WorkflowsResource = class {
   }
   /**
    * Delete a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.del('workflow-id');
@@ -1731,6 +1859,7 @@ var WorkflowsResource = class {
   }
   /**
    * Activate a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.activate('workflow-id');
@@ -1745,6 +1874,7 @@ var WorkflowsResource = class {
   }
   /**
    * Deactivate a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.deactivate('workflow-id');