@archastro/sdk
    Preparing search index...

    Interface ThreadMessage

    A single message posted to a thread, as seen from the developer portal. Includes sender information, optional attachments, and scoping identifiers.

    interface ThreadMessage {
        acl?: Acl;
        admin?: Record<string, unknown>;
        agent?: string;
        agent_mode?: "cli" | "embedded";
        app?: string;
        attachments?: Attachment[];
        content?: string;
        created_at?: string;
        id: string;
        metadata?: Record<string, unknown>;
        org?: string;
        root_message_id?: string | null;
        sandbox?: string;
        sender?: string;
        sender_name?: string;
        sender_type?: string;
        team?: string;
        type?: string;
        user?: string;
        visibility?: "default" | "private";
    }
    Index

    Properties

    acl? admin? agent? agent_mode? app? attachments? content? created_at? id metadata? org? root_message_id? sandbox? sender? sender_name? sender_type? team? type? user? visibility?

    Properties

    acl?: Acl

    Access control list for private messages. Only returned to resource owners (and privileged/org-admin viewers); null otherwise.

    admin?: Record<string, unknown>

    Admin-only diagnostic metadata for the message, including execution trajectory details. Only present in developer portal responses.

    agent?: string

    Agent ID (agt_...) associated with the message. null if not agent-scoped.

    agent_mode?: "cli" | "embedded"

    Local agent execution mode for this message. One of cli, embedded, or null when the message was not created by a local agent execution path.

    app?: string

    App ID (app_...) that the message belongs to.

    attachments?: Attachment[]

    Files or media attached to the message. Empty array if no attachments are present.

    Optionalcontent

    content?: string

    Text content of the message. null if the message contains only attachments.

    created_at?: string

    When the message was posted to the thread (ISO 8601).

    id: string

    Message ID (msg_...).

    metadata?: Record<string, unknown>

    Key-value metadata attached to the message. Always present; defaults to an empty object. The metadata query parameter filters on this same object, so a caller can read back the field it selects on.

    org?: string

    Organization ID (org_...) this message is scoped to. null if not org-scoped.

    root_message_id?: string | null

    ID of the root message in this reply chain (msg_...). null for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages.

    sandbox?: string

    Sandbox ID (dsb_...) this message is scoped to. null if not sandbox-scoped.

    sender?: string

    Public ID of the sender (e.g. usr_... or agt_...). null for system-generated messages.

    sender_name?: string

    Display name of the message sender. null if unavailable.

    sender_type?: string

    Category of entity that sent the message. One of "user", "agent", or "system".

    team?: string

    Team ID (tea_...) associated with the message. null if not team-scoped.

    type?: string

    Optional client-defined classification for the message (for example note or status). Free-form string up to 64 characters. The value system is reserved for platform-authored messages and cannot be set by clients. null when unset.

    user?: string

    User ID (usr_...) associated with the message. null if not user-scoped.

    visibility?: "default" | "private"

    Message-level visibility. default follows thread membership; private is limited to the sender and ACL read grantees.

    Settings

    Member Visibility

    On This Page

    Properties