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

Create a vault share

cURL

curl --request POST \
  --url https://api.case.dev/vault/{id}/shares \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_org_id": "<string>",
  "permission": "read",
  "expires_at": "2023-11-07T05:31:56Z"
}
'

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