# RoundRobinInteraction

A round-robin interaction: agents, and optionally a person, take turns in one shared conversation.

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

## Fields

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

| Field | Type | Description |
|---|---|---|
| `versions` | [`RoundRobinInteractionVersion`](https://docs.maitento.com/reference/types/round-robin-interaction-version.md)`[]` | Every version of the interaction. New runs use the highest-numbered version that is not disabled. |
| `name` | `string` | The interaction's name, unique within its namespace. |
| `userCreatedById` | `uuid` | The id of the user who created it. A call made with an API key is recorded as the key's user. |
| `namespaceId` | `uuid` | The id of the namespace it belongs to. |
| `tenantId` | `uuid` | The id of the tenant it belongs to. |
| `id` | `uuid` | The unique id. Use it in `by-id` routes and wherever another object refers to this one. |
| `dateCreated` | `datetime` | When it was created, in UTC. |
| `dateUpdated` | `datetime` | When it was last changed, in UTC. |

## Example

```json
{
  "versions": [
    {
      "agents": [],
      "isNoActionAllowed": false,
      "isVotingAllowed": false,
      "isDirectQuestioningAllowed": false,
      "isSolutionProposalAllowed": false,
      "humanSettings": {},
      "maximumNoActionLoops": 0,
      "externalOperationsMcp": [],
      "externalOperationsOpenApi": [],
      "inputsConnectorAuthenticationSecret": [],
      "inputsConnectorBinding": [],
      "inputsPrompt": [],
      "prompt": "...",
      "solutionSchema": "...",
      "systemPromptMode": "AppendToDefault",
      "systemPrompts": [],
      "durationWarningToAi": "00:05:00",
      "durationAutoTermination": "00:05:00",
      "contextSettings": {},
      "loom": {},
      "swarm": {},
      "credentialStack": "...",
      "version": 0,
      "date": "2026-10-26T12:00:00.0000000Z",
      "isDisabled": false
    }
  ],
  "name": "...",
  "userCreatedById": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "namespaceId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "dateCreated": "2026-10-26T12:00:00.0000000Z",
  "dateUpdated": "2026-10-26T12:00:00.0000000Z"
}
```

## Where it's used

- [`interactions.createRoundRobin`](https://docs.maitento.com/reference/api/interactions.md) (`POST /namespaces/{namespaceName}/interactions/round-robin`)
- [`interactions.updateRoundRobin`](https://docs.maitento.com/reference/api/interactions.md) (`PUT /interactions/round-robin/by-id/{id}`)
- Inside [`BuildEntityOfRoundRobinInteraction`](https://docs.maitento.com/reference/types/build-entity-of-round-robin-interaction.md)
- Inside [`Interaction`](https://docs.maitento.com/reference/types/interaction.md)