List Resource Types

Returns the resource types supported by the connected provider for resource-scoped IAM queries.

GET /unified/iam/resource_types

Returns a list of resource type identifiers that this provider supports. Use these values as the resource_type query parameter when calling List Resource Users.

This endpoint is distinct from GET /unified/list_resource_types in the Permissions Check section. That endpoint returns types supported for permission checks; this one returns types for IAM resource-scoped queries. The valid values may overlap but serve different purposes.

Authentication

Requires Authorization: Basic {base64_encoded_api_key} and x-account-id: {account_id}. See authentication.

Response

Returns a JSON object with a data: string[] field containing resource type identifiers. The exact values vary by provider. Common examples include file, folder, channel, workspace, organization, and department.

Example

cURL

curl --request GET \
  --url 'https://api.stackone.com/unified/iam/resource_types' \
  --header 'accept: application/json' \
  --header 'authorization: Basic {base64_encoded_api_key}' \
  --header 'x-account-id: {account_id}'

TypeScript

import { StackOne } from "@stackone/stackone-client-ts";

const client = new StackOne({ apiKey: "v1.eu1.xxxxx" });

const response = await client.iam.listResourceTypes({
  xAccountId: "your-account-id",
});

console.log(response.resourceTypes);

Python

from stackone_client import StackOne

client = StackOne(api_key="v1.eu1.xxxxx")

response = client.iam.list_resource_types(
    x_account_id="your-account-id"
)

print(response.resource_types)

Example Response

{
  "data": ["channel", "workspace"]
}

Errors

Status	Meaning
401	Unauthorized — invalid or missing API key
422	Provider does not support this endpoint