Documentation bug: discovering roles

[JohannesRudolph]

Description

The documentation https://registry.terraform.io/providers/stackitcloud/stackit/latest/docs/resources/authorization_organization_role_assignment suggest to discover available roles via

stackit curl https://authorization.api.stackit.cloud/v2/permissions

However that returns permissions, not roles. Similar for the other role assignment resources.

Expected behavior

Give us a command to discover roles (maybe the IAM team should just add a https://authorization.api.stackit.cloud/v2/roles endpoint but that 404s.

Environment

• Version of the STACKIT Terraform provider: v0.113.0

[JohannesRudolph]

I've done some more digging and figured out that https://docs.api.eu01.stackit.cloud/documentation/authorization/version/v2#tag/Role/operation/GetRoles is the right API to call

[Fyusel]

Hi @JohannesRudolph,
thank you for reporting this issue.

We will update the documentation to contain the correct call like you mentioned
stackit curl https://authorization.api.stackit.cloud/v2/{resourceType}/{resourceId}/roles