Create a vault share

Grant another organization read-only access to this vault. Only the vault owner can create shares. Idempotent: re-sharing to the same org updates the existing share.

POST /vault/{id}/shares

Authorizations

Authorization · string · header · required

API key starting with sk_case_

Path Parameters

id · string · required

Vault ID

Body

application/json

target_org_id · string · required

The organization ID to grant access to

permission · enum<string> · default: read

Permission level (only "read" is supported currently)

Available options: read

expires_at · string<date-time> | null

Optional expiration timestamp for the share

Response

200

Share created or updated successfully