アクセスと権限

User と workspace はいずれも Account で、Playbook を所有できます。private 共有には User ID と Project ID の principal を使います。public も Playbook では有効な principal ですが、Case は public access をサポートしません。

Playbook と Case の ACL は独立しています。public、share、project-readable な Playbook から Case を開始しても、その visibility は Case にコピーされません。Case input、outcome、Record は再利用可能な指針より sensitive になり得るため、Case ACL を明示的に選んでください。

authorization は現在の ACL で評価されます。Record read は常に filter と live Case ACL の積を取り、acl filter は authorized result を絞り込むだけで access を付与しません。Suggestion access も作成時 snapshot だけに頼らず、現在の target Playbook を再確認します。

ownership は Playbook 管理権限を与えます。readable な User は Suggestion を作成でき、author は open な提案を編集し、Playbook owner が resolve します。alias は名前、share token は token-based read、star は個人保存を提供しますが、ownership は変わりません。

mutation には idempotency UUID を使います。不確実な response の後に同一 request を再試行する場合だけ再利用してください。Case と Task の mutation はさらに lock version を要求し、同時作業者による暗黙の上書きを防ぎます。