List Resource Types

Returns the resource types supported by the connected provider for permission checks.

GET /unified/list_resource_types

Returns a list of resource type identifiers that the connected provider supports for Check Permissions calls. Use these values as the resource_type component when constructing resource IDs, or to understand what types of resources you can check permissions for.

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

No provider API call is made — the response is a static list declared by the connector.

Authentication

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

Response

Returns an object with a data: string[] field containing resource type identifiers. Pass the values in data as the resource_type component in a composite resource ID, or use them to understand which types can be checked.

Common values: file, folder, drive, channel, workspace, message, page.

Example

cURL

curl --request GET \
  --url 'https://api.stackone.com/unified/list_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.listResourceTypes({
  xAccountId: "your-account-id",
});

console.log(response.resourceTypes);

Python

from stackone_client import StackOne

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

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

print(response.resource_types)

Example Response

{
  "data": ["file", "folder", "drive"]
}

The exact values depend on the connected provider. See the connector’s integration guide for the full list.

Errors

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