---
title: "Get all policies available to the caller's organization"
method: GET
path: "/v1/roles/policies"
tags: ["Roles"]
---

# Get all policies available to the caller's organization

`GET /v1/roles/policies`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/roles/policies`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

The built-in policies, followed by the custom policies belonging to the organization the request is scoped to. Another organization's custom policies are never returned.

## Response `200`

Responding with list of policies

- object[]
  - `id` Id (unresolved $ref)
  - `name` string
  - `scope` string: One of the built-in PolicyScopes values, or, for a custom policy, `<orgSlug>:<kebab-cased-name>` assigned at creation and never changed.
  - `description` string
  - `isCustom` boolean: Whether this policy can be edited or deleted.
  - `permissions` object[]
    - `resource` 'search' | 'sqlQueries' | 'sqlCredentials' | 'projects' | 'pipelines' | 'artifacts' | 'idsArtifacts' | 'dataRetention' | 'dataSources' | 'healthMonitoring' | 'jobsMonitoring' | 'attributeManagement' | 'myAccount' | 'administration' | 'auditTrail' | 'dataApp' | 'dataAppProvider' | 'inference' | 'aiArtifacts' | 'artifactVersionManager' | 'tenantManagement' | 'connectorLogs' | 'observability' | 'mockApi' | 'roleDirectory' | 'certificates' | 'dataPackages' | 'platformEvents' | 'integrationHealth' | 'dataAppWorkspace' | 'artifactReadme' | 'artifactFiles' | 'fileMetadata' | 'lakehouseConfig' | 'workflowRuns' | 'fileLinkIntegrations' | 'bulkActions' | 'sqlAccess' | 'microFileUpload' | 'microFileDelete' | 'microBulkActionsLabel' | 'microPipelinePages' | 'microAgentInstall' | 'microSharedSettings', required
    - `action` 'view' | 'create' | 'edit' | 'full', required

## Other responses

- `401`: Invalid token
- `403`: Caller is not authorized to perform this action

---

[API](https://skmtc.dev/tetrascience/apis/administration.md) - [All operations](https://skmtc.dev/tetrascience/apis/administration/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/administration/revisions/c1c829febcc5?raw)