Batches

​

Example

var client = new Phaseo(apiKey: apiKey);

var batch = await client.CreateBatch(new Dictionary<string, object>
{
    ["model"] = "openai/gpt-5-mini",
    ["prompts"] = new[] { "Summarize this record.", "Classify this support ticket." },
    ["system"] = "Be concise.",
    ["max_tokens"] = 256,
    ["completion_window"] = "24h",
    ["session_id"] = "agent-run-42",
    ["webhook_endpoint_id"] = "we_123"
});

var status = await client.RetrieveBatch((string)batch!["id"]);
var cancelling = await client.CancelBatch((string)batch["id"]);
var websocketUrl = client.GetBatchWebSocketUrl((string)batch["id"], intervalMs: 1500);

​

Key parameters

• model: Model id used to infer the upstream provider. Most callers should not pass provider.
• prompts: Simple shorthand for one or more prompt strings.
• items: Structured prompt shorthand with id / custom_id, prompt, messages, per-row settings, or an advanced body.
• requests: Advanced inline provider-native batch rows.
• input_file_id: Existing file id uploaded via /batches/files?model=... for large prebuilt JSONL inputs.
• endpoint: Optional target endpoint for advanced rows. Phaseo chooses a model/provider default when omitted.
• completion_window: e.g., 24h.
• session_id: Optional Phaseo grouping id for logs, sessions, and investigate tooling.
• webhook: Optional webhook configuration for async lifecycle notifications.
• metadata: Optional object stored with the batch.

​

Returns