@workast/sdk 3.1.0 → 3.2.0

package/dist/{chunk-LR7MGXLV.js → chunk-77N6V6HL.js}

@@ -129,6 +129,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');
@@ -155,6 +156,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' });
@@ -198,6 +200,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' });
@@ -216,6 +219,7 @@ var Fields = class {
   }
   /**
    * Create a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * const field = await workast.fields.create({ name: 'Priority', type: 'text' });
@@ -225,6 +229,7 @@ var Fields = class {
   }
   /**
    * Update a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * const field = await workast.fields.update('field-id', { name: 'Priority' });
@@ -239,6 +244,7 @@ var Fields = class {
   }
   /**
    * Remove a custom field.
+   * Requires `field:manage`.
    *
    * @example
    * await workast.fields.del('field-id');
@@ -261,6 +267,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'] });
@@ -284,6 +291,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' });
@@ -298,6 +306,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' });
@@ -312,6 +321,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');
@@ -332,6 +342,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');
@@ -346,6 +357,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'] });
@@ -360,6 +372,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'] });
@@ -380,6 +393,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');
@@ -394,6 +408,7 @@ var ListFields = class {
   }
   /**
    * Disable a custom field on a list.
+   * Requires `field:manage`.
    *
    * @example
    * await workast.lists.fields.disable('list-id', 'field-id');
@@ -420,6 +435,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' });
@@ -429,6 +445,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');
@@ -438,6 +455,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' });
@@ -447,6 +465,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 });
@@ -494,6 +513,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();
@@ -503,6 +523,7 @@ var Lists = class {
   }
   /**
    * Archive a list.
+   * Requires `list:manage`.
    *
    * @example
    * await workast.lists.archive('list-id');
@@ -517,6 +538,7 @@ var Lists = class {
   }
   /**
    * Unarchive a list.
+   * Requires `list:manage`.
    *
    * @example
    * await workast.lists.unarchive('list-id');
@@ -531,6 +553,7 @@ var Lists = class {
   }
   /**
    * Join a list.
+   * Requires `list:join`.
    *
    * @example
    * await workast.lists.join('list-id');
@@ -545,6 +568,7 @@ var Lists = class {
   }
   /**
    * Request access to a private list.
+   * Requires `list:join`.
    *
    * @example
    * await workast.lists.requestAccess('list-id');
@@ -559,6 +583,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 });
@@ -581,6 +606,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 });
@@ -613,6 +639,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({
@@ -626,6 +653,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');
@@ -635,6 +663,7 @@ var MeetingsResource = class {
   }
   /**
    * Update meeting notes.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.update('meeting-id', { notes: 'Ship v3' });
@@ -644,6 +673,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');
@@ -658,6 +688,7 @@ var MeetingsResource = class {
   }
   /**
    * Enable the notetaker for a meeting.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.enableNotetaker('meeting-id', {
@@ -674,6 +705,7 @@ var MeetingsResource = class {
   }
   /**
    * Disable or remove the notetaker from a meeting.
+   * Requires `meeting:manage`.
    *
    * @example
    * const meeting = await workast.meetings.disableNotetaker('meeting-id');
@@ -696,6 +728,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 });
@@ -736,6 +769,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');
@@ -745,6 +779,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>' });
@@ -754,6 +789,7 @@ var NotesResource = class {
   }
   /**
    * Delete a note.
+   * Requires `note:manage`.
    *
    * @example
    * await workast.notes.del('note-id');
@@ -771,6 +807,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 });
@@ -798,6 +835,7 @@ var NotificationsResource = class {
   }
   /**
    * Mark a notification as read.
+   * Requires `notification:manage`.
    *
    * @example
    * await workast.notifications.markRead('notification-id');
@@ -812,6 +850,7 @@ var NotificationsResource = class {
   }
   /**
    * Mark a notification as unread.
+   * Requires `notification:manage`.
    *
    * @example
    * await workast.notifications.markUnread('notification-id');
@@ -834,6 +873,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:' });
@@ -848,6 +888,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');
@@ -870,9 +911,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);
@@ -885,9 +927,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",
@@ -897,6 +936,7 @@ var SearchesResource = class {
   }
   /**
    * Create a search.
+   * Requires `search:manage`.
    *
    * @example
    * const search = await workast.searches.create({
@@ -909,6 +949,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');
@@ -932,6 +973,7 @@ var SearchesResource = class {
   }
   /**
    * Update a search.
+   * Requires `search:manage`.
    *
    * @example
    * const search = await workast.searches.update('search-id', { name: 'Updated' });
@@ -946,6 +988,7 @@ var SearchesResource = class {
   }
   /**
    * Delete a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.del('search-id');
@@ -958,8 +1001,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');
@@ -974,6 +1040,7 @@ var SearchesResource = class {
   }
   /**
    * Remove a search from the home screen.
+   * Requires `home:search:manage`.
    *
    * @example
    * await workast.searches.removeHome('search-id');
@@ -988,6 +1055,7 @@ var SearchesResource = class {
   }
   /**
    * Share a search with users.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.share('search-id', { users: ['user-id'] });
@@ -1002,6 +1070,7 @@ var SearchesResource = class {
   }
   /**
    * Unshare a search from users.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.unshare('search-id', { users: ['user-id'] });
@@ -1016,6 +1085,7 @@ var SearchesResource = class {
   }
   /**
    * Set a reminder on a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.setReminder('search-id', {
@@ -1032,6 +1102,7 @@ var SearchesResource = class {
   }
   /**
    * Delete a reminder from a search.
+   * Requires `search:manage`.
    *
    * @example
    * await workast.searches.delReminder('search-id');
@@ -1054,6 +1125,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' });
@@ -1075,6 +1147,7 @@ var Tags = class {
   }
   /**
    * Create a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * const tag = await workast.tags.create({ name: 'Priority', color: '#ff0000' });
@@ -1084,6 +1157,7 @@ var Tags = class {
   }
   /**
    * Update a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * const tag = await workast.tags.update('tag-id', { name: 'Priority' });
@@ -1098,6 +1172,7 @@ var Tags = class {
   }
   /**
    * Delete a tag.
+   * Requires `tag:manage`.
    *
    * @example
    * await workast.tags.del('tag-id');
@@ -1120,6 +1195,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' });
@@ -1135,6 +1211,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');
@@ -1149,6 +1226,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');
@@ -1169,6 +1247,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' });
@@ -1178,6 +1257,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' });
@@ -1192,6 +1272,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');
@@ -1212,6 +1293,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 });
@@ -1246,6 +1328,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' });
@@ -1255,6 +1338,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' });
@@ -1269,6 +1353,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');
@@ -1297,6 +1382,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' });
@@ -1304,8 +1390,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');
@@ -1315,6 +1412,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');
@@ -1324,6 +1422,7 @@ var Tasks = class {
   }
   /**
    * Update a task.
+   * Requires `task:manage`.
    *
    * @example
    * await workast.tasks.update('task-id', { text: 'Ship v3' });
@@ -1333,6 +1432,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');
@@ -1342,6 +1442,7 @@ var Tasks = class {
   }
   /**
    * Search tasks.
+   * Requires one of: `task:find` (least privilege) or `task:manage`.
    *
    * @example
    * const results = await workast.tasks.list({
@@ -1353,6 +1454,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');
@@ -1362,6 +1464,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');
@@ -1371,6 +1474,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'] });
@@ -1380,6 +1484,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'] });
@@ -1389,6 +1494,7 @@ var Tasks = class {
   }
   /**
    * Add followers to a task.
+   * Requires `user:task:follow`.
    *
    * @example
    * await workast.tasks.follow('task-id', { users: ['user-id'] });
@@ -1398,6 +1504,7 @@ var Tasks = class {
   }
   /**
    * Remove followers from a task.
+   * Requires `user:task:follow`.
    *
    * @example
    * await workast.tasks.unfollow('task-id', { users: ['user-id'] });
@@ -1407,6 +1514,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' });
@@ -1416,6 +1524,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' }]);
@@ -1425,6 +1534,7 @@ var Tasks = class {
   }
   /**
    * Update many tasks.
+   * Requires `task:manage`.
    *
    * @example
    * const result = await workast.tasks.updateMany({ tasks: ['task-id'], status: 'done' });
@@ -1434,6 +1544,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();
@@ -1443,6 +1554,7 @@ var Tasks = class {
   }
   /**
    * Add a task to the home screen.
+   * Requires `home:task:manage`.
    *
    * @example
    * await workast.tasks.addHome('task-id');
@@ -1452,6 +1564,7 @@ var Tasks = class {
   }
   /**
    * Remove a task from the home screen.
+   * Requires `home:task:manage`.
    *
    * @example
    * await workast.tasks.removeHome('task-id');
@@ -1461,6 +1574,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'] });
@@ -1470,6 +1584,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'] });
@@ -1479,6 +1594,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' });
@@ -1493,6 +1609,7 @@ var Tasks = class {
   }
   /**
    * Convert a subtask into a standalone task.
+   * Requires `task:manage`.
    *
    * @example
    * const task = await workast.tasks.convertToTask('task-id');
@@ -1515,6 +1632,7 @@ var Tokens = class {
   client;
   /**
    * Get the token details.
+   * Requires any authenticated token (no specific scope).
    *
    * @example
    * const token = await workast.tokens.retrieve();
@@ -1544,6 +1662,7 @@ var Users = class {
   client;
   /**
    * Get the logged-in user.
+   * Requires any authenticated token (no specific scope).
    *
    * @example
    * const me = await workast.users.me();
@@ -1553,6 +1672,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 });
@@ -1590,6 +1710,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');
@@ -1599,6 +1720,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');
@@ -1617,6 +1739,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' });
@@ -1644,6 +1767,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 });
@@ -1653,6 +1777,7 @@ var WorkflowsResource = class {
   }
   /**
    * Create a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * const workflow = await workast.workflows.create({
@@ -1667,6 +1792,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');
@@ -1681,6 +1807,7 @@ var WorkflowsResource = class {
   }
   /**
    * Update a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.update('workflow-id', { prompt: 'Ship v3' });
@@ -1695,6 +1822,7 @@ var WorkflowsResource = class {
   }
   /**
    * Delete a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.del('workflow-id');
@@ -1709,6 +1837,7 @@ var WorkflowsResource = class {
   }
   /**
    * Activate a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.activate('workflow-id');
@@ -1723,6 +1852,7 @@ var WorkflowsResource = class {
   }
   /**
    * Deactivate a workflow.
+   * Requires `workflow:manage`.
    *
    * @example
    * await workast.workflows.deactivate('workflow-id');
@@ -1848,4 +1978,4 @@ export {
   ValidationError,
   Workast
 };
-//# sourceMappingURL=chunk-LR7MGXLV.js.map
+//# sourceMappingURL=chunk-77N6V6HL.js.map