> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intern

Public lifecycle state and settings for one intern.

## Example Usage

```typescript theme={null}
import { Intern } from "@openrouter/sdk/models";

let value: Intern = {
  attachedVaultId: null,
  createdAt: "2026-09-16T08:30:00.000Z",
  description: "Researches customer questions",
  hostname: "research-assistant.openrouter.ai",
  id: "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  instructions: null,
  lastFailureMessage: null,
  model: "openai/gpt-5.4",
  name: "research-assistant",
  progress: null,
  status: "running",
  updatedAt: "2026-09-16T08:45:00.000Z",
  vaultId: "b431c59d-6eed-41ac-bc89-9a89be79a121",
  workspaceId: "89f9f5b2-3f89-4eaf-83ca-5ceae149e8bb",
};
```

## Fields

| Field                | Type                                              | Required             | Description                                                                              |
| -------------------- | ------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
| `attachedVaultId`    | *string*                                          | :heavy\_check\_mark: | Vault the intern borrows from another intern, or null when it borrows none.              |
| `createdAt`          | *string*                                          | :heavy\_check\_mark: | ISO 8601 creation time.                                                                  |
| `description`        | *string*                                          | :heavy\_check\_mark: | Free-form description.                                                                   |
| `hostname`           | *string*                                          | :heavy\_check\_mark: | Public hostname the intern is reachable at, or null until provisioning has assigned one. |
| `id`                 | *string*                                          | :heavy\_check\_mark: | Intern id.                                                                               |
| `instructions`       | *string*                                          | :heavy\_check\_mark: | Standing instructions the intern boots with.                                             |
| `lastFailureMessage` | *string*                                          | :heavy\_check\_mark: | Why the last provisioning attempt failed, when status is failed.                         |
| `model`              | *string*                                          | :heavy\_check\_mark: | OpenRouter model slug the intern runs, or null for the workspace default.                |
| `name`               | *string*                                          | :heavy\_check\_mark: | Intern name, unique per creator within a workspace.                                      |
| `progress`           | [models.Progress](../models/progress.mdx)         | :heavy\_check\_mark: | Active provisioning step, or null once provisioning has settled.                         |
| `status`             | [models.InternStatus](../models/internstatus.mdx) | :heavy\_check\_mark: | Lifecycle status.                                                                        |
| `updatedAt`          | *string*                                          | :heavy\_check\_mark: | ISO 8601 last update time.                                                               |
| `vaultId`            | *string*                                          | :heavy\_check\_mark: | Vault the intern owns, or null before it has been created.                               |
| `workspaceId`        | *string*                                          | :heavy\_check\_mark: | Workspace that owns the intern and scopes its secrets.                                   |