# Interaction

An interaction: agents working on a task together, defined once and run many times. It is one-shot (one agent answers), round-robin (agents take turns in one conversation) or managed (a manager agent hands work to others).

**Kind:** one of several shapes, used in responses.

## Shapes

The `$type` field says which shape it is, and comes first.

| `$type` | Shape |
|---|---|
| `"managed"` | [`ManagedInteraction`](https://docs.maitento.com/reference/types/managed-interaction.md) |
| `"one-shot"` | [`OneShotInteraction`](https://docs.maitento.com/reference/types/one-shot-interaction.md) |
| `"round-robin"` | [`RoundRobinInteraction`](https://docs.maitento.com/reference/types/round-robin-interaction.md) |

## Example

```json
{
  "$type": "managed",
  "versions": [
    {}
  ],
  "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.getByName`](https://docs.maitento.com/reference/api/interactions.md) (`GET /namespaces/{namespaceName}/interactions/by-name/{name}`)
- [`interactions.get`](https://docs.maitento.com/reference/api/interactions.md) (`GET /interactions/by-id/{id}`)
- [`interactions.list`](https://docs.maitento.com/reference/api/interactions.md) (`GET /interactions`)
- [`interactions.list`](https://docs.maitento.com/reference/api/interactions.md) (`GET /namespaces/{namespaceName}/interactions`)