Terraform folder deletion fails with projects scheduled for deletion inside

[lupa95]

Description

We are using Terraform to manage projects and folders in our Stackit organization.

A pretty frequent use case for us is to delete a project and the folder it was located in. Destroying a project does not delete it right away but schedules it for deletion after some days in Stackit (which is good). However, this causes an issue, that prevents the deletion of it's parent folder.

My best idea would be to implement some logic that upon trying to delete a folder, all projects inside are checked if they are scheduled for deletion. If true, the folder is also scheduled for deletion.

If there is a way to work around it in Terraform, please let me know.

Steps to reproduce

resource "stackit_resourcemanager_folder" "customer" {
  name                = "test-folder"
  owner_email         = var.stackit_owner_email
  parent_container_id = var.stackit_org_id
}

resource "stackit_resourcemanager_project" "project" {
  name                = "test-project"
  owner_email         = var.stackit_owner_email
  parent_container_id = stackit_resourcemanager_folder.customer.id
}

1. Run terraform apply
2. Run terraform destroy

Actual behavior

Error occurs:

╷
│ Error: Error deleting folder. Deletion may fail because associated projects remain hidden for up to 7 days after user deletion due to technical requirements.
│ 
│ Calling API: 409 Conflict, status code 409, Body:
│ {"timeStamp":"2025-11-27T09:45:31.636920471Z","path":"/resource-management/v2/folders/test-dir-xxx","status":409,"error":"Conflict","message":"Folder
│ has children. Deletion not permitted for id: [test-dir-xxx]"}
│ 
╵

Expected behavior

Project and folder are properly removed from Terraform state and scheduled for deletion.

Environment

• OS:
• Terraform version (see terraform --version): v1.13.4
• Version of the STACKIT Terraform provider: v0.68.0

Additional information

Feel free to add any additional information here.

[marceljk]

Hey @lupa95,

thanks for reporting this issue. This is a limitation by the api. I'll forward your request to the resource manager team, so they can have a look, if it's possible, to add a schedule for deletion.

Best regards
Marcel from the STACKIT Developer Tools Team