@archastro/sdk 0.20.0 → 0.22.0

package/dist/v1/resources/users.d.ts

@@ -1,7 +1,7 @@
 import { HttpClient } from "../../runtime/http-client.js";
 import type { CurrentUser } from "../../types/common.js";
 import type { SystemAccessToken } from "../../types/system.js";
-import type { Task } from "../../types/tasks.js";
+import type { Task, TaskEnsureResult, TaskEpicEntity, TaskEpicEntityCollection } from "../../types/tasks.js";
 import type { Thread } from "../../types/threads.js";
 import type { User, UserInvite, UserSSHKey } from "../../types/users.js";
 export declare class IntegrationResource {
@@ -76,6 +76,98 @@ export declare class UserSshKeyResource {
         public_key: string;
     }): Promise<UserSSHKey>;
 }
+export declare class UserTaskEpicResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List an owner's epic summaries
+     * Groups tasks by their exact epic label, ordered by label. Closed tasks include cancelled tasks, but cancelled prerequisites still block. Source filters select the tasks summarized; blockers outside that selection still affect readiness. Root ranking is capped per epic and root_blockers_partial is true when that graph is truncated. No epic entity is created.
+     * @param params - Query parameters.
+     * @param params.representation - labels (default) or entities.
+     * @param params.name - Exact entity name; only used for entities.
+     * @param params.sourceScope - Exact source scope; supply all three source fields.
+     * @param params.sourceType - Exact source type.
+     * @param params.sourceId - Exact source ID.
+     * @param params.topPriority - Exact highest open priority, from 0 to 4.
+     * @param params.owner - Keep only epics with at least one non-closed task owned by this user: `me` or a user public ID (`usr_...`).
+     * @param params.includeClosed - Include epics with no non-closed tasks; defaults to false.
+     * @param params.limit - Maximum epics; defaults to 50, capped at 100.
+     * @param params.afterCursor - Opaque forward cursor from the preceding page.
+     * @returns Successful response
+     */
+    list(user: string, params?: {
+        representation?: string;
+        name?: string;
+        team?: string;
+        org?: string;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        topPriority?: number;
+        owner?: string;
+        includeClosed?: boolean;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | null | undefined;
+        before_cursor?: string | null | undefined;
+        data: {
+            blocked_count: number;
+            counts: Record<string, unknown>;
+            epic: string;
+            next_ready: {
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            }[];
+            owner?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            primary_task?: {
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            } | null | undefined;
+            root_blockers: {
+                downstream_count: number;
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            }[];
+            root_blockers_partial: boolean;
+            top_open_priority?: number | null | undefined;
+            updated_at: string;
+        }[];
+        has_more: boolean;
+        no_epic_open_count: number;
+    } | TaskEpicEntityCollection>;
+    /**
+     * Create a task Epic
+     * @param input - Request body.
+     * @returns Successful response
+     */
+    create(user: string, input: {
+        description?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        name: string;
+        state?: string | undefined;
+        team?: string | undefined;
+    }): Promise<TaskEpicEntity>;
+}
 export declare class UserTaskResource {
     private http;
     constructor(http: HttpClient);
@@ -96,6 +188,9 @@ export declare class UserTaskResource {
      * @param params.status - Filter tasks by status. One of `"open"`, `"in_progress"`, `"in_review"`, or `"done"`. Omit to return tasks in all statuses.
      * @param params.ownerUser - Filter tasks assigned to a specific user. Provide the user's public ID (`usr_...`).
      * @param params.ownerAgent - Filter tasks assigned to a specific agent. Provide the agent's public ID (`agi_...`).
+     * @param params.owner - Return only tasks owned by this user: `me` or a user public ID (`usr_...`).
+     * @param params.involving - Return only tasks owned or created by this user: `me` or a user public ID (`usr_...`). The "My work" predicate.
+     * @param params.summary - When true, omit `description` from every task. Use for list views.
      * @param params.priority - Filter tasks by priority, from 0 (highest) to 4 (lowest).
      * @param params.tag - Return only tasks carrying this tag (matched against the canonical lowercase form).
      * @param params.parent - Return only subtasks of the given task (`tsk_...`), or pass `none` to return only top-level tasks.
@@ -110,6 +205,7 @@ export declare class UserTaskResource {
      * @param params.dueAfter - Return only tasks with a due date strictly after this ISO 8601 datetime or date. Tasks without a due date are excluded.
      * @param params.overdue - When `true`, return only overdue tasks: a due date before the current UTC day and a status other than `"done"`. A task due today is not overdue.
      * @param params.ready - When true, return only open tasks with no unfinished blockers and no active session lease. This is a projection snapshot; claim a lease before starting work.
+     * @param params.attention - When true, return paused, failed, or in-progress tasks with no lease or a past lease expiry.
      * @param params.limit - Maximum number of tasks to return. Capped at 100.
      * @param params.afterCursor - Opaque cursor returned by the previous page.
      * @returns Successful response
@@ -120,6 +216,9 @@ export declare class UserTaskResource {
         status?: string;
         ownerUser?: string;
         ownerAgent?: string;
+        owner?: string;
+        involving?: string;
+        summary?: boolean;
         priority?: number;
         tag?: string;
         parent?: string;
@@ -134,6 +233,7 @@ export declare class UserTaskResource {
         dueAfter?: string;
         overdue?: boolean;
         ready?: boolean;
+        attention?: boolean;
         limit?: number;
         afterCursor?: string;
     }): Promise<{
@@ -143,6 +243,7 @@ export declare class UserTaskResource {
             agent?: string | null | undefined;
             aggregate_version?: number | null | undefined;
             blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
             closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
@@ -170,9 +271,12 @@ export declare class UserTaskResource {
             description?: string | null | undefined;
             due_date?: string | null | undefined;
             epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
             id: string;
             is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
             org?: string | null | undefined;
@@ -194,13 +298,18 @@ export declare class UserTaskResource {
             owner_user?: string | null | undefined;
             parent?: string | null | undefined;
             priority?: number | undefined;
+            project_id?: string | null | undefined;
             sandbox?: string | null | undefined;
             source_id?: string | null | undefined;
             source_scope?: string | null | undefined;
             source_type?: string | null | undefined;
+            stalled_since?: string | null | undefined;
             status: string;
             subtasks_count?: number | undefined;
             tags?: string[] | undefined;
+            target_binary?: string | null | undefined;
+            target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
             team?: string | null | undefined;
             thread?: string | null | undefined;
             updated_at?: string | undefined;
@@ -229,9 +338,11 @@ export declare class UserTaskResource {
         agent?: string | undefined;
         org?: string | undefined;
         task: {
+            blockers?: string[] | undefined;
             description?: string | undefined;
             due_date?: string | undefined;
             epic?: string | undefined;
+            epic_id?: string | undefined;
             id?: string | undefined;
             links?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -240,11 +351,14 @@ export declare class UserTaskResource {
             owner_user?: string | undefined;
             parent?: string | undefined;
             priority?: number | undefined;
+            project_id?: string | undefined;
             source_id?: string | undefined;
             source_scope?: string | undefined;
             source_type?: string | undefined;
             status?: string | undefined;
             tags?: string[] | undefined;
+            target_binary?: string | undefined;
+            target_version?: string | undefined;
             thread?: string | undefined;
         };
         team?: string | undefined;
@@ -277,6 +391,7 @@ export declare class UserTaskResource {
                 agent?: string | null | undefined;
                 aggregate_version?: number | null | undefined;
                 blocked_by_count?: number | undefined;
+                blockers?: string[] | undefined;
                 closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
@@ -304,9 +419,12 @@ export declare class UserTaskResource {
                 description?: string | null | undefined;
                 due_date?: string | null | undefined;
                 epic?: string | null | undefined;
+                human_answer_receipts?: Record<string, unknown> | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
+                is_stalled?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
+                machine_rescope_receipts?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
                 org?: string | null | undefined;
@@ -328,13 +446,18 @@ export declare class UserTaskResource {
                 owner_user?: string | null | undefined;
                 parent?: string | null | undefined;
                 priority?: number | undefined;
+                project_id?: string | null | undefined;
                 sandbox?: string | null | undefined;
                 source_id?: string | null | undefined;
                 source_scope?: string | null | undefined;
                 source_type?: string | null | undefined;
+                stalled_since?: string | null | undefined;
                 status: string;
                 subtasks_count?: number | undefined;
                 tags?: string[] | undefined;
+                target_binary?: string | null | undefined;
+                target_version?: string | null | undefined;
+                task_epic?: string | null | undefined;
                 team?: string | null | undefined;
                 thread?: string | null | undefined;
                 updated_at?: string | undefined;
@@ -343,11 +466,140 @@ export declare class UserTaskResource {
         }[];
         has_more: boolean;
     }>;
+    /**
+     * Find an owner's tasks by external reference
+     * Returns all exact external-reference matches owned by the requested principal. Multiple matches remain explicit; callers must not choose an arbitrary task.
+     * @param user - User ID (`usr_...`) for user-scoped tasks.
+     * @param params - Query parameters.
+     * @param params.team - Team owner.
+     * @param params.org - Organization consistency check.
+     * @param params.externalScope - External host.
+     * @param params.objectType - External object type.
+     * @param params.objectId - External object identity.
+     * @returns Successful response
+     */
+    byExternalReference(user: string, params?: {
+        team?: string;
+        org?: string;
+        externalScope?: string;
+        objectType?: string;
+        objectId?: string;
+    }): Promise<{
+        data: {
+            agent?: string | null | undefined;
+            aggregate_version?: number | null | undefined;
+            blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
+            closed_at?: string | null | undefined;
+            comments_count?: number | undefined;
+            created_at?: string | undefined;
+            created_by_actor?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            created_by_agent?: string | null | undefined;
+            created_by_user?: string | null | undefined;
+            current_lease?: {
+                expires_at: string;
+                harness: string;
+                session_name: string;
+            } | null | undefined;
+            description?: string | null | undefined;
+            due_date?: string | null | undefined;
+            epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
+            id: string;
+            is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
+            links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            name: string;
+            org?: string | null | undefined;
+            owner_actor?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            owner_agent?: string | null | undefined;
+            owner_user?: string | null | undefined;
+            parent?: string | null | undefined;
+            priority?: number | undefined;
+            project_id?: string | null | undefined;
+            sandbox?: string | null | undefined;
+            source_id?: string | null | undefined;
+            source_scope?: string | null | undefined;
+            source_type?: string | null | undefined;
+            stalled_since?: string | null | undefined;
+            status: string;
+            subtasks_count?: number | undefined;
+            tags?: string[] | undefined;
+            target_binary?: string | null | undefined;
+            target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
+            team?: string | null | undefined;
+            thread?: string | null | undefined;
+            updated_at?: string | undefined;
+            user?: string | null | undefined;
+        }[];
+    }>;
+    /**
+     * Find or create a task by source
+     * Atomically creates one task per owner, tenant and source. Retries return the current task without updating it. Historical tasks created through ordinary create are not adopted.
+     * @param user - User ID (`usr_...`) for user-scoped tasks.
+     * @param input - Request body.
+     * @param input.agent - Explicit acting agent for privileged callers.
+     * @param input.description - Initial task description.
+     * @param input.epic - Initial epic grouping.
+     * @param input.name - Initial task name.
+     * @param input.org - Explicit organization for privileged callers.
+     * @param input.owner_user - Initial assigned user; immutable on retries.
+     * @param input.source_id - Source identity, for example owner/repo#123.
+     * @param input.source_scope - Source scope, for example github.
+     * @param input.source_type - Source type, for example pull_request.
+     * @param input.status - Initial task status.
+     * @param input.team - Team owner.
+     * @returns The task and whether this request created it.
+     */
+    bySource(user: string, input: {
+        agent?: string | undefined;
+        description?: string | undefined;
+        epic?: string | undefined;
+        name: string;
+        org?: string | undefined;
+        owner_user?: string | undefined;
+        source_id: string;
+        source_scope: string;
+        source_type: string;
+        status?: string | undefined;
+        team?: string | undefined;
+    }): Promise<TaskEnsureResult>;
     /**
      * List an owner's ready tasks
      * Returns open tasks with no unfinished blockers and no active session lease.
      * Readiness is calculated by the server from the current task projection. It is
      * a snapshot, not a reservation; claim a task lease before starting work.
+     * Results are ordered by priority (0, the most urgent, first), then oldest
+     * first, so the first page is always the most urgent ready work.
      * Pass `explain=true` to include every open task with a stable readiness reason.
      * @param user - User ID (`usr_...`) for user-scoped tasks.
      * @param params - Query parameters.
@@ -385,6 +637,7 @@ export declare class UserTaskResource {
                 agent?: string | null | undefined;
                 aggregate_version?: number | null | undefined;
                 blocked_by_count?: number | undefined;
+                blockers?: string[] | undefined;
                 closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
@@ -412,9 +665,12 @@ export declare class UserTaskResource {
                 description?: string | null | undefined;
                 due_date?: string | null | undefined;
                 epic?: string | null | undefined;
+                human_answer_receipts?: Record<string, unknown> | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
+                is_stalled?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
+                machine_rescope_receipts?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
                 org?: string | null | undefined;
@@ -436,13 +692,18 @@ export declare class UserTaskResource {
                 owner_user?: string | null | undefined;
                 parent?: string | null | undefined;
                 priority?: number | undefined;
+                project_id?: string | null | undefined;
                 sandbox?: string | null | undefined;
                 source_id?: string | null | undefined;
                 source_scope?: string | null | undefined;
                 source_type?: string | null | undefined;
+                stalled_since?: string | null | undefined;
                 status: string;
                 subtasks_count?: number | undefined;
                 tags?: string[] | undefined;
+                target_binary?: string | null | undefined;
+                target_version?: string | null | undefined;
+                task_epic?: string | null | undefined;
                 team?: string | null | undefined;
                 thread?: string | null | undefined;
                 updated_at?: string | undefined;
@@ -505,6 +766,7 @@ export declare class UserTaskResource {
             agent?: string | null | undefined;
             aggregate_version?: number | null | undefined;
             blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
             closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
@@ -532,9 +794,12 @@ export declare class UserTaskResource {
             description?: string | null | undefined;
             due_date?: string | null | undefined;
             epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
             id: string;
             is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
             org?: string | null | undefined;
@@ -556,13 +821,18 @@ export declare class UserTaskResource {
             owner_user?: string | null | undefined;
             parent?: string | null | undefined;
             priority?: number | undefined;
+            project_id?: string | null | undefined;
             sandbox?: string | null | undefined;
             source_id?: string | null | undefined;
             source_scope?: string | null | undefined;
             source_type?: string | null | undefined;
+            stalled_since?: string | null | undefined;
             status: string;
             subtasks_count?: number | undefined;
             tags?: string[] | undefined;
+            target_binary?: string | null | undefined;
+            target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
             team?: string | null | undefined;
             thread?: string | null | undefined;
             updated_at?: string | undefined;
@@ -646,15 +916,30 @@ export declare class UserThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    add_denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
+                    denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                     grants?: {
                         actions: string[];
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    preserve_denies?: boolean | undefined;
                     remove?: {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    remove_denies?: {
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                 } | null | undefined;
                 actors?: {
                     alias?: string | null | undefined;
@@ -698,8 +983,10 @@ export declare class UserThreadResource {
                     type: string;
                     url?: string | null | undefined;
                     variants?: {
+                        byte_size?: number | null | undefined;
                         content_type?: string | null | undefined;
                         created_at?: string | undefined;
+                        duration_ms?: number | null | undefined;
                         file?: string | undefined;
                         filename?: string | null | undefined;
                         height?: number | null | undefined;
@@ -713,8 +1000,10 @@ export declare class UserThreadResource {
                             url?: string | null | undefined;
                             width?: number | null | undefined;
                         } | null | undefined;
+                        sha256?: string | null | undefined;
                         updated_at?: string | undefined;
                         url?: string | null | undefined;
+                        url_expires_at?: string | null | undefined;
                         variant_key?: string | undefined;
                         width?: number | null | undefined;
                     }[] | undefined;
@@ -806,15 +1095,30 @@ export declare class UserThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    add_denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
+                    denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                     grants?: {
                         actions: string[];
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    preserve_denies?: boolean | undefined;
                     remove?: {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    remove_denies?: {
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                 } | null | undefined;
                 app?: string | undefined;
                 created_at?: string | undefined;
@@ -987,6 +1291,7 @@ export declare class UserThreadResource {
             sub_threads?: Record<string, unknown>[] | null | undefined;
             tags?: string[] | undefined;
             team?: string | null | undefined;
+            thread_template_key?: string | null | undefined;
             title?: string | null | undefined;
             ttl?: string | null | undefined;
             unread_count?: number | null | undefined;
@@ -1036,6 +1341,38 @@ export declare class UserThreadResource {
             visibility?: "team" | "restricted" | "private" | "org" | undefined;
         };
     }): Promise<Thread>;
+    /**
+     * Create a private thread from a template
+     * Creates a private personal thread, installs the template's agent once per user,
+     * and atomically adds its members and a dedicated E2B computer. Requires
+     * `devbox_access`. The computer starts pending and provisions asynchronously.
+     * `key` is prefixed by the template namespace and is unique for the user. Replays return
+     * 200 and never provision another computer or resend the first message; creation
+     * returns 201. Initial-message delivery occurs after commit; a delivery failure
+     * is returned as `first_message_error` so the caller can resend it.
+     * `computer` is optional and applies on creation only: a replay with the same
+     * `key` returns the original thread and computer, ignoring any different
+     * `computer`, exactly like `title` and `first_message`. Invalid `computer`
+     * input returns 422 `invalid_parameters` before anything is created; a provider
+     * this deployment has no credentials for returns 422 `provider_unavailable`.
+     * Unknown templates return 422 `unknown_thread_template`; installation failures
+     * return 502 `agent_install_failed`. Computer config and credentials are never returned.
+     * @param user - User ID (`usr_...`) whose threads should be listed.
+     * @param input - Request body.
+     * @param input.computer - Optional computer choice, applied on creation only: `provider` (`sprites`, `vercel`, `e2b` or `devbox`; defaults to the template's) and `repositories` (0 to 16 `{repository: owner/name, ref: optional}`; the first is the primary working directory).
+     * @param input.first_message - Optional first user message, posted only on creation.
+     * @param input.key - Required nonempty client idempotency key.
+     * @param input.template - Thread template lookup key.
+     * @param input.title - Title for the new thread.
+     * @returns Thread fields plus agent and computers summaries, and optional first_message_error.
+     */
+    fromTemplate(user: string, input: {
+        computer?: Record<string, unknown> | undefined;
+        first_message?: string | undefined;
+        key?: string | undefined;
+        template: string;
+        title?: string | undefined;
+    }): Promise<Record<string, unknown>>;
 }
 export declare class TokenResource {
     private http;
@@ -1112,6 +1449,7 @@ export declare class UserResource {
     private http;
     readonly integrations: IntegrationResource;
     readonly ssh_keys: UserSshKeyResource;
+    readonly task_epics: UserTaskEpicResource;
     readonly tasks: UserTaskResource;
     readonly threads: UserThreadResource;
     readonly tokens: TokenResource;
@@ -1135,8 +1473,8 @@ export declare class UserResource {
     /**
      * Retrieve a user by ID
      * Returns the user identified by `user`. The authenticated user must share
-     * at least one team with the target user; requests for users outside any
-     * shared team are rejected with 403.
+     * an organization or at least one team with the target user; other requests
+     * are rejected with 403.
      * A user may always retrieve their own profile with this endpoint. Use the
      * `GET /users/me` endpoint as a convenience alias for retrieving the
      * authenticated user without specifying an ID.
@@ -1166,6 +1504,37 @@ export declare class UserResource {
         groupKeyPrefix?: string;
     }): Promise<{
         data: {
+            acl?: {
+                add?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                add_denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                grants?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                preserve_denies?: boolean | undefined;
+                remove?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                remove_denies?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+            } | null | undefined;
             agent?: string | undefined;
             content_type?: string | undefined;
             created_at?: string | undefined;