List Resource Types

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
TypeScript
Python

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}'

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);

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

Getting Started

Users

Roles

Groups

Organizations

Me

Resource Types

Resource Users

List Resource Types

Authentication

Response

Example

Example Response

Errors

Getting Started

Users

Roles

Groups

Organizations

Me

Resource Types

Resource Users

​Authentication

​Response

​Example

​Example Response

​Errors

Authentication

Response

Example

Example Response

Errors