@archastro/sdk
    Preparing search index...

    Interface User

    A platform user account. Represents a human or system actor that can own threads, belong to an organization, and interact with the API.

    interface User {
        alias?: string | null;
        app?: string | null;
        app_name?: string | null;
        created_by_agent_user?: string | null;
        created_by_developer?: string | null;
        created_by_org?: string | null;
        created_by_team?: string | null;
        created_by_user?: string | null;
        email?: string | null;
        id: string;
        is_system_user?: boolean;
        metadata?: Record<string, unknown>;
        name?: string | null;
        org?: string | null;
        org_name?: string | null;
        org_role?: string | null;
        org_slug?: string | null;
        sandbox?: string | null;
        sandbox_name?: string | null;
    }
    Index

    Properties

    alias? app? app_name? created_by_agent_user? created_by_developer? created_by_org? created_by_team? created_by_user? email? id is_system_user? metadata? name? org? org_name? org_role? org_slug? sandbox? sandbox_name?

    Properties

    alias?: string | null

    Short handle or alias for the user. null if not set.

    app?: string | null

    ID of the app this user (and their access token) is scoped to (dap_...). null if the user is not scoped to an app.

    app_name?: string | null

    Display name of the user's app. null when the app association was not preloaded by the caller.

    created_by_agent_user?: string | null

    Agent user that created this account (usr_...). null unless an agent created it.

    created_by_developer?: string | null

    Developer account that created this user (dva_...). null unless created via a developer token.

    created_by_org?: string | null

    Org of the principal that created this user (org_...). null on legacy rows.

    created_by_team?: string | null

    Team that created this user (tem_...). null unless created as a team.

    created_by_user?: string | null

    User who created this account (usr_...). null on self-signup or legacy rows.

    email?: string | null

    Email address of the user.

    id: string

    User ID (usr_...).

    is_system_user?: boolean

    true if this account is an internal system user rather than a human. System users are created automatically by the platform.

    metadata?: Record<string, unknown>

    Arbitrary key-value metadata attached to the user. Defaults to an empty object.

    name?: string | null

    Full display name of the user. null if the user has not set a name.

    org?: string | null

    ID of the organization this user belongs to (org_...). null if the user is not a member of any organization.

    org_name?: string | null

    Display name of the user's organization. null when the user is not in an org, or when the org association was not preloaded by the caller.

    org_role?: string | null

    Role of the user within their organization. One of "admin", "member", or "viewer". null when the user is not a member of any organization.

    org_slug?: string | null

    Stable workspace slug for the user's organization. null when the user is not in an org, or when the org association was not preloaded by the caller.

    sandbox?: string | null

    ID of the sandbox environment this user is scoped to (sbx_...). null for production users.

    sandbox_name?: string | null

    Display name of the user's sandbox environment. null for production users, or when the sandbox association was not preloaded by the caller.

    Settings

    Member Visibility

    On This Page

    Properties