# TeleportBotV1

This guide is a comprehensive reference to the fields in the `TeleportBotV1` resource, which you can apply after installing the Teleport Kubernetes operator.

## resources.teleport.dev/v1

**apiVersion:** resources.teleport.dev/v1

| Field      | Type            | Description                                                                                                                                                                                                                                                                                          |
| ---------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| apiVersion | string          | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: <https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources>  |
| kind       | string          | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: <https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds> |
| metadata   | object          |                                                                                                                                                                                                                                                                                                      |
| spec       | [object](#spec) | Bot resource definition v1 from Teleport                                                                                                                                                                                                                                                             |

### spec

| Field             | Type                           | Description                                                                                                                                                                                                                             |
| ----------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| max\_session\_ttl | string                         | The max session TTL value for the bot's internal role. Unless specified, bots may not request a value beyond the default maximum TTL of 12 hours. This value may not be larger than 7 days (168 hours). Cannot be set for a scoped Bot. |
| roles             | \[]string                      | The roles that the bot should be able to impersonate. Cannot be set for a scoped Bot.                                                                                                                                                   |
| traits            | \[][object](#spectraits-items) | The traits that will be associated with the bot for the purposes of role templating. Where multiple specified with the same name, these will be merged by the server. Cannot be set for a scoped Bot.                                   |

### spec.traits items

| Field  | Type      | Description                                                                           |
| ------ | --------- | ------------------------------------------------------------------------------------- |
| name   | string    | The name of the trait. This is what allows the trait to be queried in role templates. |
| values | \[]string | The values associated with the named trait.                                           |