# OneShotInteractionVersion

A version of a one-shot interaction.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `agent` | [`InteractionAgentBinding`](https://docs.maitento.com/reference/types/interaction-agent-binding.md) | The agent that takes the task. |
| `externalOperationsMcp` | [`McpExternalOperationBinding`](https://docs.maitento.com/reference/types/mcp-external-operation-binding.md)`[]` | Tools from MCP connectors that every agent in the interaction can call, as well as its own tools. |
| `externalOperationsOpenApi` | [`OpenApiExternalOperationBinding`](https://docs.maitento.com/reference/types/open-api-external-operation-binding.md)`[]` | Tools from OpenAPI connectors that every agent in the interaction can call, as well as its own tools. |
| `inputsConnectorAuthenticationSecret` | [`ConnectorAuthenticationSecretInput`](https://docs.maitento.com/reference/types/connector-authentication-secret-input.md)`[]` | Run inputs that choose the secret a tool sends with its calls. |
| `inputsConnectorBinding` | [`ConnectorBindingInput`](https://docs.maitento.com/reference/types/connector-binding-input.md)`[]` | Run inputs whose values go straight into a tool's calls, so the model never sees or chooses them. |
| `inputsPrompt` | [`PromptInput`](https://docs.maitento.com/reference/types/prompt-input.md)`[]` | The inputs a run is started with, which the prompt uses as `%%name%%`. |
| `prompt` | `string` | What the agents are asked to do. A run's inputs are filled in wherever it says `%%name%%`. |
| `solutionSchema` | `string \| null` | The JSON Schema the answer must match, as JSON text: the run's output is then JSON of that shape. Null: the output is free text. |
| `systemPromptMode` | [`InteractionSystemPromptMode`](https://docs.maitento.com/reference/types/interaction-system-prompt-mode.md) | How `systemPrompts` combine with the instructions Maitento gives every agent. |
| `systemPrompts` | `string[]` | Extra system instructions for every agent in the interaction. |
| `durationWarningToAi` | `timespan \| null` | How long into a run the agents are told that time is running short. Null: they are not told. |
| `durationAutoTermination` | `timespan \| null` | The longest a run may take. The run stops with an error when it is reached; time spent waiting for a person does not count. Null: the interaction sets no limit. |
| `contextSettings` | [`InteractionContextSettings`](https://docs.maitento.com/reference/types/interaction-context-settings.md) | How the conversation is kept within the model's context window, and how many rounds of tool calls an agent may make in one turn. |
| `loom` | [`LoomConfiguration`](https://docs.maitento.com/reference/types/loom-configuration.md)`\| null` | Long-term memory for the interaction's agents. Null: no memory. |
| `swarm` | [`InteractionSwarmSettings`](https://docs.maitento.com/reference/types/interaction-swarm-settings.md)`\| null` | Whether this interaction's participants may start sub-interactions, which ones, and how far the work may spread. Null: none may. |
| `credentialStack` | `string \| null` | The credential stack this interaction's runs use, by id or name, when their start doesn't name one. Null: the namespace's default stack, then your tenant's. |
| `version` | `integer` | The version number, from 1. Every change to a definition adds a new version with the next number. |
| `date` | `datetime` | When this version was created, in UTC. |
| `isDisabled` | `boolean` | Whether this version is disabled. A disabled version is never used: new links and runs take the latest enabled version, and anything pinned to this one fails until it is re-enabled. |

## Example

```json
{
  "agent": {
    "name": "...",
    "agent": {
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "version": 0
    },
    "externalOperationsMcp": [
      {}
    ],
    "externalOperationsOpenApi": [
      {}
    ],
    "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "webAccess": {
      "search": false,
      "fetch": false
    }
  },
  "externalOperationsMcp": [
    {
      "name": "...",
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "externalOperationVersion": 0,
      "requestBindings": [],
      "authenticationHeader": {},
      "promptGuidance": "...",
      "isTerminal": false
    }
  ],
  "externalOperationsOpenApi": [
    {
      "pathBindings": [],
      "queryBindings": [],
      "name": "...",
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "externalOperationVersion": 0,
      "requestBindings": [],
      "authenticationHeader": {},
      "promptGuidance": "...",
      "isTerminal": false
    }
  ],
  "inputsConnectorAuthenticationSecret": [
    {
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "agentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "defaultSecretId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "headerName": "...",
      "name": "...",
      "description": "...",
      "isRequired": false
    }
  ],
  "inputsConnectorBinding": [
    {
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "agentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "target": "...",
      "defaultValue": "...",
      "type": "Request",
      "name": "...",
      "description": "...",
      "isRequired": false
    }
  ],
  "inputsPrompt": [
    {
      "dataType": "String",
      "name": "...",
      "description": "...",
      "isRequired": false
    }
  ],
  "prompt": "...",
  "solutionSchema": "...",
  "systemPromptMode": "AppendToDefault",
  "systemPrompts": [
    "..."
  ],
  "durationWarningToAi": "00:05:00",
  "durationAutoTermination": "00:05:00",
  "contextSettings": {
    "mode": "None",
    "targetUtilization": 0,
    "toolResultTrimmingMode": "Never",
    "toolResultTrimmingMaxCycles": 0,
    "toolResultTrimmingStyle": "Placeholder",
    "effectiveToolResultTrimmingStyle": "Placeholder",
    "toolResultTrimmingReplacement": "...",
    "compactionType": "SameAgent",
    "effectiveCompactionType": "SameAgent",
    "lowWaterUtilization": 0,
    "effectiveLowWaterUtilization": 0,
    "compactAtUtilization": 0,
    "compactKeepRecentTokens": 0,
    "compactTargetTokens": 0,
    "maxToolCallLoops": 0,
    "effectiveMaxToolCallLoops": 0,
    "responseMaxTokens": 0,
    "compactMaxTokens": 0
  },
  "loom": {
    "enabled": false,
    "scope": "Process",
    "scopeInput": "...",
    "shared": false,
    "recall": "Off",
    "weave": "Manual",
    "tapestryTokens": 0,
    "subjectInputs": [
      "..."
    ],
    "nightWeaving": false,
    "quietMinutes": 0,
    "weaverModel": "...",
    "vetModel": "...",
    "vetRecall": false,
    "seedFromLoomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "readFromLoomIds": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "effectiveScope": "Process",
    "effectiveShared": false,
    "effectiveRecall": "Off",
    "effectiveWeave": "Manual",
    "effectiveTapestryTokens": 0,
    "effectiveSubjectInputs": [
      "..."
    ],
    "effectiveReadFromLoomIds": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "vets": false,
    "effectiveVetRecall": false
  },
  "swarm": {
    "interactions": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "participants": [
      "..."
    ],
    "maxDepth": 0,
    "maxConcurrent": 0,
    "maxTotal": 0
  },
  "credentialStack": "...",
  "version": 0,
  "date": "2026-10-26T12:00:00.0000000Z",
  "isDisabled": false
}
```

## Where it's used

- Inside [`OneShotInteraction`](https://docs.maitento.com/reference/types/one-shot-interaction.md)