Cmdlet

Send-IntelligenceXMessage

Namespace IntelligenceX.PowerShell

Inputs

IntelligenceX.OpenAI.IntelligenceXClient

Outputs

IntelligenceX.Json.JsonValue IntelligenceX.OpenAI.AppServer.Models.TurnInfo

Sends a message to a thread and starts a turn.

Examples

Example 1


Send-IntelligenceXMessage -ThreadId $thread.id -Text "Review this diff."

Send a message in an existing thread

Example 2


Send-IntelligenceXMessage -ThreadId $thread.id -Text "Summarize changes." -Model "gpt-5.3-codex"

Send a message with a temporary model override

Example 3


Send-IntelligenceXMessage -ThreadId $thread.id -Text "Run tests" -SandboxType "workspace" -NetworkAccess -WritableRoot "C:\repo"

Send a message with a workspace sandbox

Example 4


Send-IntelligenceXMessage -ThreadId $thread.id -Text "Status?" -Raw

Return raw JSON output

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

Send-IntelligenceXMessage -Text <string> -ThreadId <string> [-ApprovalPolicy <string>] [-Client <IntelligenceXClient>] [-CurrentDirectory <string>] [-Model <string>] [-NetworkAccess] [-Raw] [-SandboxType <string>] [-WritableRoot <string[]>] [<CommonParameters>]

Parameters

Text string requiredposition: namedpipeline: false: Message text to send.
ThreadId string requiredposition: namedpipeline: false: Thread identifier to send the message to.
ApprovalPolicy string optionalposition: namedpipeline: false: Approval policy name to use.
Client IntelligenceXClient optionalposition: namedpipeline: true (ByValue): Client instance to use. Defaults to the active client.
CurrentDirectory string optionalposition: namedpipeline: false: Working directory to pass to the app-server.
Model string optionalposition: namedpipeline: false: Optional model override.
NetworkAccess SwitchParameter optionalposition: namedpipeline: false: Enable network access for sandboxed runs.
Raw SwitchParameter optionalposition: namedpipeline: false: Return raw JSON response.
SandboxType string optionalposition: namedpipeline: false: Sandbox type (for example 'workspace' or 'danger-full-access').
WritableRoot string[] optionalposition: namedpipeline: false: Writable root paths for sandboxed runs.

Outputs

IntelligenceX.Json.JsonValue, IntelligenceX.OpenAI.AppServer.Models.TurnInfo