Scopes

Scope は private record がどこに属するかを表します。Sharing は追加で誰に見せるかを表します。

Create and update scope

Private packs/tracks の create/update では scope を使います。

{ "scope": { "type": "personal" } }

{ "scope": { "type": "projects", "ids": ["project-id"] } }

Update で scope を省略すると existing scope を維持します。

Search scopes

Search は複数 location を含められるため scopes を使います。

{
	"scopes": [{ "type": "personal" }, { "type": "projects", "ids": ["project-id"] }]
}

sharedWith

Main scope に加えて特定の user ID または email に見せたい場合は sharedWith を使います。

{
	"sharedWith": {
		"userIds": ["user-id"],
		"emails": ["teammate@example.com"]
	}
}

Update で sharedWith を省略すると existing value を維持します。