---
title: "Upsert installation vault grant"
method: PUT
path: "/connectors/v1/installations/{id}/vaults/{vaultId}"
tags: ["Connectors"]
---

# Upsert installation vault grant

`PUT /connectors/v1/installations/{id}/vaults/{vaultId}`

## Request

- Base URL: `https://api.case.dev`
- URL: `https://api.case.dev/connectors/v1/installations/{id}/vaults/{vaultId}`
- Auth: HTTP bearer

Grant (or update) an installation's access to a vault. Re-granting a revoked vault reactivates it. Import links need can_write; export links need can_read; mirror deletion and purge need can_manage.

## Path parameters

- `id` string, required
- `vaultId` string, required

## Request body

- object
  - `relationship` 'owned' | 'shared'
  - `can_read` boolean
  - `can_write` boolean
  - `can_manage` boolean
  - `source` 'provisioning' | 'lazy_reconcile' | 'explicit_share'

## Response `200`

Grant upserted

## Other responses

- `401`: Invalid API key
- `403`: Insufficient permissions
- `404`: Installation or vault not found

## Changes

- **2026-10-16** `a21d188f4b21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casemark/apis/case-dev-api/changes/connectors/v1/installations/:id/vaults/:vaultId/put.md)

---

[API](https://skmtc.dev/casemark/apis/case-dev-api.md) - [All operations](https://skmtc.dev/casemark/apis/case-dev-api/llms.txt) - [OpenAPI document](https://skmtc.dev/casemark/apis/case-dev-api/revisions/9a3245c00044?raw)