Address GroupsПоделиться папкой (создатель/admin)

Поделиться папкой (создатель/admin)

Грант на ПАПКУ (группу адресов): субъект получает права на все адреса папки, включая добавленные позже.

Права задаются РОЛЬЮ — role: viewer|contributor (как у гранта на адрес). Legacy-флаги canView/canTransfer ещё принимаются; если пришло и то и другое, роль приоритетнее.

ИДЕМПОТЕНТЕН: повтор для той же пары (субъект, папка) меняет права, отозванный грант реактивирует — 409 GRANT_EXISTS больше не возвращается. Раньше он возвращался, и клиенту приходилось ловить его, искать грант в списке и слать PATCH — три запроса вместо одного.

canCreateAddress — отдельное право «заводить НОВЫЕ адреса в эту папку», в роль не входит и по умолчанию не выдаётся: роль описывает доступ к тому, что в папке уже есть.

curl -X POST "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/address-groups/example_string/grants" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": "cmr3f41z20001psp7phmyapw3",
  "vaultId": "example_string",
  "subjectType": "user",
  "subjectUserId": "example_string",
  "subjectGroupId": "example_string",
  "targetType": "address",
  "targetAddressId": "123 Main St",
  "targetGroupId": "example_string",
  "role": "viewer",
  "canView": true,
  "canTransfer": true,
  "canCreateAddress": true,
  "grantorId": "example_string",
  "status": "active",
  "createdAt": "2026-07-02T11:25:15.134Z",
  "updatedAt": "2026-07-02T11:25:15.134Z",
  "subject": {
    "id": "example_string",
    "name": "John Doe",
    "username": "John Doe",
    "image": "example_string",
    "color": "example_string",
    "emoji": "example_string"
  },
  "subjectGroup": {
    "id": "example_string",
    "name": "John Doe"
  }
}
POST
/api/v1/vaults/{code}/address-groups/{id}/grants
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

better-auth session token. Мобилка/сервисы. Веб использует cookie.

better-auth session token. Мобилка/сервисы. Веб использует cookie.
API Key (cookie: better-auth.session_token)
path
codestring
Required

Уникальный код Vault'а (slug)

Content-Typestring
Required

The media type of the request body

Options: application/json
No request body parameters defined
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. better-auth session token. Мобилка/сервисы. Веб использует cookie.

path
parameterstring
Required

API Key for authentication. Provide your API key in the cookie.

Path Parameters

codestring
Required

Уникальный код Vault'а (slug)

Example:
demo_vault

Body

application/json
datastring
Required

Raw application/json data

Responses