@workast/sdk 3.1.0 → 3.2.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@ interface RequestOptions {
 
 /**
  * This file was generated by scripts/generate-types.mjs. Do not edit.
- * Source swagger SHA-256: ffefeeb250be1f2cfa1b6cdd478c4547a1b003dd0e590924dfbecd6d2862164c
+ * Source swagger SHA-256: 960f8629333a3f09cac00abc7fc8fb7d68c165cac7a216639e536d9c6af24c04
  */
 
 interface paths {
@@ -471,6 +471,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/search/home": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List searches pinned on the home screen.
+         * @description Returns the acting user's home searches (user.homeSearches).
+         */
+        get: operations["findHomeSearches"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/search/{searchId}": {
         parameters: {
             query?: never;
@@ -714,6 +734,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/list/personal/task": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Creates a new task in the personal list
+         * @description Creates a new task in the authenticated user's personal list. The personal list is created if it does not exist.
+         */
+        post: operations["createPersonalListTask"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/list/{listId}/participant": {
         parameters: {
             query?: never;
@@ -858,6 +898,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/list/{listId}/note": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Create a Note */
+        post: operations["createNote"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/note": {
         parameters: {
             query?: never;
@@ -9754,8 +9811,6 @@ interface operations {
                 skip?: number;
                 /** @description The sort criteria for returned Searches. Default is createdAt. */
                 sort?: "createdAt" | "-createdAt" | "updatedAt" | "-updatedAt" | "name" | "-name";
-                /** @description Whether to only list the user's searches that are displayed in the home screen (favourites) or not. */
-                home?: boolean;
             };
             header?: never;
             path?: never;
@@ -10011,6 +10066,58 @@ interface operations {
             };
         };
     };
+    findHomeSearches: {
+        parameters: {
+            query?: {
+                /** @description The max number of Searches to return. */
+                limit?: number;
+                /** @description The number of Searches to skip in this search. */
+                skip?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The home searches. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Searches"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["401Error"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["403Error"];
+                };
+            };
+            /** @description Unexpected error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["500Error"];
+                };
+            };
+        };
+    };
     getSearch: {
         parameters: {
             query?: {
@@ -11678,6 +11785,67 @@ interface operations {
             };
         };
     };
+    createPersonalListTask: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description The task details */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TaskCreate"];
+            };
+        };
+        responses: {
+            /** @description The created task */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Task"];
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["400Error"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["401Error"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["403Error"];
+                };
+            };
+            /** @description Unexpected error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["500Error"];
+                };
+            };
+        };
+    };
     getListParticipants: {
         parameters: {
             query?: never;
@@ -12443,6 +12611,84 @@ interface operations {
             };
         };
     };
+    createNote: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The list ID */
+                listId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description The note title
+                     * @example Action Items
+                     */
+                    title?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description The Note was created successfully. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Note"];
+                };
+            };
+            /** @description Bad request. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["400Error"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["401Error"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["403Error"];
+                };
+            };
+            /** @description List not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["404Error"];
+                };
+            };
+            /** @description Unexpected error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["500Error"];
+                };
+            };
+        };
+    };
     getNotes: {
         parameters: {
             query?: {
@@ -14906,7 +15152,7 @@ interface operations {
 
 /**
  * This file was generated by scripts/generate-types.mjs. Do not edit.
- * Source swagger SHA-256: ffefeeb250be1f2cfa1b6cdd478c4547a1b003dd0e590924dfbecd6d2862164c
+ * Source swagger SHA-256: 960f8629333a3f09cac00abc7fc8fb7d68c165cac7a216639e536d9c6af24c04
  */
 
 type ActivityBody = components["schemas"]["ActivityBody"];
@@ -15012,12 +15258,14 @@ type TaskActivitySearchQuery = NonNullable<paths["/task/{taskId}/activity"]["get
 type UserByEmailQuery = NonNullable<paths["/user/email/{email}"]["get"]["parameters"]["query"]>;
 type UserSearchQuery = NonNullable<paths["/user"]["get"]["parameters"]["query"]>;
 type WorkflowSearchQuery = NonNullable<paths["/workflow"]["get"]["parameters"]["query"]>;
+type FindHomeSearchesQuery = NonNullable<paths["/search/home"]["get"]["parameters"]["query"]>;
 
 declare class Attachments {
     private readonly client;
     constructor(client: Workast);
     /**
      * Get a signed URL to download an attachment file.
+     * Requires `file:find`.
      *
      * @example
      * const attachment = await workast.attachments.retrieveFileUrl('attachment-id');
@@ -15030,6 +15278,7 @@ declare class CalendarEventsResource {
     constructor(client: Workast);
     /**
      * List user calendar events.
+     * Requires `calendar:find`.
      *
      * @example
      * const results = await workast.calendar.events.list({ from: '2025-10-29', to: '2025-11-05' });
@@ -15046,6 +15295,7 @@ declare class Fields {
     constructor(client: Workast);
     /**
      * 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' });
@@ -15053,6 +15303,7 @@ declare class Fields {
     list(query?: CustomFieldSearchQuery, options?: RequestOptions): Promise<CustomField[]>;
     /**
      * Create a custom field.
+     * Requires `field:manage`.
      *
      * @example
      * const field = await workast.fields.create({ name: 'Priority', type: 'text' });
@@ -15060,6 +15311,7 @@ declare class Fields {
     create(body: CustomFieldCreate, options?: RequestOptions): Promise<CustomField>;
     /**
      * Update a custom field.
+     * Requires `field:manage`.
      *
      * @example
      * const field = await workast.fields.update('field-id', { name: 'Priority' });
@@ -15067,6 +15319,7 @@ declare class Fields {
     update(fieldId: string, body: CustomFieldPatch, options?: RequestOptions): Promise<CustomField>;
     /**
      * Remove a custom field.
+     * Requires `field:manage`.
      *
      * @example
      * await workast.fields.del('field-id');
@@ -15079,6 +15332,7 @@ declare class ListSublists {
     constructor(client: Workast);
     /**
      * 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'] });
@@ -15086,6 +15340,7 @@ declare class ListSublists {
     list(query?: SubListSearchQuery, options?: RequestOptions): Promise<string[]>;
     /**
      * 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' });
@@ -15093,6 +15348,7 @@ declare class ListSublists {
     create(listId: string, body: SubListCreate, options?: RequestOptions): Promise<SubList>;
     /**
      * 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' });
@@ -15100,6 +15356,7 @@ declare class ListSublists {
     update(listId: string, subListId: string, body: SubListPatch, options?: RequestOptions): Promise<void>;
     /**
      * Remove a sublist.
+     * Requires one of: `list:update` (least privilege) or `list:manage`.
      *
      * @example
      * await workast.lists.sublists.del('list-id', 'sublist-id');
@@ -15111,6 +15368,7 @@ declare class ListParticipantsResource {
     constructor(client: Workast);
     /**
      * 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');
@@ -15118,6 +15376,7 @@ declare class ListParticipantsResource {
     list(listId: string, options?: RequestOptions): Promise<User[]>;
     /**
      * 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'] });
@@ -15125,6 +15384,7 @@ declare class ListParticipantsResource {
     add(listId: string, body: ListParticipants, options?: RequestOptions): Promise<void>;
     /**
      * 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'] });
@@ -15136,6 +15396,7 @@ declare class ListFields {
     constructor(client: Workast);
     /**
      * Enable a custom field on a list.
+     * Requires `field:manage`.
      *
      * @example
      * await workast.lists.fields.enable('list-id', 'field-id');
@@ -15143,6 +15404,7 @@ declare class ListFields {
     enable(listId: string, fieldId: string, options?: RequestOptions): Promise<void>;
     /**
      * Disable a custom field on a list.
+     * Requires `field:manage`.
      *
      * @example
      * await workast.lists.fields.disable('list-id', 'field-id');
@@ -15157,6 +15419,7 @@ declare class Lists {
     constructor(client: Workast);
     /**
      * Create a list.
+     * Requires one of: `list:create` (least privilege) or `list:manage`.
      *
      * @example
      * const list = await workast.lists.create({ name: 'Engineering' });
@@ -15164,6 +15427,7 @@ declare class Lists {
     create(body: ListCreate, options?: RequestOptions): Promise<List>;
     /**
      * Get a list by ID.
+     * Requires one of: `list:find` (least privilege) or `list:manage`.
      *
      * @example
      * const list = await workast.lists.retrieve('list-id');
@@ -15171,6 +15435,7 @@ declare class Lists {
     retrieve(listId: string, options?: RequestOptions): Promise<List>;
     /**
      * Update a list.
+     * Requires one of: `list:update` (least privilege) or `list:manage`.
      *
      * @example
      * await workast.lists.update('list-id', { name: 'Engineering' });
@@ -15178,6 +15443,7 @@ declare class Lists {
     update(listId: string, body: ListPatch, options?: RequestOptions): Promise<void>;
     /**
      * Search lists.
+     * Requires one of: `list:find` (least privilege) or `list:manage`.
      *
      * @example
      * const lists = await workast.lists.list({ type: 'group', limit: 10 });
@@ -15185,6 +15451,7 @@ declare class Lists {
     list(query?: ListSearchQuery, options?: RequestOptions): Promise<ListEnumerate[]>;
     /**
      * Get the personal list.
+     * Requires one of: `list:find` (least privilege) or `list:manage`.
      *
      * @example
      * const list = await workast.lists.retrievePersonal();
@@ -15192,6 +15459,7 @@ declare class Lists {
     retrievePersonal(options?: RequestOptions): Promise<List>;
     /**
      * Archive a list.
+     * Requires `list:manage`.
      *
      * @example
      * await workast.lists.archive('list-id');
@@ -15199,6 +15467,7 @@ declare class Lists {
     archive(listId: string, options?: RequestOptions): Promise<void>;
     /**
      * Unarchive a list.
+     * Requires `list:manage`.
      *
      * @example
      * await workast.lists.unarchive('list-id');
@@ -15206,6 +15475,7 @@ declare class Lists {
     unarchive(listId: string, options?: RequestOptions): Promise<void>;
     /**
      * Join a list.
+     * Requires `list:join`.
      *
      * @example
      * await workast.lists.join('list-id');
@@ -15213,6 +15483,7 @@ declare class Lists {
     join(listId: string, options?: RequestOptions): Promise<void>;
     /**
      * Request access to a private list.
+     * Requires `list:join`.
      *
      * @example
      * await workast.lists.requestAccess('list-id');
@@ -15220,6 +15491,7 @@ declare class Lists {
     requestAccess(listId: string, options?: RequestOptions): Promise<void>;
     /**
      * 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 });
@@ -15232,6 +15504,7 @@ declare class MeetingsResource {
     constructor(client: Workast);
     /**
      * 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 });
@@ -15239,6 +15512,7 @@ declare class MeetingsResource {
     list(query?: MeetingSearchQuery, options?: RequestOptions): Promise<Meetings>;
     /**
      * Create a meeting from a calendar event, or create a new calendar event.
+     * Requires `meeting:manage`.
      *
      * @example
      * const meeting = await workast.meetings.createFromEvent({
@@ -15250,6 +15524,7 @@ declare class MeetingsResource {
     createFromEvent(body: MeetingCreate, options?: RequestOptions): Promise<Meeting>;
     /**
      * Get a meeting by ID.
+     * Requires one of: `meeting:find` (least privilege) or `meeting:manage`.
      *
      * @example
      * const meeting = await workast.meetings.retrieve('meeting-id');
@@ -15257,6 +15532,7 @@ declare class MeetingsResource {
     retrieve(meetingId: string, options?: RequestOptions): Promise<MeetingDetail>;
     /**
      * Update meeting notes.
+     * Requires `meeting:manage`.
      *
      * @example
      * const meeting = await workast.meetings.update('meeting-id', { notes: 'Ship v3' });
@@ -15264,6 +15540,7 @@ declare class MeetingsResource {
     update(meetingId: string, body: MeetingPatch, options?: RequestOptions): Promise<MeetingDetail>;
     /**
      * 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');
@@ -15271,6 +15548,7 @@ declare class MeetingsResource {
     retrieveRecording(meetingId: string, options?: RequestOptions): Promise<MeetingRecordingResource>;
     /**
      * Enable the notetaker for a meeting.
+     * Requires `meeting:manage`.
      *
      * @example
      * const meeting = await workast.meetings.enableNotetaker('meeting-id', {
@@ -15280,6 +15558,7 @@ declare class MeetingsResource {
     enableNotetaker(meetingId: string, body?: MeetingNotetakerEnable, options?: RequestOptions): Promise<Meeting>;
     /**
      * Disable or remove the notetaker from a meeting.
+     * Requires `meeting:manage`.
      *
      * @example
      * const meeting = await workast.meetings.disableNotetaker('meeting-id');
@@ -15292,6 +15571,7 @@ declare class NotesResource {
     constructor(client: Workast);
     /**
      * List notes.
+     * Requires one of: `note:find` (least privilege) or `note:manage`.
      *
      * @example
      * const results = await workast.notes.list({ title: 'Spec', limit: 10 });
@@ -15299,6 +15579,7 @@ declare class NotesResource {
     list(query?: NoteSearchQuery, options?: RequestOptions): Promise<Notes>;
     /**
      * Get a note by ID.
+     * Requires one of: `note:find` (least privilege) or `note:manage`.
      *
      * @example
      * const note = await workast.notes.retrieve('note-id');
@@ -15306,6 +15587,7 @@ declare class NotesResource {
     retrieve(noteId: string, options?: RequestOptions): Promise<NoteDetail>;
     /**
      * 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>' });
@@ -15313,6 +15595,7 @@ declare class NotesResource {
     update(noteId: string, body: NotePatch, options?: RequestOptions): Promise<Note>;
     /**
      * Delete a note.
+     * Requires `note:manage`.
      *
      * @example
      * await workast.notes.del('note-id');
@@ -15325,6 +15608,7 @@ declare class NotificationsResource {
     constructor(client: Workast);
     /**
      * 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 });
@@ -15332,6 +15616,7 @@ declare class NotificationsResource {
     list(query?: NotificationSearchQuery, options?: RequestOptions): Promise<Notifications>;
     /**
      * Mark a notification as read.
+     * Requires `notification:manage`.
      *
      * @example
      * await workast.notifications.markRead('notification-id');
@@ -15339,6 +15624,7 @@ declare class NotificationsResource {
     markRead(notificationId: string, options?: RequestOptions): Promise<void>;
     /**
      * Mark a notification as unread.
+     * Requires `notification:manage`.
      *
      * @example
      * await workast.notifications.markUnread('notification-id');
@@ -15351,6 +15637,7 @@ declare class Reactions {
     constructor(client: Workast);
     /**
      * 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:' });
@@ -15358,6 +15645,7 @@ declare class Reactions {
     add(activityId: string, body: ReactionCreate, options?: RequestOptions): Promise<ReactionReadOnly>;
     /**
      * 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');
@@ -15370,13 +15658,15 @@ declare class SearchesResource {
     constructor(client: Workast);
     /**
      * 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?: SearchFindQuery, options?: RequestOptions): Promise<Searches>;
     /**
      * Create a search.
+     * Requires `search:manage`.
      *
      * @example
      * const search = await workast.searches.create({
@@ -15387,6 +15677,7 @@ declare class SearchesResource {
     create(body: SearchCreate, options?: RequestOptions): Promise<Search>;
     /**
      * Get a search by ID.
+     * Requires one of: `search:find` (least privilege) or `search:manage`.
      *
      * @example
      * const search = await workast.searches.retrieve('search-id');
@@ -15394,6 +15685,7 @@ declare class SearchesResource {
     retrieve(searchId: string, query?: SearchRetrieveQuery, options?: RequestOptions): Promise<SearchDetail>;
     /**
      * Update a search.
+     * Requires `search:manage`.
      *
      * @example
      * const search = await workast.searches.update('search-id', { name: 'Updated' });
@@ -15401,13 +15693,23 @@ declare class SearchesResource {
     update(searchId: string, body: SearchPatch, options?: RequestOptions): Promise<Search>;
     /**
      * Delete a search.
+     * Requires `search:manage`.
      *
      * @example
      * await workast.searches.del('search-id');
      */
     del(searchId: string, options?: RequestOptions): Promise<void>;
+    /**
+     * 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?: FindHomeSearchesQuery, options?: RequestOptions): Promise<Searches>;
     /**
      * Add a search to the home screen.
+     * Requires `home:search:manage`.
      *
      * @example
      * await workast.searches.addHome('search-id');
@@ -15415,6 +15717,7 @@ declare class SearchesResource {
     addHome(searchId: string, options?: RequestOptions): Promise<void>;
     /**
      * Remove a search from the home screen.
+     * Requires `home:search:manage`.
      *
      * @example
      * await workast.searches.removeHome('search-id');
@@ -15422,6 +15725,7 @@ declare class SearchesResource {
     removeHome(searchId: string, options?: RequestOptions): Promise<void>;
     /**
      * Share a search with users.
+     * Requires `search:manage`.
      *
      * @example
      * await workast.searches.share('search-id', { users: ['user-id'] });
@@ -15429,6 +15733,7 @@ declare class SearchesResource {
     share(searchId: string, body: SearchShare, options?: RequestOptions): Promise<void>;
     /**
      * Unshare a search from users.
+     * Requires `search:manage`.
      *
      * @example
      * await workast.searches.unshare('search-id', { users: ['user-id'] });
@@ -15436,6 +15741,7 @@ declare class SearchesResource {
     unshare(searchId: string, body: SearchShare, options?: RequestOptions): Promise<void>;
     /**
      * Set a reminder on a search.
+     * Requires `search:manage`.
      *
      * @example
      * await workast.searches.setReminder('search-id', {
@@ -15445,6 +15751,7 @@ declare class SearchesResource {
     setReminder(searchId: string, body: SearchReminderSet, options?: RequestOptions): Promise<void>;
     /**
      * Delete a reminder from a search.
+     * Requires `search:manage`.
      *
      * @example
      * await workast.searches.delReminder('search-id');
@@ -15457,6 +15764,7 @@ declare class Tags {
     constructor(client: Workast);
     /**
      * 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' });
@@ -15464,6 +15772,7 @@ declare class Tags {
     list(query?: TagSearchQuery, options?: RequestOptions): Promise<Tag[]>;
     /**
      * Create a tag.
+     * Requires `tag:manage`.
      *
      * @example
      * const tag = await workast.tags.create({ name: 'Priority', color: '#ff0000' });
@@ -15471,6 +15780,7 @@ declare class Tags {
     create(body: TagCreate, options?: RequestOptions): Promise<Tag>;
     /**
      * Update a tag.
+     * Requires `tag:manage`.
      *
      * @example
      * const tag = await workast.tags.update('tag-id', { name: 'Priority' });
@@ -15478,6 +15788,7 @@ declare class Tags {
     update(tagId: string, body: TagPatch, options?: RequestOptions): Promise<Tag>;
     /**
      * Delete a tag.
+     * Requires `tag:manage`.
      *
      * @example
      * await workast.tags.del('tag-id');
@@ -15490,6 +15801,7 @@ declare class TaskSubtasks {
     constructor(client: Workast);
     /**
      * 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' });
@@ -15501,6 +15813,7 @@ declare class TaskDependencies {
     constructor(client: Workast);
     /**
      * 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');
@@ -15508,6 +15821,7 @@ declare class TaskDependencies {
     add(taskId: string, dependencyId: string, options?: RequestOptions): Promise<void>;
     /**
      * 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');
@@ -15519,6 +15833,7 @@ declare class TaskAttachments {
     constructor(client: Workast);
     /**
      * 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' });
@@ -15526,6 +15841,7 @@ declare class TaskAttachments {
     create(taskId: string, body: NewAttachment, options?: RequestOptions): Promise<Attachment>;
     /**
      * 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' });
@@ -15533,6 +15849,7 @@ declare class TaskAttachments {
     update(taskId: string, attachmentId: string, body: NewAttachment, options?: RequestOptions): Promise<Attachment>;
     /**
      * 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');
@@ -15544,6 +15861,7 @@ declare class TaskActivitiesResource {
     constructor(client: Workast);
     /**
      * 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 });
@@ -15551,6 +15869,7 @@ declare class TaskActivitiesResource {
     list(taskId: string, query?: TaskActivitySearchQuery, options?: RequestOptions): Promise<TaskActivities>;
     /**
      * 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' });
@@ -15558,6 +15877,7 @@ declare class TaskActivitiesResource {
     create(taskId: string, body: TaskActivityBody, options?: RequestOptions): Promise<CommentActivity>;
     /**
      * 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' });
@@ -15565,6 +15885,7 @@ declare class TaskActivitiesResource {
     update(taskId: string, activityId: string, body: ActivityBody, options?: RequestOptions): Promise<void>;
     /**
      * 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');
@@ -15580,13 +15901,23 @@ declare class Tasks {
     constructor(client: Workast);
     /**
      * 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' });
      */
     create(listId: string, body: TaskCreate, options?: RequestOptions): Promise<Task>;
+    /**
+     * 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: TaskCreate, options?: RequestOptions): Promise<Task>;
     /**
      * Get a task by ID.
+     * Requires one of: `task:find` (least privilege) or `task:manage`.
      *
      * @example
      * const task = await workast.tasks.retrieve('task-id');
@@ -15594,6 +15925,7 @@ declare class Tasks {
     retrieve(taskId: string, options?: RequestOptions): Promise<Task>;
     /**
      * Get a task by short ID.
+     * Requires one of: `task:find` (least privilege) or `task:manage`.
      *
      * @example
      * const task = await workast.tasks.retrieveByShortId('t4k1');
@@ -15601,6 +15933,7 @@ declare class Tasks {
     retrieveByShortId(shortId: string, options?: RequestOptions): Promise<Task>;
     /**
      * Update a task.
+     * Requires `task:manage`.
      *
      * @example
      * await workast.tasks.update('task-id', { text: 'Ship v3' });
@@ -15608,6 +15941,7 @@ declare class Tasks {
     update(taskId: string, body: TaskPatch, options?: RequestOptions): Promise<void>;
     /**
      * Delete a task.
+     * Requires one of: `task:manage:remove` (least privilege) or `task:manage`.
      *
      * @example
      * await workast.tasks.del('task-id');
@@ -15615,6 +15949,7 @@ declare class Tasks {
     del(taskId: string, options?: RequestOptions): Promise<void>;
     /**
      * Search tasks.
+     * Requires one of: `task:find` (least privilege) or `task:manage`.
      *
      * @example
      * const results = await workast.tasks.list({
@@ -15624,6 +15959,7 @@ declare class Tasks {
     list(body: TaskSearch, options?: RequestOptions): Promise<SearchResults>;
     /**
      * Complete a task.
+     * Requires one of: `task:manage:status` (least privilege) or `task:manage`.
      *
      * @example
      * await workast.tasks.complete('task-id');
@@ -15631,6 +15967,7 @@ declare class Tasks {
     complete(taskId: string, options?: RequestOptions): Promise<void>;
     /**
      * Uncomplete a task.
+     * Requires one of: `task:manage:status` (least privilege) or `task:manage`.
      *
      * @example
      * await workast.tasks.uncomplete('task-id');
@@ -15638,6 +15975,7 @@ declare class Tasks {
     uncomplete(taskId: string, options?: RequestOptions): Promise<void>;
     /**
      * 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'] });
@@ -15645,6 +15983,7 @@ declare class Tasks {
     assign(taskId: string, body: TaskAssignment, options?: RequestOptions): Promise<void>;
     /**
      * 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'] });
@@ -15652,6 +15991,7 @@ declare class Tasks {
     unassign(taskId: string, body: TaskAssignment, options?: RequestOptions): Promise<void>;
     /**
      * Add followers to a task.
+     * Requires `user:task:follow`.
      *
      * @example
      * await workast.tasks.follow('task-id', { users: ['user-id'] });
@@ -15659,6 +15999,7 @@ declare class Tasks {
     follow(taskId: string, body: TaskFollow, options?: RequestOptions): Promise<void>;
     /**
      * Remove followers from a task.
+     * Requires `user:task:follow`.
      *
      * @example
      * await workast.tasks.unfollow('task-id', { users: ['user-id'] });
@@ -15666,6 +16007,7 @@ declare class Tasks {
     unfollow(taskId: string, body: TaskFollow, options?: RequestOptions): Promise<void>;
     /**
      * 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' });
@@ -15673,6 +16015,7 @@ declare class Tasks {
     move(listId: string, body: TaskMove, options?: RequestOptions): Promise<void>;
     /**
      * 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' }]);
@@ -15680,6 +16023,7 @@ declare class Tasks {
     createMany(listId: string, body: TaskBulkCreate[], options?: RequestOptions): Promise<void>;
     /**
      * Update many tasks.
+     * Requires `task:manage`.
      *
      * @example
      * const result = await workast.tasks.updateMany({ tasks: ['task-id'], status: 'done' });
@@ -15687,6 +16031,7 @@ declare class Tasks {
     updateMany(body: TaskBulkUpdate, options?: RequestOptions): Promise<TaskBulkUpdateResult>;
     /**
      * List home (favourite) tasks.
+     * Requires one of: `home:task:find` (least privilege) or `home:task:manage`.
      *
      * @example
      * const home = await workast.tasks.listHome();
@@ -15694,6 +16039,7 @@ declare class Tasks {
     listHome(options?: RequestOptions): Promise<HomeTasks>;
     /**
      * Add a task to the home screen.
+     * Requires `home:task:manage`.
      *
      * @example
      * await workast.tasks.addHome('task-id');
@@ -15701,6 +16047,7 @@ declare class Tasks {
     addHome(taskId: string, options?: RequestOptions): Promise<void>;
     /**
      * Remove a task from the home screen.
+     * Requires `home:task:manage`.
      *
      * @example
      * await workast.tasks.removeHome('task-id');
@@ -15708,6 +16055,7 @@ declare class Tasks {
     removeHome(taskId: string, options?: RequestOptions): Promise<void>;
     /**
      * 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'] });
@@ -15715,6 +16063,7 @@ declare class Tasks {
     addTag(taskId: string, body: TaskTag, options?: RequestOptions): Promise<void>;
     /**
      * 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'] });
@@ -15722,6 +16071,7 @@ declare class Tasks {
     removeTag(taskId: string, body: TaskTag, options?: RequestOptions): Promise<void>;
     /**
      * Convert a task into a subtask of another task.
+     * Requires `task:manage`.
      *
      * @example
      * await workast.tasks.convertToSubtask('task-id', { parentTaskId: 'parent-id' });
@@ -15729,6 +16079,7 @@ declare class Tasks {
     convertToSubtask(taskId: string, body: ConvertToSubtask, options?: RequestOptions): Promise<void>;
     /**
      * Convert a subtask into a standalone task.
+     * Requires `task:manage`.
      *
      * @example
      * const task = await workast.tasks.convertToTask('task-id');
@@ -15741,6 +16092,7 @@ declare class Tokens {
     constructor(client: Workast);
     /**
      * Get the token details.
+     * Requires any authenticated token (no specific scope).
      *
      * @example
      * const token = await workast.tokens.retrieve();
@@ -15753,6 +16105,7 @@ declare class Users {
     constructor(client: Workast);
     /**
      * Get the logged-in user.
+     * Requires any authenticated token (no specific scope).
      *
      * @example
      * const me = await workast.users.me();
@@ -15760,6 +16113,7 @@ declare class Users {
     me(options?: RequestOptions): Promise<UserResource>;
     /**
      * 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 });
@@ -15767,6 +16121,7 @@ declare class Users {
     list(query?: UserSearchQuery, options?: RequestOptions): Promise<UserDetail[]>;
     /**
      * Get a user by ID.
+     * Requires one of: `user:find` (least privilege) or `user:manage`.
      *
      * @example
      * const user = await workast.users.retrieve('user-id');
@@ -15774,6 +16129,7 @@ declare class Users {
     retrieve(userId: string, options?: RequestOptions): Promise<UserDetail>;
     /**
      * 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');
@@ -15781,6 +16137,7 @@ declare class Users {
     retrieveByEmail(email: string, query?: UserByEmailQuery, options?: RequestOptions): Promise<UserDetailWithTeam>;
     /**
      * 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' });
@@ -15793,6 +16150,7 @@ declare class WorkflowsResource {
     constructor(client: Workast);
     /**
      * 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 });
@@ -15800,6 +16158,7 @@ declare class WorkflowsResource {
     list(query?: WorkflowSearchQuery, options?: RequestOptions): Promise<Workflows>;
     /**
      * Create a workflow.
+     * Requires `workflow:manage`.
      *
      * @example
      * const workflow = await workast.workflows.create({
@@ -15812,6 +16171,7 @@ declare class WorkflowsResource {
     create(body: WorkflowCreate, options?: RequestOptions): Promise<Workflow>;
     /**
      * Get a workflow by ID.
+     * Requires one of: `workflow:find` (least privilege) or `workflow:manage`.
      *
      * @example
      * const workflow = await workast.workflows.retrieve('workflow-id');
@@ -15819,6 +16179,7 @@ declare class WorkflowsResource {
     retrieve(workflowId: string, options?: RequestOptions): Promise<WorkflowDetail>;
     /**
      * Update a workflow.
+     * Requires `workflow:manage`.
      *
      * @example
      * await workast.workflows.update('workflow-id', { prompt: 'Ship v3' });
@@ -15826,6 +16187,7 @@ declare class WorkflowsResource {
     update(workflowId: string, body: WorkflowPatch, options?: RequestOptions): Promise<void>;
     /**
      * Delete a workflow.
+     * Requires `workflow:manage`.
      *
      * @example
      * await workast.workflows.del('workflow-id');
@@ -15833,6 +16195,7 @@ declare class WorkflowsResource {
     del(workflowId: string, options?: RequestOptions): Promise<void>;
     /**
      * Activate a workflow.
+     * Requires `workflow:manage`.
      *
      * @example
      * await workast.workflows.activate('workflow-id');
@@ -15840,6 +16203,7 @@ declare class WorkflowsResource {
     activate(workflowId: string, options?: RequestOptions): Promise<void>;
     /**
      * Deactivate a workflow.
+     * Requires `workflow:manage`.
      *
      * @example
      * await workast.workflows.deactivate('workflow-id');
@@ -15908,4 +16272,4 @@ declare class ValidationError extends ApiError {
     constructor(message: string, status?: number, body?: unknown);
 }
 
-export { type ActivityBody, ApiError, type Attachment, type AttachmentFileUrl, type AttachmentFileUrlQuery, AuthenticationError, type CalendarEvent, type CalendarEventSearchQuery, type CalendarEvents, type CommentActivity, type ConvertToSubtask, type CustomField, type CustomFieldCreate, type CustomFieldPatch, type CustomFieldSearchQuery, type Emoji, type HomeTasks, type ImportTemplate, type List, type ListCreate, type ListEnumerate, type ListParticipants, type ListPatch, type ListSearchQuery, type Meeting, type MeetingCreate, type MeetingCreateEvent, type MeetingDetail, type MeetingMinimalResource, type MeetingNotetakerEnable, type MeetingPatch, type MeetingRecordingResource, type MeetingSearchQuery, type Meetings, type NewAttachment, NotFoundError, type Note, type NoteDetail, type NotePatch, type NoteSearchQuery, type Notes, type Notification, type NotificationSearchQuery, type NotificationType, type Notifications, PermissionError, type ReactionCreate, type ReactionReadOnly, type ReactionUser, type Repeat, type RepeatSchema, type RequestOptions, type Search, type SearchCreate, type SearchDetail, type SearchFindQuery, type SearchItem, type SearchPatch, type SearchPayload, type SearchReminderSet, type SearchResults, type SearchRetrieveQuery, type SearchShare, type Searches, type SubList, type SubListCreate, type SubListPatch, type SubListSearchQuery, type SubtaskCreate, type Tag, type TagCreate, type TagPatch, type TagSearchQuery, type Task, type TaskActivities, type TaskActivityBody, type TaskActivitySearchQuery, type TaskAssignment, type TaskBulkCreate, type TaskBulkUpdate, type TaskBulkUpdateResult, type TaskCreate, type TaskFollow, type TaskMove, type TaskPatch, type TaskSearch, type TaskTag, type Team, type TokenApp, type TokenDetails, type TokenTeam, type TokenUser, type User, type UserByEmailQuery, type UserDetail, type UserDetailWithTeam, type UserInvite, type UserResource, type UserSearchQuery, ValidationError, Workast, type WorkastAuth, type WorkastOptions, type Workflow, type WorkflowCreate, type WorkflowDetail, type WorkflowPatch, type WorkflowRun, type WorkflowRunActivity, type WorkflowSearchQuery, type WorkflowTrigger, type Workflows };
+export { type ActivityBody, ApiError, type Attachment, type AttachmentFileUrl, type AttachmentFileUrlQuery, AuthenticationError, type CalendarEvent, type CalendarEventSearchQuery, type CalendarEvents, type CommentActivity, type ConvertToSubtask, type CustomField, type CustomFieldCreate, type CustomFieldPatch, type CustomFieldSearchQuery, type Emoji, type FindHomeSearchesQuery, type HomeTasks, type ImportTemplate, type List, type ListCreate, type ListEnumerate, type ListParticipants, type ListPatch, type ListSearchQuery, type Meeting, type MeetingCreate, type MeetingCreateEvent, type MeetingDetail, type MeetingMinimalResource, type MeetingNotetakerEnable, type MeetingPatch, type MeetingRecordingResource, type MeetingSearchQuery, type Meetings, type NewAttachment, NotFoundError, type Note, type NoteDetail, type NotePatch, type NoteSearchQuery, type Notes, type Notification, type NotificationSearchQuery, type NotificationType, type Notifications, PermissionError, type ReactionCreate, type ReactionReadOnly, type ReactionUser, type Repeat, type RepeatSchema, type RequestOptions, type Search, type SearchCreate, type SearchDetail, type SearchFindQuery, type SearchItem, type SearchPatch, type SearchPayload, type SearchReminderSet, type SearchResults, type SearchRetrieveQuery, type SearchShare, type Searches, type SubList, type SubListCreate, type SubListPatch, type SubListSearchQuery, type SubtaskCreate, type Tag, type TagCreate, type TagPatch, type TagSearchQuery, type Task, type TaskActivities, type TaskActivityBody, type TaskActivitySearchQuery, type TaskAssignment, type TaskBulkCreate, type TaskBulkUpdate, type TaskBulkUpdateResult, type TaskCreate, type TaskFollow, type TaskMove, type TaskPatch, type TaskSearch, type TaskTag, type Team, type TokenApp, type TokenDetails, type TokenTeam, type TokenUser, type User, type UserByEmailQuery, type UserDetail, type UserDetailWithTeam, type UserInvite, type UserResource, type UserSearchQuery, ValidationError, Workast, type WorkastAuth, type WorkastOptions, type Workflow, type WorkflowCreate, type WorkflowDetail, type WorkflowPatch, type WorkflowRun, type WorkflowRunActivity, type WorkflowSearchQuery, type WorkflowTrigger, type Workflows };