OneShotInteractionUpdateRequest

A new version of a one-shot interaction.

Kind: an object, used in requests.

Fields

Field	Type	Required	Description
agent	InteractionAgentBindingInput	yes	The agent that takes the task. Constraints: required (empty or whitespace-only strings are rejected).
name	string	yes	The interaction’s name, unique within its namespace. Constraints: maxLength: 150, required (empty or whitespace-only strings are rejected).
prompt	string	yes	What the agents are asked to do. A run’s inputs are filled in wherever it says %%name%%. Constraints: minLength: 3, required (empty or whitespace-only strings are rejected).
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	yes	How systemPrompts combine with the instructions Maitento gives every agent. Constraints: required (empty or whitespace-only strings are rejected).
systemPrompts	string[]	yes	Extra system instructions for every agent in the interaction. Constraints: required (empty or whitespace-only strings are rejected).
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: no limit.
contextSettings	InteractionContextSettingsInput| null		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. Null: the defaults.
swarm	InteractionSwarmSettingsInput| null		The sub-interactions its participants may start. Null: none.
credentialStack	string | null		The credential stack its runs use, by id or name, when their start doesn’t name one. Null: the namespace’s default stack, then your tenant’s. A stack that doesn’t exist when a run starts refuses the run.
externalOperationsOpenApi	OpenApiExternalOperationBindingInput[]	yes	Tools from OpenAPI connectors that every agent in the interaction can call, as well as its own tools. Constraints: required (empty or whitespace-only strings are rejected).
externalOperationsMcp	McpExternalOperationBindingInput[]	yes	Tools from MCP connectors that every agent in the interaction can call, as well as its own tools. Constraints: required (empty or whitespace-only strings are rejected).
inputsConnectorAuthenticationSecret	ConnectorAuthenticationSecretInputInput[]	yes	Run inputs that choose the secret a tool sends with its calls. Constraints: required (empty or whitespace-only strings are rejected).
inputsConnectorBinding	ConnectorBindingInputInput[]	yes	Run inputs whose values go straight into a tool’s calls, so the model never sees or chooses them. Constraints: required (empty or whitespace-only strings are rejected).
inputsPrompt	PromptInputInput[]	yes	The inputs a run is started with, which the prompt uses as %%name%%. Constraints: required (empty or whitespace-only strings are rejected).
loom	LoomConfigurationInput| null		Long-term memory for the interaction’s agents. Null: no memory.

Example

{
  "agent": {
    "name": "...",
    "agent": {
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "version": 0
    },
    "externalOperationsMcp": [
      {}
    ],
    "externalOperationsOpenApi": [
      {}
    ],
    "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "webAccess": {
      "search": false,
      "fetch": false
    }
  },
  "name": "...",
  "prompt": "...",
  "solutionSchema": "...",
  "systemPromptMode": "AppendToDefault",
  "systemPrompts": [
    "..."
  ],
  "durationWarningToAi": "00:05:00",
  "durationAutoTermination": "00:05:00",
  "contextSettings": {
    "mode": "None",
    "targetUtilization": 0,
    "toolResultTrimmingMode": "Never",
    "toolResultTrimmingMaxCycles": 0,
    "toolResultTrimmingStyle": "Placeholder",
    "toolResultTrimmingReplacement": "...",
    "compactionType": "SameAgent",
    "lowWaterUtilization": 0,
    "compactAtUtilization": 0,
    "compactKeepRecentTokens": 0,
    "compactTargetTokens": 0,
    "maxToolCallLoops": 0,
    "responseMaxTokens": 0,
    "compactMaxTokens": 0
  },
  "swarm": {
    "interactions": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "participants": [
      "..."
    ],
    "maxDepth": 0,
    "maxConcurrent": 0,
    "maxTotal": 0
  },
  "credentialStack": "...",
  "externalOperationsOpenApi": [
    {
      "pathBindings": [],
      "queryBindings": [],
      "name": "...",
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "externalOperationVersion": 0,
      "requestBindings": [],
      "authenticationHeader": {},
      "promptGuidance": "...",
      "isTerminal": false
    }
  ],
  "externalOperationsMcp": [
    {
      "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
    }
  ],
  "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"
    ]
  }
}

Where it’s used

• interactions.updateOneShot (PUT /interactions/one-shot/by-id/{id})