---
title: "Set the root access policy. The root access policy configures global permissions for the platform. Subjects assigned to a root policy will be granted the permissions described in the policy to all objects ion TSB."
method: PUT
path: "/v2/admin/root/policy"
tags: ["Policy"]
---

# Set the root access policy. The root access policy configures global permissions for the platform. Subjects assigned to a root policy will be granted the permissions described in the policy to all objects ion TSB.

`PUT /v2/admin/root/policy`

## Request

- Base URL: `https://docs.tetrate.io` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.tetrate.io/v2/admin/root/policy`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/docs/v2/admin/root/policy/put.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- V2AccessPolicy: A policy defines the set of subjects that can access a resource and under which conditions that access is granted.
  - `fqn` string
  - `etag` string
  - `description` string
  - `allow` V2Binding[]: The list of allowed bindings configures the different access profiles that are allowed on the resource configured by the policy.
    - `role` string, required: The role that defines the permissions that will be granted to the target resource.
    - `subjects` V2Subject[]: The set of subjects that will be allowed to access the target resource with the permissions defined by the role.
      - `user` string
      - `team` string
      - `serviceAccount` string

## Response `200`

A successful response.

- object

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api.md) - [All operations](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/revisions/2f19c3a1ae57?raw)