Manage Kestra Roles 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_role

Manages a Kestra Role.

Example usage

resource "kestra_role" "example" {
  name        = "Friendly name"
  description = "Friendly description"


  resources {
    type    = "FLOW"
    actions = ["VIEW", "LIST", "UPDATE", "EXECUTE"]
  }


  resources {
    type    = "EXECUTION"
    actions = ["VIEW", "LIST", "ACCESS_LOGS"]
  }
}

Schema

Required

  • name (String) The role name.

Optional

  • description (String) The role description.
  • is_default (Boolean) The role is the default one at user creation. Only one role can be default. Latest create/update to true will be keep as default. Defaults to false.
  • namespace (String) The linked namespace.
  • resources (Block Set) The role resource permissions. (see below for nested schema)

Read-Only

  • id (String) The ID of this resource.
  • tenant_id (String) The tenant id.

Nested Schema for resources

Required:

  • actions (List of String) The allowed actions for this resource type (e.g., VIEW, LIST, CREATE, UPDATE, DELETE).
  • type (String) The resource type (e.g., FLOW, EXECUTION, NAMESPACE).

Import

Import is supported using the following syntax:

The terraform import command can be used, for example:

terraform import kestra_role.example {{role_id}}

Was this page helpful?