---
title: "GrantPermissionBody"
description: "Request body for a Permission operation."
section: "Reference"
group: "Types"
order: 174
---

## Definition

```ts
interface GrantPermissionBody {
  entityId: string;
  tier: "viewer" | "editor" | "admin";
  subjectId?: string | null | undefined;
}
```

## Fields

| Field       | Type                              | Notes                                                                                                           |
| ----------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `entityId`  | `string`                          | `required` — Prefixed ID of the target entity.                                                                  |
| `tier`      | `"viewer" \| "editor" \| "admin"` | `required`                                                                                                      |
| `subjectId` | `string \| null \| undefined`     | `optional` — Subject. Omit (or pass null) for a `public` grant; otherwise a prefixed user/team/organization ID. |