raff_role

_{Updated May 10, 2026} Manages a custom IAM role. System roles (Owner, Admin, Operator, Member) are immutable and managed by the platform — they cannot be created, updated, or deleted via Terraform. The permissions attribute is a set; reordering does not produce a diff.

Example — account-scoped read-only

resource "raff_role" "auditor" {
  name        = "Auditor"
  slug        = "auditor"
  scope       = "account"
  description = "Read-only access for compliance reviews"

  permissions = [
    "account.audit.read",
    "billing.read",
    "members.read",
  ]
}

Example — project-scoped VM operator

resource "raff_role" "vm_operator" {
  name  = "VM Operator"
  slug  = "vm-operator"
  scope = "project"

  permissions = [
    "vm.read",
    "vm.power",
  ]
}

Argument reference

Required

Argument	Type	Description
`name`	string	Display name. Updates rename in place
`slug`	string	URL-safe identifier. ForceNew
`scope`	string	`account` or `project`. ForceNew
`permissions`	set(string)	Permission names. Browse via `raff permission list --scope <scope>`

Optional

Argument	Type	Description
`description`	string	Free-form description

Attribute reference (computed)

Attribute	Description
`id`	Role UUID
`is_system`	`true` for system roles, `false` for custom
`created_at` / `updated_at`	RFC3339 timestamps

Lifecycle

Operation	Behavior
`terraform apply` (create)	Creates the custom role
Change `name`, `description`, `permissions`	In-place update
Change `slug`, `scope`	Replacement — destroy + recreate
`terraform destroy`	Deletes the role. Members assigned to it must be reassigned first

Importing existing roles

terraform import raff_role.auditor <role-uuid>

Permissions

The API key managing roles needs role.create, role.manage, and role.delete at the account level. The system role Account Admin grants all of these.

Data sources

# Single role by UUID
data "raff_role" "owner" {
  id = "<role-uuid>"
}

# All roles, optionally filtered by scope
data "raff_roles" "account" {
  scope = "account"
}

raff_member

Account-scoped members get account-scoped roles.

raff_project_member

Project-scoped members get project-scoped roles.

CLI: raff permission list

Browse the permission catalog.

Getting Started

Guides

REST API

CLI

Terraform

Example — account-scoped read-only

Example — project-scoped VM operator

Argument reference

Required

Optional

Attribute reference (computed)

Lifecycle

Importing existing roles

Permissions

Data sources

raff_member

raff_project_member

CLI: raff permission list

​Example — account-scoped read-only

​Example — project-scoped VM operator

​Argument reference

​Required

​Optional

​Attribute reference (computed)

​Lifecycle

​Importing existing roles

​Permissions

​Data sources

​Related

raff_member

raff_project_member

CLI: raff permission list

Example — account-scoped read-only

Example — project-scoped VM operator

Argument reference

Required

Optional

Attribute reference (computed)

Lifecycle

Importing existing roles

Permissions

Data sources

Related