> ISPO SDK documentation. [HTML](https://ispo.ai/docs/interfaces/core.AgentSessionCreateInput.html) · [Documentation index](https://ispo.ai/docs/llms.txt)

# Interface AgentSessionCreateInput

```typescript
interface AgentSessionCreateInput {
    agent?: "claude" | "codex" | "opencode" | "pi" | "cursor" | "ispo";
    effort?: string;
    initialMessage?: string;
    model?: string;
    parentSessionId?: string;
    projectId: string;
    timeoutMs?: number;
    workload?: AgentSessionWorkload;
}
```

Types: [agent](#agent), [effort](#effort), [initialMessage](#initialmessage), [model](#model), [parentSessionId](#parentsessionid), [projectId](#projectid), [timeoutMs](#timeoutms), [workload](#workload), [AgentSessionWorkload](../types/core.AgentSessionWorkload.md)

##### Index

### <a id="properties"></a>Properties

[agent?](#agent) [effort?](#effort) [initialMessage?](#initialmessage) [model?](#model) [parentSessionId?](#parentsessionid) [projectId](#projectid) [timeoutMs?](#timeoutms) [workload?](#workload)

## <a id="properties-1"></a>Properties

### <a id="agent"></a>`Optional`agent

```typescript
agent?: "claude" | "codex" | "opencode" | "pi" | "cursor" | "ispo"
```

### <a id="effort"></a>`Optional`effort

```typescript
effort?: string
```

### <a id="initialmessage"></a>`Optional`initialMessage

```typescript
initialMessage?: string
```

### <a id="model"></a>`Optional`model

```typescript
model?: string
```

### <a id="parentsessionid"></a>`Optional`parentSessionId

```typescript
parentSessionId?: string
```

Controller-project provenance only. Main verifies it against the authenticated controller, never the target project or session authority.

### <a id="projectid"></a>projectId

```typescript
projectId: string
```

Target project. The authenticated caller is always the controller and is never selected by this input. Foreign targets require additive `agent.orchestrate` authority plus the exact host-owned pair allowance.

### <a id="timeoutms"></a>`Optional`timeoutMs

```typescript
timeoutMs?: number
```

### <a id="workload"></a>`Optional`workload

```typescript
workload?: AgentSessionWorkload
```

Types: [AgentSessionWorkload](../types/core.AgentSessionWorkload.md)