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

# Interface AgentScheduledRun

A queued or completed one-shot overnight run (§27.5). `scheduledRunId` is an opaque SERVER id — safe to key UI on, but NEVER a proj\_/ten\_/run\_ id; the host redacts the internal project id and hosted run id before this crosses the bridge.

```typescript
interface AgentScheduledRun {
    createdAt: string;
    error?: { code: string };
    outputSummary?: { bytes: number; count: number };
    prompt: string;
    runAt: string;
    scheduledRunId: string;
    status: AgentScheduledRunStatus;
    updatedAt: string;
}
```

Types: [createdAt](#createdat), [error](#error), [outputSummary](#outputsummary), [prompt](#prompt), [runAt](#runat), [scheduledRunId](#scheduledrunid), [status](#status), [AgentScheduledRunStatus](../types/core.AgentScheduledRunStatus.md), [updatedAt](#updatedat)

##### Index

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

[createdAt](#createdat) [error?](#error) [outputSummary?](#outputsummary) [prompt](#prompt) [runAt](#runat) [scheduledRunId](#scheduledrunid) [status](#status) [updatedAt](#updatedat)

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

### <a id="createdat"></a>createdAt

```typescript
createdAt: string
```

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

```typescript
error?: { code: string }
```

A failed run's cause, reduced to a stable, id-free category. The host scrubs the worker's raw error blob before it crosses the bridge — the free-form message and any hosted run\_ id are dropped, only `code` survives.

### <a id="outputsummary"></a>`Optional`outputSummary

```typescript
outputSummary?: { bytes: number; count: number }
```

Bounded review metadata for staged output. The output bytes remain in Cloud until the user commits or discards them in host chrome.

### <a id="prompt"></a>prompt

```typescript
prompt: string
```

### <a id="runat"></a>runAt

```typescript
runAt: string
```

ISO-8601 target time the run becomes claimable.

### <a id="scheduledrunid"></a>scheduledRunId

```typescript
scheduledRunId: string
```

### <a id="status"></a>status

```typescript
status: AgentScheduledRunStatus
```

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

### <a id="updatedat"></a>updatedAt

```typescript
updatedAt: string
```