Manage Kestra Users with the Terraform Provider

For the complete documentation index, see llms.txt. For a full content snapshot, see llms-full.txt. Append .md to any kestra.io/docs/* URL for plain Markdown.

Terraform Resource: kestra_user

Manages a Kestra User.

Example usage

resource "kestra_user" "example" {
  email       = "john@doe.com"
  namespace   = "company.team"
  description = "Friendly description"
  first_name  = "John"
  last_name   = "Doe"
  groups      = ["4by6NvSLcPXFhCj8nwbZOM"]
}

Schema

Required

  • email (String) The user email.

Optional

  • description (String) The user description.
  • first_name (String) The user first name.
  • groups (List of String) The list of group ids the user belongs to. This list is sent to the API as a full replacement: any group membership not declared here will be removed on apply, including memberships managed outside Terraform or by other Terraform configurations. To manage individual memberships without overwriting others, use the kestra_user_group_membership resource instead, or set lifecycle { ignore_changes = [groups] } on this resource.
  • last_name (String) The user last name.
  • namespace (String) The linked namespace.

Read-Only

  • id (String) The ID of this resource.
  • username (String) The user name. Always the email.

Import

Import is supported using the following syntax:

The terraform import command can be used, for example:

terraform import kestra_user.example {{user_id}}

Was this page helpful?